Utiliser un numéro Coexistence comme boîte de réception WhatsApp Cloud dans Chatwoot

Comment connecter un numéro Coexistence à Chatwoot ?

À deux endroits, dans cet ordre.

Dans Chatwoot, ajoutez une boîte de réception, choisissez WhatsApp, puis le fournisseur WhatsApp Cloud avec la configuration manuelle. Saisissez le numéro, l'id du numéro de téléphone, l'id du WhatsApp Business Account et le token d'accès : le dashboard EasyCoexistence les affiche pour la connexion, et get_api_credentials les renvoie à un assistant. Chatwoot affiche ensuite une URL de webhook et un token de vérification du webhook pour la boîte.

Dans EasyCoexistence, réglez la destination du webhook du numéro sur cette URL et saisissez le même token de vérification. Meta envoie sa requête de vérification à Chatwoot, Chatwoot y répond, et dès lors chaque message adressé au numéro arrive dans la boîte. Rien ne tourne entre les deux : il n'y a aucun workflow à maintenir en vie.

Les réponses envoyées depuis le téléphone apparaissent-elles dans Chatwoot ?

Oui. Sur un numéro Coexistence, une réponse saisie dans l'app WhatsApp Business est signalée par Meta comme un événement smb_message_echoes. Le job webhook de Chatwoot reconnaît ce champ et enregistre le message comme sortant, dans la bonne conversation. Son code source décrit directement ce cas : des entreprises qui répondent à la fois depuis Chatwoot et depuis l'app, avec des messages synchronisés vers Chatwoot.

C'est ce qui rend le partage efficace en pratique. Le propriétaire peut continuer à répondre aux habitués depuis son téléphone, l'équipe peut traiter la boîte partagée depuis un bureau, et chacun voit ce que l'autre a envoyé, sans que personne ne transfère de captures d'écran.

Les messages envoyés depuis Chatwoot partent par la Cloud API sur le même numéro, et apparaissent donc aussi sur le téléphone.

Pourquoi la boîte Chatwoot ne doit-elle avoir aucun secret d'app ?

Parce que les envois sont signés avec un secret que vous n'avez pas. Meta signe chaque webhook avec le secret de l'app propriétaire de l'abonnement, c'est-à-dire l'app EasyCoexistence, et ce secret n'est jamais partagé.

Dans le code source actuel de Chatwoot, l'en-tête X-Hub-Signature-256 n'est vérifié sur un canal WhatsApp Cloud configuré manuellement que si un secret d'app y est enregistré, ou si le canal a été créé par l'Embedded Signup propre à Chatwoot. Une boîte manuelle sans secret d'app accepte les envois ; une boîte avec n'importe quel secret d'app les rejette tous comme non autorisés.

La protection qui s'applique ici est le token de vérification. Choisissez une valeur longue et aléatoire, puisque c'est lui qui permet à Chatwoot de distinguer la requête de vérification de Meta de celle de n'importe qui d'autre.

Que ne peut pas faire Chatwoot sur ce numéro ?

Recevoir les webhooks à un deuxième endroit en même temps. Meta achemine les webhooks d'un numéro vers une seule destination : tant que Chatwoot l'occupe, un workflow n8n ne recevra pas les mêmes événements. Si vous avez besoin des deux, pointez la destination vers un petit relais à vous, qui transmet chaque envoi à Chatwoot et au workflow.

Les limites de Coexistence s'appliquent comme partout : l'API envoie jusqu'à 20 messages par seconde, le texte libre ne part que dans les 24 heures suivant le dernier message du client, et les templates couvrent tout ce qui vient après.

Il faut toujours ouvrir l'app WhatsApp Business au moins une fois tous les 14 jours, ce qu'EasyCoexistence surveille.

Erreurs courantes

• Renseigner un secret d'app sur la boîte Chatwoot. Les envois sont signés avec le secret de l'app EasyCoexistence : Chatwoot rejette donc chacun d'eux comme non autorisé.
• Utiliser dans EasyCoexistence un token de vérification différent de celui affiché par Chatwoot. La vérification de Meta échoue et la boîte ne reçoit jamais aucun message.
• Choisir l'Embedded Signup de Chatwoot au lieu de la configuration manuelle. Cela connecte le numéro via l'app Meta propre à Chatwoot, une connexion distincte.

Questions fréquemment posées

Poursuivre la lecture