Migration de numéros de téléphone d’un compte WhatsApp Business vers un autre via l’inscription intégrée
Ce document décrit comment utiliser l’inscription intégrée pour migrer des numéros de téléphone professionnels d’un compte WhatsApp Business (WABA) vers un autre.
Les client·es peuvent migrer leurs numéros de téléphone professionnels d’un compte WhatsApp Business (WABA) vers un autre tout en conservant leur nom à l’écran, leur indice de qualité, leurs limites de messages avec modèle, le statut de leur compte business officiel et leurs modèles de qualité élevée précédemment approuvés. Généralement, une migration n’est effectuée que lorsqu’un ou une client·e souhaite déplacer son numéro de téléphone professionnel d’un partenaire de solution vers un autre.
Pour réaliser une migration pour un ou une client·e, vous disposez de deux options : via l’inscription intégrée ou par programme.
La migration via l’inscription intégrée constitue la méthode la plus simple et la solution privilégiée, car elle peut être initiée par votre clientèle, elle génère et octroie automatiquement la propriété de tous les éléments nécessaires, elle accorde à votre application l’accès à ces éléments et elle nécessite moins d’appels d’API.
La migration par programme doit être initiée par vos soins et implique un plus grand nombre d’appels d’API, car vous devez vérifier que les éléments dépendants sont correctement configurés, générer vous-même tous les nouveaux éléments requis, et les associer à d’autres éléments. Par conséquent, la migration par programme n’est recommandée que si vous prévoyez de travailler avec le ou la client·e en opérant en son nom (autrement dit, vous créerez et posséderez le compte WhatsApp Business cible et ses éléments et vous les partagerez avec le ou la client·e).
Si vous souhaitez migrer les numéros de téléphone de vos client·es par programme, consultez notre document Migration de numéros d’un compte WhatsApp Business vers un autre par programme.
Fonctionnement
Les client·es peuvent démarrer le processus de migration en utilisant votre implémentation de l’inscription intégrée (version 2). L’inscription intégrée demandera aux client·es leur numéro de téléphone professionnel ainsi qu’un nouveau compte WhatsApp Business (WABA) cible.
Lorsque le ou la client·e exécute le flux, l’inscription intégrée génère son nouveau compte WhatsApp Business, l’associe à son portefeuille business Meta, octroie à votre application l’accès au compte WhatsApp Business, puis renvoie l’ID du compte WhatsApp Business nouvellement créé et l’ID du numéro de téléphone professionnel.
Vous devez capturer ces ID et les utiliser avec l’API pour partager votre ligne de crédit, vous abonner aux webhooks et inscrire le numéro en vue de son utilisation avec l’API Cloud. Une fois la dernière étape effectuée (inscription), le numéro de téléphone professionnel est réassocié au compte WhatsApp Business cible, et le numéro peut alors être réutilisé pour envoyer et recevoir des messages.
Étant donné que le numéro de téléphone professionnel du client ou de la cliente ne change pas, son nom à l’écran, son indice de qualité, sa limite de messages et le statut de son compte business officiel sont tous conservés.
En outre, tous les modèles éligibles sont automatiquement dupliqués dans le compte WhatsApp Business cible et reçoivent les mêmes statuts que leurs homologues sources, et tous les contenus multimédias importés sur le numéro de téléphone professionnel du client ou de la cliente peuvent continuer à être utilisés.
Comptes WhatsApp Business
L’inscription intégrée génère automatiquement le nouveau compte WhatsApp Business du client ou de la cliente, l’associe à son compte business Meta et accorde à votre application l’accès au compte WhatsApp Business.
Modèles
Templates are automatically duplicated in the destination WABA and granted the same quality ratings and statuses as their source counterparts. The duplicated templates will be subjected to Template Categorization Guidelines checks to ensure that the templates are correctly categorized. This may result in some of the duplicated templates being REJECTED.
Only templates with both a status of APPROVED and quality_score of GREEN are eligible for duplication. If the destination WABA cannot accommodate all of the new templates, we will duplicate as many as we can until the destination WABA'S template limit has been reached. Unduplicated templates must be re-created and submitted for approval if they are to be used by the destination WABA.
Please note that the quality ratings of templates will NOT be migrated. All migrated templates will start with an UNKNOWN rating. This rating will remain for the first 24 hours, after which a new rating will be generated if sufficient data is available.
Facturation
Messages sent before migration is complete are charged to the old Solution Partner. Undelivered messages sent before migration is complete will be charged to the old Solution Partner if they are delivered after migration is complete.
Messages sent after migration is complete are charged to the new Solution Partner.
Temps d’inactivité des modèles
L’enregistrement du numéro de téléphone professionnel s’effectue instantanément, vous permettant ainsi de continuer à échanger des messages sans interruption.
En revanche, la duplication des modèles nécessite un certain temps. Par conséquent, les modèles concernés resteront inutilisables jusqu’à la fin de leur migration.
Pour éviter ce temps d’inactivité, vous avez la possibilité d’initier la migration des modèles avant de procéder à l’enregistrement du numéro de téléphone.
Plafonds
La duplication des modèles automatiquement déclenchée dans le cadre du processus de migration n’est pas prise en compte dans votre plafond. En revanche, les appels d’API que vous effectuez comptent dans cette limite.
Limites
- Les numéros de téléphone professionnels générés par WhatsApp à des fins de test ne peuvent pas être migrés.
- Les numéros de téléphone professionnels migrés ne peuvent être inscrits qu’à des fins d’utilisation avec l’API Cloud.
- L’historique des messages et les contenus multimédias importés ne seront pas migrés si le compte WhatsApp Business source se trouve sur l’API On-Premises.
- Les numéros de téléphone professionnels doivent être associés à un nom à l’écran approuvé (
name_statusestAPPROVED). - Les numéros de téléphone professionnels ne doivent pas être associés à des demandes de modification de nom à l’écran en attente.
- Les évaluations de la qualité des modèles NE FERONT PAS l’objet d’une migration. Tous les modèles migrés débutent avec une évaluation
UNKNOWN. Cette évaluation demeure pendant les premières 24 heures, puis une nouvelle évaluation est générée si les données disponibles sont suffisantes.
Conditions requises
Clientèle
Demandez au client ou à la cliente qui possède le numéro de téléphone professionnel de confirmer qu’il ou elle remplit les conditions ci-dessous. Pour ce faire, les client·es qui possèdent leur propre compte WhatsApp Business peuvent utiliser l’outil Meta Business Manager en accédant à Comptes WhatsApp > (nom de leur compte WhatsApp Business) > Paramètres. Les client·es qui ne possèdent pas de compte WhatsApp Business doivent demander à leur fournisseur de solutions pour les entreprises (BSP) de confirmer ce point.
- Leur compte business Meta doit présenter le statut vérifié.
- Leur compte WhatsApp Business existant doit présenter le statut approuvé.
- Leur compte WhatsApp Business existant doit être associé à un moyen de paiement valide (dans Paramètres de paiement).
- La vérification en deux étapes doit être désactivée pour leur numéro de téléphone professionnel. Les client·es qui possèdent leur propre compte WhatsApp Business peuvent utiliser le Gestionnaire WhatsApp pour désactiver la vérification en deux étapes sur leur numéro ; sinon, ils doivent demander à leur fournisseur de solutions de le faire à leur place.
Fournisseurs de solutions
Au moins une application doit déjà être abonnée aux webhooks sur le compte WhatsApp Business cible (consultez la page Webhooks), et vous devez utiliser l’inscription intégrée version 2 avec la journalisation de session activée.
Étapes de migration
Étape 1 : demander au client ou à la cliente de désactiver la vérification en deux étapes
Si vous ne l’avez pas encore fait, demandez à votre client·e d’utiliser le Gestionnaire WhatsApp pour désactiver la vérification en deux étapes sur son numéro de téléphone professionnel (ou de demander à son fournisseur de solutions actuel de le faire en son nom).
Vous ne pourrez pas exécuter le reste de la procédure tant que la vérification en deux étapes n’aura pas été désactivée.
Étape 2 : accéder à l’inscription intégrée
Demandez au client ou à la cliente d’accéder à votre implémentation de l’inscription intégrée (version 2) et d’indiquer son numéro de téléphone professionnel et le nom à l’écran de ce dernier lorsque le flux l’invite à fournir ces informations.
Étape 3 : capturer les ID d’élément
Lorsque le ou la client·e exécute le flux, capturez l’ID de son numéro de téléphone professionnel et le nouveau compte WhatsApp Business renvoyés dans l’évènement du message.
Étape 4 : partager votre ligne de crédit
Partagez votre ligne de crédit avec le compte WhatsApp Business comme vous le feriez normalement après l’intégration d’un ou d’une client·e via l’inscription intégrée.
Étape 5 : s’abonner aux webhooks
Abonnez votre application aux webhooks sur le nouveau compte WhatsApp Business du client ou de la cliente.
Étape 6 : inscrire le numéro de téléphone pour l’API Cloud
Inscrivez le numéro de téléphone professionnel en vue de son utilisation avec l’API Cloud (vous ne pouvez pas inscrire un numéro de téléphone professionnel migré pour une utilisation avec l’API On-Premises).
Dépannage
En cas d’échec du processus de migration de modèles, consultez la documentation suivante pour savoir comment déclencher manuellement une migration de modèles : Migration de modèles.