Utilisez la configuration manuelle si votre numéro est déjà sur la plateforme WhatsApp Business (API), si vous êtes un fournisseur technique reliant votre propre numéro, si vous êtes en auto-hébergement, ou si la configuration rapide n'est pas disponible. Vous connectez Chatwoot à votre propre application Meta.
Plan & accès
-
Tous les forfaits incluant WhatsApp (Startups et supérieurs, ainsi que l’essai gratuit) sur Chatwoot Cloud, et en auto-hébergement. Voir Tarifs et forfaits .
-
Administrateurs uniquement.
-
La coexistence (conserver l’application WhatsApp Business) n’est pas prise en charge avec la configuration manuelle. Si votre numéro est actif dans l’application WhatsApp Business, ne l’enregistrez pas par ce processus. Utilisez la configuration rapide (page 3) ou contactez le support.
Avant de commencer
Vous avez besoin de trois éléments de la part de Meta. Le parcours guidé dans Chatwoot vous explique chaque étape et vous redirige vers l’écran Meta approprié :
-
Une application Meta avec le cas d’usage WhatsApp
-
L’ID du numéro de téléphone et l’ID du compte WhatsApp Business de votre numéro
-
Un jeton d’accès permanent d’un utilisateur système Meta
Connecter votre numéro
-
Allez dans Paramètres › Boîtes de réception › Ajouter une boîte de réception › WhatsApp et choisissez WhatsApp Cloud. Sur l’écran de configuration rapide, cliquez sur configuration manuelle en bas. (Si la configuration rapide n’est pas disponible, vous allez directement à la configuration manuelle.)
-
Créez ou sélectionnez une application Meta. Dans Meta Developers, créez une application (ou sélectionnez celle que vous utilisez déjà pour ce numéro), choisissez de connecter avec les clients via WhatsApp, puis sélectionnez le portefeuille professionnel qui possède le numéro. Cliquez sur Mon application Meta est prête.
-
Ajoutez votre numéro de téléphone et récupérez ses IDs. Dans votre application Meta, ouvrez le cas d’usage WhatsApp et choisissez Configuration de l’API. Dans Envoyer et recevoir des messages, ouvrez le sélecteur De et sélectionnez votre numéro, ou cliquez sur Ajouter un numéro de téléphone, complétez le profil professionnel et validez avec le code envoyé par Meta. Copiez l’ID du numéro de téléphone et l’ID du compte WhatsApp Business, saisissez-les dans Chatwoot et cliquez sur Suivant.
-
Générez un jeton d’accès permanent. Dans les paramètres Meta Business, accédez à Utilisateurs › Utilisateurs système, créez un utilisateur système administrateur (ou sélectionnez-en un), assignez-lui votre application Meta et le Compte WhatsApp Business avec tous les droits, puis cliquez sur Générer le jeton. Choisissez une expiration sur Jamais, sélectionnez whatsapp_business_management et whatsapp_business_messaging, puis copiez le jeton. Meta ne l’affiche qu’une seule fois. Revenez dans Chatwoot, collez-le comme jeton d’accès permanent puis cliquez sur Vérifier les détails.
-
Vérifiez le nom de l’entreprise, le numéro et les IDs, changez le Nom de la boîte de réception si vous le souhaitez, puis cliquez sur Créer la boîte de réception.
-
Chatwoot vérifie l’accès au numéro, l’accès aux modèles, le rappel webhook et l’abonnement webhook, et configure le webhook dans Meta pour vous. Lorsque les quatre items affichent Vérifié, cliquez sur Continuer pour ajouter des agents.
Testez : envoyez un message WhatsApp à votre numéro professionnel depuis un autre téléphone. Il devrait apparaître dans Chatwoot. Répondez et vérifiez la réception.
Gardez votre jeton privé. Toute personne possédant ce jeton peut utiliser votre connexion WhatsApp. Si vous le remplacez ou le révoquez dans Meta, mettez à jour le champ dans l’onglet Configuration de la boîte de réception.
Si une étape de vérification échoue
| Message | Que faire |
|---|---|
| Ce jeton d’accès est invalide ou expiré | Générez un nouveau jeton permanent (expiration Jamais) puis réessayez |
| Accès aux modèles non vérifié | Le jeton ne comprend pas whatsapp_business_management. Les messages fonctionneront, mais les modèles ne seront pas synchronisés. Générez-en un nouveau avec les deux permissions. |
| Rappel webhook ou Abonnement webhook non vérifié | Cliquez sur Réessayer l’installation du webhook. Si cela échoue encore, vérifiez que l’utilisateur système a bien le contrôle total sur le compte WhatsApp Business. |
| Saisissez l’ID du numéro de téléphone et l’ID du compte WhatsApp Business | Copiez-les tous deux depuis Configuration de l’API dans votre application Meta. Ce sont des numéros différents. |
Pour tout autre problème, consultez Dépannage WhatsApp.
Que se passe-t-il ensuite
-
Les modèles approuvés dans votre compte WhatsApp Business sont synchronisés automatiquement. Voir Modèles et la fenêtre de 24 heures.
-
Les appels fonctionnent également avec la configuration manuelle, une fois votre numéro inscrit à l’API d'appels Meta. Voir Appels WhatsApp.
Connecter plusieurs numéros
Oui, c’est possible. Créez une boîte de réception Chatwoot séparée pour chaque numéro. La configuration guidée paramètre le routage du webhook pour chacune, vous n’avez rien à brancher à la main.