Utilisez la configuration manuelle si votre numéro est déjà sur la plateforme WhatsApp Business (API), si vous êtes un fournisseur technologique configurant votre propre numéro, si vous êtes auto-hébergé sans configuration rapide activée, ou si la configuration rapide est indisponible. Vous connectez Chatwoot à votre propre application Meta.
Forfait & accès
-
Tous les forfaits incluant WhatsApp (Startups et supérieur, et la période d'essai gratuite) sur Chatwoot Cloud, et auto-hébergé. Voir Tarification & Forfaits.
-
Administrateurs uniquement.
-
La coexistence (garder l'application WhatsApp Business) n'est pas supportée avec la configuration manuelle. Si votre numéro est actif dans l'application WhatsApp Business, ne l'enregistrez pas via ce processus. Utilisez Configuration rapide avec Meta ou contactez le support.
Avant de commencer
Vous avez besoin de trois éléments de Meta. La configuration guidée sur Chatwoot vous guide à travers chacune d'elles et vous redirige vers l'écran Meta approprié :
-
Une application Meta avec le cas d'utilisation WhatsApp
-
Phone Number ID (identifiant du numéro) et WhatsApp Business Account ID (identifiant du compte) de votre numéro
-
Un jeton d'accès permanent provenant d'un utilisateur système Meta
Connecter votre numéro
-
Allez dans Paramètres › Boîtes de réception › Ajouter une boîte › 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 passez directement à la configuration manuelle.)
-
Créer ou sélectionner une application Meta. Dans Meta Developers, créez une application (ou choisissez celle que vous utilisez déjà pour ce numéro), choisissez de connecter avec les clients par WhatsApp, et sélectionnez le portefeuille d'entreprise 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 identifiants. Dans votre application Meta, ouvrez le cas d'utilisation WhatsApp et choisissez API Setup (Cas d'utilisation › Connecter avec vos clients par WhatsApp › Personnaliser › API Setup). Sur les applications plus récentes, allez dans Basic setup › Production setup et ouvrez plutôt Register your WhatsApp phone number. Dans Envoyer et recevoir des messages (ou Register your WhatsApp phone number), ouvrez le sélecteur From et sélectionnez votre numéro, ou cliquez sur Add phone number, complétez le profil entreprise et validez avec le code que Meta envoie par SMS ou appel téléphonique. Meta modifie souvent cet écran. Le Phone Number ID et le WhatsApp Business Account ID sont généralement affichés près du numéro sélectionné dans From. Copiez le Phone Number ID et le WhatsApp Business Account ID, saisissez-les dans Chatwoot et cliquez sur Suivant.
-
Générez un jeton d'accès permanent. Dans les paramètres Meta Business, sélectionnez le portefeuille d'entreprise qui possède votre compte WhatsApp Business, puis allez dans Utilisateurs › Utilisateurs système. Créez un utilisateur système admin (ou sélectionnez-en un), affectez-lui votre application Meta et votre compte WhatsApp Business avec un contrôle complet, puis cliquez sur Générer un jeton. Sélectionnez l'application Meta créée, définissez l'expiration sur Jamais, choisissez whatsapp_business_management et whatsapp_business_messaging, et copiez le jeton. Meta ne le montre qu'une seule fois. De retour sur 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 identifiants, modifiez le Nom de la boîte si vous le souhaitez, et 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 du webhook et l'abonnement au webhook, et configure le webhook dans Meta à votre place. Lorsque les quatre sont Vérifiés, 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 qu'il arrive bien.
Gardez votre jeton privé. Toute personne en possession de celui-ci 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 |
|---|---|
| This access token is invalid or expired | Générez un nouveau jeton permanent (expiration Jamais) et réessayez |
| Template access not verified | Le jeton ne possède pas la permission whatsapp_business_management. Les messages fonctionneront, mais les modèles ne se synchroniseront pas. Générez un jeton avec les deux permissions. |
| Webhook callback or Webhook subscription not verified | 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. Si la réessayer échoue toujours, configurez le webhook manuellement : copiez l'URL du webhook et le jeton de vérification du webhook affichés sur l'écran de fin (le jeton est aussi dans l'onglet Configuration de la boîte). Dans votre appli Meta, allez dans WhatsApp › Configuration, collez les deux, cliquez sur Vérifier et enregistrer, puis abonnez-vous au champ messages. |
| Enter the Phone Number ID and WhatsApp Business Account ID | Copiez-les tous deux depuis API Setup dans votre application Meta. Ce sont bien deux numéros différents. |
Pour tout autre cas, voir Dépannage WhatsApp.
Ce qui se passe ensuite
-
Les modèles approuvés dans votre compte WhatsApp Business se synchronisent automatiquement. Voir Modèles et la fenêtre de 24 heures.
-
La fonction d'appel fonctionne aussi avec la configuration manuelle, une fois que votre numéro est inscrit à l'API Calling 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. La configuration guidée s'occupe du routage webhook pour chacun, vous n'avez donc rien à configurer manuellement.