Faire tourner un flow Typebot sur WhatsApp avec Coexistence
Le canal WhatsApp de Typebot demande un token, un identifiant de WhatsApp Business Account et un phone number id, puis vous donne une URL de callback et un verify token. Renseignez les trois premiers à partir du numéro connecté, laissez vide l'app secret facultatif de Typebot, et définissez l'URL de callback et le verify token de Typebot comme destination du webhook du numéro.
Typebot classe l'intégration WhatsApp parmi les fonctionnalités de son offre Pro, pas des offres Free ou Starter.
Typebot ne vérifie la signature du webhook que si un app secret est enregistré avec les identifiants.
L'assistant de Typebot refuse un token dont l'expiration n'est pas réglée sur « jamais ».
Débit fixe pour un numéro utilisé à la fois avec l'app WhatsApp Business et la Cloud API.
Quels champs de Typebot prennent des valeurs du numéro connecté ?
L'assistant WhatsApp de Typebot, sous l'onglet Share d'un bot, demande quatre éléments : un app secret, un System User Token, un WhatsApp Business Account ID et un Phone number ID.
Trois d'entre eux viennent directement de la connexion. Le dashboard affiche l'id du WABA, le phone number id et le token d'accès du numéro, et l'outil get_api_credentials renvoie les mêmes valeurs si un assistant les récupère pour vous. Collez-les dans les champs correspondants.
L'app secret est le champ à laisser vide. Typebot s'en sert pour une seule chose sur le trafic entrant : vérifier l'en-tête X-Hub-Signature-256 que Meta ajoute à chaque envoi. Pour un numéro connecté via un Tech Provider, Meta signe avec l'app secret du provider, qui n'est jamais partagé. Toute valeur saisie ici fait donc rejeter par Typebot chaque message authentique. Avec le champ vide, Typebot ignore cette vérification et accepte l'envoi.
Où placer l'URL de callback et le verify token de Typebot ?
Dans la destination du webhook du numéro, et non dans le dashboard d'une app Meta.
L'assistant de Typebot vous demande de coller son Callback URL et son Verify Token dans les paramètres WhatsApp de votre propre app Meta. Avec Coexistence via EasyCoexistence, aucune app à vous n'intervient : Meta route les événements du numéro vers la destination définie sur la connexion. Copiez donc les deux valeurs depuis la dernière étape de Typebot et définissez-les comme destination, dans le dashboard ou avec set_webhook_destination.
Meta envoie ensuite sa requête GET de vérification à Typebot, Typebot répond avec le challenge, et dès lors chaque message reçu par le numéro atteint le bot. Le verify token de Typebot est à usage unique : il est supprimé de la base de données de Typebot dès qu'une vérification réussit. Si vous redéfinissez la destination plus tard, générez d'abord un nouveau token en relançant l'assistant.
Que fait le bot avec la fenêtre de 24 heures ?
Typebot répond aux personnes qui lui ont écrit, ce qui garde presque tous les messages dans la fenêtre du service client. Meta ouvre une fenêtre de 24 heures à chaque message d'un client, et pendant ce temps tout type de message de service peut être envoyé sans template. Un bot qui ne fait que répondre est donc le cas simple.
Le cas limite est un flow qui attend. Un bloc Wait, ou une session qui reprend après plus d'une journée de silence du client, tentera d'envoyer un message en texte libre hors de la fenêtre, et Meta le refuse avec l'erreur 131047. Le délai d'expiration de session de Typebot, 4 heures par défaut et réglable jusqu'à 48, décide quand un client qui revient démarre une nouvelle conversation, pas si Meta accepte le message.
Comme il s'agit de Coexistence, l'équipe voit toujours chaque conversation dans l'app WhatsApp Business et peut intervenir depuis le téléphone dès que le bot ne doit pas répondre.
Erreurs courantes
- Coller un app secret Meta dans Typebot. Les envois sont signés avec le secret du Tech Provider, donc Typebot rejette chaque message pour signature invalide.
- Réutiliser un ancien verify token de Typebot. Il est supprimé après une vérification réussie, donc redéfinir la destination exige d'en obtenir un nouveau depuis l'assistant.
- Partager l'URL de callback. Quand la vérification de signature est désactivée, connaître l'URL suffit pour faire entrer une requête : traitez-la comme un mot de passe.
Connectez le numéro sur easycoexistence.com, copiez son token, son id de WABA et son phone number id dans Typebot, puis définissez l'URL de callback de Typebot comme destination du webhook. À partir de US$ 9 par numéro et par mois, jusqu'à US$ 1 à mesure que vous ajoutez des numéros, avec les 3 premiers jours gratuits.
Questions fréquemment posées
Ai-je besoin de ma propre app Meta pour Typebot ?
Non. Le guide de Typebot en suppose une, car la plupart des gens connectent un numéro eux-mêmes. Avec Coexistence via un Tech Provider, le token et les ids viennent de la connexion et Meta route le webhook vers Typebot.
L'équipe verra-t-elle toujours les messages du bot sur le téléphone ?
Oui. Les messages envoyés via la Cloud API apparaissent dans l'app WhatsApp Business sur le même numéro, donc une personne peut lire la conversation et prendre le relais.
Typebot et n8n peuvent-ils recevoir tous deux les messages du même numéro ?
Non. Un numéro n'a qu'une seule destination de webhook. Si les deux ont besoin des événements, pointez la destination vers n8n et faites transmettre le payload brut par le workflow à l'URL de callback de Typebot.
Typebot stocke-t-il les conversations ?
Typebot conserve ses propres données de session et de résultats, comme sur n'importe quel canal. EasyCoexistence ne stocke jamais le contenu des messages : Meta livre directement à la destination que vous définissez.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitVérifié le