Ce guide vous aide à migrer une boîte de réception WhatsApp Cloud existante vers une configuration manuelle dans Chatwoot. La migration garde votre boîte de réception intacte. Les conversations, contacts, collaborateurs, règles de routage, horaires d’ouverture, paramètres CSAT, paramètres des bots et autres paramètres de la boîte de réception sont conservés.
Les numéros WhatsApp avec support de coexistence sont actuellement en cours d’examen. Si votre numéro WhatsApp est également utilisé dans l’application WhatsApp Business, contactez le Support Chatwoot avant de commencer cette migration.
Avant de commencer la migration, collectez les informations requises pour l’API WhatsApp Cloud auprès de Meta : ID WABA, ID du numéro de téléphone et un jeton d’accès permanent d’utilisateur système. Utilisez les étapes ci-dessous pour créer ou sélectionner une application Meta, ajouter ou sélectionner le numéro WhatsApp, et générer le jeton.
Obtenez vos informations API WhatsApp Cloud auprès de Meta
Pour finaliser la migration, vous aurez besoin de trois informations de Meta :
-
ID du compte WhatsApp Business
-
ID du numéro de téléphone
-
Jeton d’accès permanent ou jeton utilisateur système
Vous pouvez obtenir l’ID du compte WhatsApp Business et l’ID du numéro de téléphone depuis votre application Meta.
Créez ou sélectionnez une application Meta
Allez sur Meta for Developers et sélectionnez une application existante ou cliquez sur Créer une application.
Si vous créez une nouvelle application, entrez un nom d’application et une adresse email de contact, puis cliquez sur Suivant.
Choisissez le cas d’utilisation WhatsApp
Sur l’écran de sélection du cas d’utilisation, choisissez Communiquez avec vos clients via WhatsApp, puis cliquez sur Suivant.
Choisissez un portefeuille d’entreprise
Sélectionnez le portefeuille d’entreprise qui possède ou possédera votre compte WhatsApp Business.
Si vous n’avez pas encore de portefeuille d’entreprise, vous pouvez le créer à cette étape ou continuer et le créer plus tard si Meta le permet.
Vérifiez les exigences de publication
Meta peut afficher les exigences de publication pour l’application et le cas d’utilisation sélectionnés. Vérifiez les exigences et cliquez sur Suivant.
Vérifiez et créez l’application
Vérifiez les informations de l’application, le cas d’utilisation WhatsApp sélectionné, et le portefeuille d’entreprise connecté. Cliquez sur Créer une application pour terminer.
Ouvrez la configuration de l’API WhatsApp
Après la création ou la sélection de l’application :
-
Cliquez sur Cas d’utilisation dans la barre latérale.
-
Cherchez Communiquez avec vos clients via WhatsApp.
-
Cliquez sur Personnaliser.
-
Cliquez sur Configuration de l’API.
Dans la nouvelle interface de l’application Meta, allez à Configuration de base → Étape 2. Configuration de production et ouvrez Enregistrez votre numéro WhatsApp.
Dans les anciennes applications Meta, ouvrez WhatsApp → Configuration de l’API depuis la barre latérale gauche.
Ajoutez ou sélectionnez votre numéro WhatsApp
Dans la section Envoyer et recevoir des messages ou Enregistrez votre numéro WhatsApp, choisissez un numéro existant dans le sélecteur De, ou cliquez sur Ajouter un numéro de téléphone.
Si vous ajoutez un nouveau numéro :
-
Renseignez le nom d’affichage WhatsApp Business et les informations de votre entreprise.
-
Saisissez le numéro de téléphone.
-
Choisissez la vérification par SMS ou appel téléphonique.
-
Saisissez le code OTP de Meta pour vérifier le numéro.
Copiez les identifiants requis
Après avoir ajouté ou sélectionné le numéro, copiez ces valeurs depuis la page de configuration de l’API :
-
ID du numéro de téléphone
-
ID du compte WhatsApp Business
Vous devrez coller ces valeurs dans le flux de migration Chatwoot.
Dans l’ancienne interface de Meta, ces valeurs sont affichées directement sous le sélecteur De dans WhatsApp → Configuration de l’API.
Meta modifie fréquemment cette interface. Si votre écran est différent, cherchez la page de configuration de l’API WhatsApp et le numéro d’expéditeur sélectionné. L’ID du numéro de téléphone et l’ID du compte WhatsApp Business sont généralement affichés près du numéro de téléphone De sélectionné.
Configurez un jeton d’accès permanent à l’API WhatsApp Cloud
Vous devez aussi disposer d’un jeton d’accès permanent d’utilisateur système avec les autorisations WhatsApp. Ce jeton permet à Chatwoot de se connecter à votre numéro WhatsApp Cloud API, d’envoyer et recevoir des messages, et de synchroniser les modèles de messages.
Ouvrez les utilisateurs système dans les paramètres Meta Business
-
Ouvrez Paramètres Meta Business.
-
Sélectionnez le portefeuille d’entreprise qui possède votre compte WhatsApp Business.
-
Accédez à Utilisateurs → Utilisateurs système.
-
Si vous avez déjà un utilisateur système pour Chatwoot, sélectionnez-le.
-
Sinon, cliquez sur Ajouter.
Créez un utilisateur système
-
Donnez un nom à l’utilisateur système, par exemple
Chatwoot WhatsApp. -
Sélectionnez Admin comme rôle de l’utilisateur système.
-
Cliquez sur Créer un utilisateur système.
Générez un jeton
-
Sélectionnez l’utilisateur système.
-
Cliquez sur Générer un jeton.
Sélectionnez l’application Meta
Choisissez l’application Meta que vous avez créée ou sélectionnée plus tôt pour la configuration de l’API WhatsApp Cloud, puis cliquez sur Suivant.
Définissez la durée du jeton
Sélectionnez Jamais pour la durée d’expiration du jeton, puis cliquez sur Suivant.
Attribuez les autorisations
Sélectionnez les autorisations WhatsApp requises :
-
whatsapp_business_messaging -
whatsapp_business_management
Continuez ensuite pour générer le jeton.
Copiez le jeton
Après la création du jeton par Meta, cliquez sur Copier et stockez-le en lieu sûr. Vous collerez ce jeton lors de l’étape Jeton d’accès dans le flux de migration Chatwoot.
Gardez ce jeton privé. Toute personne ayant accès peut utiliser votre connexion WhatsApp Cloud API.
Lancez la migration
-
Allez dans Paramètres → Boîtes de réception.
-
Ouvrez la boîte de réception WhatsApp connectée via l’inscription intégrée.
-
Cliquez sur Démarrer la migration manuelle.
Chatwoot ouvrira un assistant de migration guidée.
Étape 1 : Vérifiez ce qui va changer
La première étape explique ce qui sera préservé et ce qui sera mis à jour.
Préservé :
-
Conversations
-
Contacts
-
Collaborateurs
-
Routage
-
Horaires d’ouverture
-
Paramètres de la boîte de réception
Mis à jour :
-
ID WABA
-
ID du numéro de téléphone
-
Jeton d’accès
-
Configuration du webhook
Cliquez sur Continuer.
Étape 2 : Saisissez les détails de l’entreprise
Saisissez les informations d’actif WhatsApp venant de Meta.
Champs :
-
ID WABA : Le compte WhatsApp Business qui possède ce numéro de téléphone.
-
ID du numéro de téléphone : L’ID unique Meta pour le numéro WhatsApp lié à cette boîte.
-
Numéro de téléphone affiché : Le numéro WhatsApp côté client. Il ne peut pas être changé durant la migration.
Cliquez sur Continuer.
Étape 3 : Ajoutez le jeton d’accès
Collez un jeton d’accès permanent ou un jeton utilisateur système avec les autorisations WhatsApp. Le jeton doit inclure whatsapp_business_messaging, whatsapp_business_management, et whatsapp_business_manage_events.
Étape 4 : Vérifiez et reconnectez
Vérifiez la boîte de réception, le numéro de téléphone, l’ID WABA et l’ID du numéro de téléphone avant d’appliquer les modifications.
Chatwoot vérifiera les identifiants auprès de Meta avant d’appliquer les changements. Si la vérification échoue, la configuration actuelle est conservée.
Cliquez sur Reconnecter la boîte de réception WhatsApp pour terminer la migration.
Après la migration
Après la migration, la boîte de réception reste identique dans Chatwoot, mais la connexion WhatsApp utilise la configuration manuelle de l’API WhatsApp Cloud.
Vous devriez vérifier :
-
Réception des messages entrants
-
Réponses sortantes
-
Envoi de messages modèles
-
Synchronisation des modèles
-
Livraison des webhooks
Besoin d’aide ?
Si vous n’êtes pas sûr d’une étape, contactez le Support Chatwoot. Nous pouvons vous aider à vérifier les informations Meta requises et vous assister dans la migration.