Migration de l'API WhatsApp

Ce guide explique comment relier à Quoting24 un numéro déjà actif sur les API officielles de WhatsApp (WhatsApp Business Platform) chez un autre fournisseur, sans changer le numéro.

La section WhatsApp est visible uniquement par les administrateurs.

La connexion part toujours du même endroit dans Quoting24 : Paramètres → WhatsApp → WhatsApp Business → Connecter. Le bouton Connecter ouvre l'inscription intégrée de Meta (Embedded Signup). Ensuite, Quoting24 devient le fournisseur qui reçoit et envoie les messages de ce numéro. Le mode prévu est la connexion aux API officielles, décrite dans Vue d'ensemble WhatsApp.

Quelle procédure suivre

Meta propose deux façons de connecter un numéro déjà utilisé par un autre fournisseur. Avant de cliquer sur Connecter, vérifiez le portfolio dans Meta Business Suite → Paramètres → Comptes.

Ce que vous voyez dans Meta Business Suite	Que faire
Comptes WhatsApp et Comptes de messagerie (Messaging Accounts) séparés	Modèle actuel : partagez le compte WhatsApp avec Quoting24. Le numéro reste où il est.
Comptes WhatsApp seulement	Modèle précédent : migrez le numéro avec un code SMS ou vocal.

Sur le modèle actuel, Meta refuse le déplacement du numéro d'un compte à un autre. Le déconnecter de l'ancien fournisseur ne le libère pas.

À préparer

Un accès administrateur à Quoting24.
Un accès administrateur au portfolio Meta (Business Manager) qui possède le numéro, avec l'utilisateur Facebook que vous utiliserez dans la fenêtre Connecter.
Le numéro déjà enregistré sur les API officielles. Les numéros d'essai gratuits attribués par Meta ne peuvent pas être migrés.
La possibilité de recevoir un SMS ou un appel vocal sur ce numéro, si Meta demande un code.

La migration du modèle précédent exige aussi :

un nom d'affichage déjà approuvé, sans demande de changement de nom encore ouverte ;
la validation en deux étapes (PIN) désactivée sur le numéro, sans supprimer le numéro ni fermer le compte. Si vous n'avez pas accès au compte WhatsApp, demandez la désactivation au fournisseur actuel.

Modèle actuel : partager le numéro avec Quoting24

Suivez cette procédure si Meta Business Suite affiche à la fois Comptes WhatsApp et Comptes de messagerie.

Laissez le numéro actif chez le fournisseur actuel jusqu'à la fin. Le retirer plus tôt, alors que des messages clients arrivent, interrompt la réception.

Dans Quoting24, ouvrez Paramètres → WhatsApp.
Sur la ligne WhatsApp Business, cliquez sur Connecter et connectez-vous avec l'administrateur du portfolio Meta.
Sélectionnez le numéro déjà enregistré chez l'autre fournisseur. Meta l'affiche dans la liste et ne demande pas un nouveau code : le numéro est déjà enregistré.
Meta propose le portfolio et le compte WhatsApp de ce numéro. Confirmez le partage avec Quoting24.
Saisissez le nom d'affichage du numéro et continuez. Meta peut le réexaminer après l'activation.
Vérifiez les autorisations demandées (compte WhatsApp, compte de messagerie et ressources liées) et confirmez.
Fermez la fenêtre Meta. Dans Quoting24, la ligne WhatsApp Business est connectée.

Meta crée un nouveau compte de messagerie pour Quoting24, sous le même compte WhatsApp. L'ancien fournisseur reste connecté tant que vous ne le retirez pas.

Faire arriver les messages dans Quoting24

Le partage seul ne déplace pas les messages entrants. Tant que l'ancien fournisseur reste partenaire, Meta peut continuer à les lui remettre.

Lorsque la ligne WhatsApp Business est connectée dans Quoting24 :

Dans Meta Business Suite, ouvrez Paramètres → Comptes → Comptes de messagerie, sélectionnez le compte, allez dans Partenaires et retirez l'accès de l'application de l'ancien fournisseur.
Ouvrez Paramètres → Comptes → Comptes WhatsApp, sélectionnez le compte du numéro, allez dans Partenaires et retirez aussi l'accès du même fournisseur.
Dans le même compte WhatsApp, ouvrez Routage des conversations (Conversation routing) et attribuez chaque type de conversation à Quoting24.

La liste des partenaires peut afficher le nom de l'application Meta liée à Quoting24, et non le texte « Quoting24 ». Si l'accès à retirer n'est pas clair, arrêtez-vous et demandez au support Quoting24 avant de retirer un partenaire.

Lorsqu'il ne reste qu'un partenaire, Meta désactive le routage et remet les messages à ce partenaire.

Ce qui reste sur ce modèle

Ces éléments restent sur le numéro, parce que le compte WhatsApp ne change pas :

numéro de téléphone
nom d'affichage
évaluation de la qualité
limites de messagerie
statut Official Business Account, s'il était déjà actif

Les modèles appartiennent au compte de messagerie, pas au numéro. Le compte créé pour Quoting24 démarre vide : les modèles de l'ancien fournisseur doivent être recréés dans Quoting24 et approuvés de nouveau par Meta.

Tant qu'ils ne sont pas approuvés :

depuis Quoting24, vous ne répondez librement que dans les 24 heures qui suivent le dernier message du client ;
Broadcast API n'a pas de modèles à sélectionner.

Les conversations enregistrées dans l'ancien logiciel ne deviennent pas des tickets Quoting24. Les messages qui arrivent après la connexion deviennent des tickets. Les conversations déjà présentes sur le téléphone du client restent dans l'application WhatsApp du client.

Modèle précédent : migrer le numéro

Suivez cette procédure seulement si Meta Business Suite n'affiche que Comptes WhatsApp.

Désactivez la validation en deux étapes

Demandez au fournisseur actuel de désactiver le PIN du numéro, ou faites-le vous-même depuis le portfolio Meta si vous y avez accès.

Le numéro et le compte doivent rester actifs. Seule la validation en deux étapes est retirée.

Connectez le numéro depuis Quoting24

Dans Quoting24, ouvrez Paramètres → WhatsApp.
Sur la ligne WhatsApp Business, cliquez sur Connecter et connectez-vous en tant qu'administrateur du portfolio Meta.
Choisissez créer un nouveau compte WhatsApp. C'est l'étape par laquelle Meta déplace le numéro déjà existant : ce n'est pas un second numéro.
Saisissez le même nom d'affichage déjà approuvé pour ce numéro.
Saisissez le même numéro. Meta signale qu'il est déjà enregistré sur un compte WhatsApp Business ou chez un autre fournisseur.
Demandez le code par SMS ou appel vocal et saisissez-le.
Terminez les étapes restantes dans la fenêtre Meta.

Le déplacement se termine en général en quelques minutes. Dans Quoting24, la ligne WhatsApp Business passe à connectée. Pendant le passage, la réception peut s'interrompre quelques minutes.

Ce qui reste et ce qu'il faut refaire

Restent sur le numéro :

nom d'affichage
évaluation de la qualité
statut Official Business Account
limites de messagerie

À refaire dans Quoting24 :

les modèles, à renvoyer et à faire réapprouver par Meta avant d'écrire hors de la fenêtre de 24 heures et avant d'utiliser Broadcast API ;
les campagnes de l'ancien fournisseur ;
l'historique de conversation de ce logiciel, qui n'est pas importé. Les nouveaux messages arrivent comme tickets.

Numéro déjà en coexistence chez un autre fournisseur

Si le même numéro est utilisé en même temps par l'application WhatsApp Business et par les API chez un autre fournisseur, la connexion API ne rattache pas seule l'application sur le téléphone.

Faites une sauvegarde des conversations dans l'application WhatsApp Business.
Enregistrez le même numéro sur l'application WhatsApp personnel : le numéro quitte l'application Business.
Enregistrez-le de nouveau sur l'application WhatsApp Business.
Dans Quoting24, cliquez sur Connecter dans WhatsApp Business et terminez la coexistence décrite dans WhatsApp Coexistence : dans l'application, Paramètres → Appareils connectés → Connecter un appareil, puis scannez le QR affiché par Quoting24.

Pour passer le numéro uniquement sur les API, sans application sur le téléphone, suivez la procédure du modèle Meta vérifié plus haut.

Après la connexion

Les nouveaux messages du numéro deviennent des tickets dans Quoting24.
Au-delà de 24 heures après le dernier message du client, on écrit avec un modèle approuvé. Les règles du canal officiel sont dans Vue d'ensemble WhatsApp.
Les campagnes se créent dans Broadcast API lorsque les modèles sont disponibles dans Quoting24.
Pour utiliser aussi l'application WhatsApp Business sur le même numéro, il faut WhatsApp Coexistence.
Les groupes et les listes de diffusion de l'application ne passent pas sur les API.

Si la procédure s'arrête

Meta refuse le déplacement du numéro. Le portfolio est sur le modèle actuel : revenez au partage et laissez le numéro enregistré chez l'ancien fournisseur jusqu'à ce que Quoting24 affiche connecté.
Le code SMS ou vocal n'arrive pas. Sur le modèle précédent, la validation en deux étapes est encore active. Désactivez-la et recommencez Connecter.
Le nom d'affichage bloque la migration précédente. Meta n'accepte le passage qu'avec un nom approuvé et sans changement de nom en attente.
Quoting24 est connecté mais les messages n'arrivent pas. Sur le modèle actuel, le routage pointe encore vers l'ancien fournisseur. Vérifiez Partenaires et Routage des conversations avant de déconnecter le numéro.
Si le partenaire à retirer n'est pas reconnaissable, contactez le support Quoting24 avec le numéro et l'ID du portfolio Meta.