Utilisez la configuration manuelle si votre numéro est déjà sur la plateforme WhatsApp Business (API), si vous êtes un fournisseur technique intégrant votre propre numéro, si vous hébergez vous-même, ou si la configuration rapide est indisponible. Vous connectez Chatwoot à votre propre application Meta.
Offre & accès
-
Tous les forfaits incluant WhatsApp (Startups et supérieur, ainsi que l’essai gratuit) sur Chatwoot Cloud, et auto-hébergé. Voir Tarification & Forfaits.
-
Administrateurs uniquement.
-
La coexistence (garder 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 via cette méthode. Utilisez la configuration rapide (page 3) ou contactez le support.
Avant de commencer
Vous avez besoin de trois éléments de Meta. L’assistant de configuration dans Chatwoot vous guide pour chacun et vous redirige vers l’écran Meta adéquat :
-
Une application Meta avec le cas d’utilisation WhatsApp
-
L’ID de 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
Connectez votre numéro
-
Accédez à 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 est indisponible, vous arrivez directement sur 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 des clients via WhatsApp, et sélectionnez le portefeuille d’entreprise possédant 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’utilisation WhatsApp et sélectionnez API Setup. Dans Envoyer et recevoir des messages, ouvrez le sélecteur De et choisissez votre numéro, ou sélectionnez Ajouter un numéro de téléphone, complétez le profil d’entreprise et vérifiez avec le code envoyé par Meta. Copiez l’ID de 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 Meta Business Settings, allez dans Utilisateurs › Utilisateurs système, créez un utilisateur système admin (ou sélectionnez-en un), attribuez-lui votre application Meta et le compte WhatsApp Business avec le contrôle total, puis cliquez sur Générer un jeton. Définissez l’expiration sur Jamais, sélectionnez whatsapp_business_management et whatsapp_business_messaging, puis copiez le jeton. Meta ne l’affiche qu’une seule fois. Retournez dans Chatwoot, collez-le comme Jeton d’accès permanent et cliquez sur Vérifier les détails.
-
Vérifiez le nom de l’entreprise, le numéro et les IDs, modifiez 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 callback du webhook et l’abonnement au webhook, et configure le webhook dans Meta pour vous. Quand les quatre sont affichés comme Vérifiés, cliquez sur Continuer pour ajouter des agents.
Testez-le : 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 que le message arrive.
Conservez votre jeton privé. Toute personne le possédant peut utiliser votre connexion WhatsApp. Si vous le remplacez ou le révoquez dans Meta, mettez-le à jour 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) et réessayez |
| L’accès aux modèles non vérifié | Le jeton ne possède pas whatsapp_business_management. Les messages fonctionneront, mais les modèles ne seront pas synchronisés. Générez un jeton avec ces deux permissions. |
| Callback webhook ou Abonnement webhook non vérifié | Cliquez sur Réessayer la configuration du webhook. Si cela échoue encore, vérifiez que l’utilisateur système a le contrôle total du compte WhatsApp Business. |
| Saisissez l’ID de numéro de téléphone et l’ID du compte WhatsApp Business | Copiez-les tous les deux depuis API Setup dans votre application Meta. Ce sont des numéros différents. |
Pour tout autre problème, voir Dépanner WhatsApp.
Que se passe-t-il ensuite
-
Les modèles approuvés dans votre compte WhatsApp Business se synchronisent automatiquement. Voir Modèles et fenêtre de 24 heures.
-
Les appels fonctionnent aussi avec la configuration manuelle, une fois que votre numéro est inscrit auprès de l’API d’appel de Meta. Voir Appels WhatsApp.
Connecter plus d’un numéro
Oui, c’est possible. Créez une boîte de réception Chatwoot distincte pour chaque numéro. L’assistant configure le routage du webhook pour chacun, il n’y a donc rien à brancher manuellement.