Conditions préalables
  • En tant que nouveau client ou client existant et si vous n'avez pas utilisé le nouveau processus WhatsApp Self-service Onboarding, créez un nouveau WhatsApp Business Account (WABA) à l'aide du Embedded Signup Flow.
    • Enregistrez au moins un nouveau numéro de téléphone dans le cadre de ce WABA et créez une intégration WhatsApp dans votre organisation Genesys Cloud. Le nouveau numéro de téléphone peut être un numéro de test ou d'intégration, que vous pourrez supprimer plus tard, une fois que vous aurez migré les autres numéros vers ce WABA. Si vous n'enregistrez pas au moins un nouveau numéro par le biais de l'inscription intégrée, vous ne pouvez pas rattacher la ligne de crédit ou le mode de paiement de Genesys au WABA. Sans méthode de paiement valide, WhatsApp ne peut pas migrer les numéros de téléphone vers un WABA. Vous devez donc enregistrer au moins un nouveau numéro.
  • Créez une Meta App dans le Meta Business Manager et ajoutez-y le produit WhatsApp. Vous devez configurer cette application pour exécuter une demande d'API graphique avec les autorisations de WhatsApp afin de lancer le processus de migration des numéros de téléphone. Vous ne devez pas utiliser l'application à d'autres fins que la création d'un jeton d'accès ou d'utilisateur, l'exercice des autorisations et le démarrage de la migration. Vous pouvez supprimer l'application ultérieurement à partir du Business Manager une fois que vous avez migré tous les numéros. 
  • Lancez la migration à l'aide de l'API graphique. Genesys ne peut pas effectuer la migration en votre nom car les WABA créés par Embedded Signup sont la propriété de l'entreprise et non de Genesys.

Pour créer une application Meta avec le produit WhatsApp, procédez comme suit :

  1. Dans la page Meta Business Settings, procédez comme suit :
    1. Comptes section cliquez sur Apps.
    2. Cliquez sur Add et sélectionnez Create a new app ID.
    3. Dans la page Créer une application, sélectionnez Autre.
    4. Dans la page Sélectionnez un type d'application, sélectionnez Business.
    5. Cliquez sur Suivant.
    6. Dans le champ Add an app name, saisissez le nom de l'application.
    7. (Facultatif) Dans le champ Business Account, sélectionnez Genesys Cloud Services, Inc.
    8. Cliquez sur Créer une application. Le tableau de bord de l'application Meta s'affiche.
    9. Dans la page Ajouter des produits à votre application, dans la tuile WhatsApp , cliquez sur Configurer.
    10. Dans la page Quickstart, dans le volet de gauche, sous App Review, cliquez sur Permissions and Features.
    11. Dans la page Permissions et fonctionnalités, dans le champ Search, tapez business_management.
    12. Dans la section Permissions et fonctionnalités, affichez les options WhatsApp_business_management et business_management avec le niveau d'accès standard.
  2. Naviguez jusqu'à l'onglet Meta et cliquez sur Refresh.
  3. Affichez l'application Genesys Cloud App que vous avez créée dans la page des paramètres de l'entreprise.

Une fois l'application créée, configurez une URL de rappel de webhook de test pour votre produit WhatsApp dans l'application. Pour configurer l'URL de rappel du Webhook de WhatsApp pour votre application Meta, procédez comme suit :

  1. Dans l'outil de recherche d'URL unique , créez l'URL unique. 
  2. Copiez-collez l'URL unique dans un autre onglet du navigateur, puis revenez à l'URL de votre site Webhook.
  3. Dans l'URL du site Webhook, procédez comme suit :
    1. En haut de la page, cliquez sur Editer.
    2. Dans la boîte de dialogue Edit URL, dans le champ Response body, tapez $request.query.hub_challenge$ comme variable.
    3. Cliquez sur sauvegarder. 
  4. Dans l'application Meta, procédez comme suit :
    1. Dans le panneau de gauche, naviguez vers WhatsApp > Configuration, cliquez sur Edit.
    2. Dans la boîte de dialogue Edit Webhook's callback URL, dans le champ Callback URL, collez l'URL unique. 
    3. Dans le champ Verify token, entrez les détails du jeton (qui peut inclure n'importe quelle chaîne de texte).
    4. Cliquez sur Verify and save pour enregistrer votre configuration.
  5. À côté du champ Webhook, procédez comme suit :
    1. Sous le champ Edit, cliquez sur Manage.
    2. Dans la boîte de dialogue Webhook fields, dans la colonne Subscribe, cochez toutes les cases de la colonne Subscribe.
    3. Cliquez sur Terminé.

Remarque :  Vous n'avez besoin de l'installation du webhook que si vous migrez vos numéros d'un autre BSP qui est sur la plateforme WhatsApp Cloud. Si vous migrez des numéros d'une plateforme WhatsApp sur site ou d'un WABA existant appartenant à Genesys vers votre nouveau WABA intégré, procédez directement pour initier la migration des téléphones.

Restez connecté à votre Meta Business Account et naviguez vers Meta's Graph API Explorer. Dans la partie droite de la page API Explorer, assurez-vous que les paramètres d'authentification sont correctement définis avant d'effectuer des requêtes POST à l'aide des API.
Pour lancer une migration de téléphone, procédez comme suit :
  1. Dans la boîte de dialogue Access Token, dans le champ Meta App, sélectionnez le nom de la Meta App que vous avez créée précédemment.
  2. Dans le champ User or Page, sélectionnez User Token.
  3. Dans le champ Add a Permission, incluez whatsapp_business_management et business_management permissions dans la liste des permissions. Si ce n'est pas le cas, cliquez sur la liste déroulante et sélectionnez-les. Vous pouvez trouver l'option  whatsapp_business_management dans la catégorie Other permissions et business_management dans la catégorie Events Groups Pages permissions.
  4. Cliquez sur le bouton Generate Access Token . Si le système le demande, sélectionner tous les WABA. En général, pour une migration, il suffit de sélectionner le WABA dont le numéro est migré. Le jeton d'accès expire après une période d'inactivité. En cas d'expiration, rafraîchissez la page ou générez à nouveau le jeton.
  5. Cliquez sur Soumettre.

Pour confirmer que vous avez initié la migration, accédez à votre WhatsApp Manager et sous Outils du compte > Numéros de téléphone, affichez votre numéro ajouté au WABA en statut en attente ou hors ligne.

Remarque :  Lorsque vous lancez la migration, le numéro est seulement ajouté au nouveau WABA. Cependant, le trafic passe par votre intégration WhatsApp existante associée à l'ancien WABA jusqu'à ce que vous ayez terminé la migration.

Utilisez le flux d'inscription intégré à WhatsApp dans Genesys Cloud et procédez à la vérification et à l'enregistrement de votre téléphone WhatsApp. Si l'authentification à deux facteurs n'est pas désactivée pour le numéro, le téléphone sera vérifié, mais vous ne pourrez pas créer l'intégration WhatsApp. La désactivation du 2FA est une exigence difficile à satisfaire. Veuillez contacter GenesysCloudWhatsAppRequests@genesys.com pour faire désactiver la vérification en deux étapes de votre numéro dans l'ancienne WABA gérée par Genesys. Si vous migrez le numéro d'un autre BSP et qu'il gère votre WABA, vous devrez lui demander de le désactiver pour vous.

Vous pouvez activer votre numéro de téléphone si votre demande d'API a abouti et que vous avez pu initier la migration du numéro. Si la demande d'API renvoie une erreur indiquant qu'au moins une de vos applications Meta doit être abonnée aux webhooks pour le WABA de destination, créez un nouvel abonnement au webhook pour le WABA de destination, en effectuant un appel POST au point de terminaison /WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps. 

Vous pouvez vérifier que l'abonnement a réussi en lançant un appel GET au point de terminaison /WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps.

Note: Pour éviter tout risque d'indisponibilité de votre canal WhatsApp, pour les numéros de production, activez le numéro de téléphone pendant une fenêtre de maintenance planifiée, lorsque votre centre de contact est fermé. Votre trafic WhatsApp n'est pas affecté et ne basculera pas tant que l'ancienne intégration n'aura pas été supprimée et qu'une nouvelle intégration n'aura pas été créée et activée dans GC.

Pour activer le numéro de téléphone à l'aide du flux d'inscription intégré, procédez comme suit :

  1. Supprimez votre intégration WhatsApp actuelle dans Genesys Cloud associée au numéro de téléphone de l'ancien WABA. Il se peut que vous deviez d'abord supprimer la route des messages associée à l'intégration, avant de supprimer l'intégration elle-même.
  2. Configurez une nouvelle intégration WhatsApp pour le numéro que vous avez initié dans le cadre de la nouvelle WABA. Pour plus d'informations sur la configuration d'une nouvelle intégration de WhatsApp, voir Travailler avec un flux d'inscription intégré. 
  3. Une fois la procédure terminée, procédez comme suit : 
    1. Sélectionnez votre Meta Business Account.
    2. Sélectionnez le compte professionnel WhatsApp où le numéro a été ajouté après avoir initié la migration.
    3. Sélectionnez le numéro de téléphone/profil commercial migré.
    4. Vérifier/enregistrer le numéro et sauvegarder l'intégration.

La migration automatique de tous vos modèles de messages WhatsApp approuvés de votre ancien WABA vers le nouveau WABA peut prendre quelques minutes. Une fois cela fait, un nouveau modèle de message Namespace est attribué par WhatsApp. Pour reconfigurer les réponses permanentes, procédez comme suit :

  1. Connectez-vous à votre Meta Business Manager.
  2. Sélectionnez votre entreprise.
  3. Naviguez vers WhatsApp Manager > Outils de compte > Modèles de messages
  4. Reconfigurez les modèles de messages/réponses planifiées dans votre Genesys Cloud Org en raison du nouvel espace de noms attribué par WhatsApp. Pour plus d'informations sur l'ajout et l'utilisation d'un modèle de message WhatsApp, voir Ajouter un modèle de message WhatsApp et Utiliser un modèle de message WhatsApp. 

    Si vous avez créé un nouvel abonnement au webhook pour le WABA de destination et que vous souhaitez supprimer la demande, procédez comme suit :

    1. Dans la section Graph API Explorer, Access Token, supprimez-le en effectuant un DELETE appel au /WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps endpoint.
    2. Saisissez l'identifiant du compte WhatsApp Business.
    3. Cliquez sur Soumettre.