Se connecterCommencer l’essai gratuit
Meta Tech Provider

Agent IA WhatsApp dans n8n, avec la réponse rédigée par votre workflow

Une étape d'automatisation envoie le message du client, signé et accompagné d'un maximum de 10 messages récents de la conversation, à un nœud Webhook de n8n. Un nœud AI Agent rédige la réponse, un nœud Respond to Webhook renvoie {"reply": "..."} sous 20 secondes, et ce texte est envoyé depuis le numéro WhatsApp Business, qui continue de fonctionner dans l'application. Les agents plus lents reçoivent directement le webhook de Meta et répondent via la Graph API.

easyCoexistence relie le numéro WhatsApp Business que vous utilisez déjà dans l'application à la Cloud API de Meta via Coexistence, et y fait tourner des automatisations.

20 s

Durée d'attente de l'étape Call my webhook pour la réponse de votre workflow avant que l'étape échoue.

10

Derniers messages de la conversation envoyés dans history, du plus ancien au plus récent, se terminant par le message qui a déclenché l'exécution.

4,096

Nombre maximal de caractères d'une réponse envoyée en un seul message texte WhatsApp ; au-delà, le texte est coupé.

6 hours

Délai minimal entre deux e-mails d'échec pour une même automatisation lorsqu'une étape webhook échoue.

2 modules

Ce que n8n Cloud autorise dans un nœud Code : crypto et moment ; n8n auto-hébergé active crypto avec NODE_FUNCTION_ALLOW_BUILTIN.

24 hours

Fenêtre de service client après le dernier message du client ; au-delà, Meta n'accepte que les messages template.

Comment un message WhatsApp parvient-il à un agent IA n8n ?

Grâce à une automatisation sur le numéro. Le numéro doit recevoir ses messages via easyCoexistence (le mode « Through easyCoexistence »), pour que Meta les transmette ici : une automatisation dont le déclencheur est A message arrives et dont l'étape est Call my webhook envoie alors le message en POST à votre URL de production n8n. Le workflow répond dans la même réponse HTTP, et le texte qu'il renvoie est transmis au client sous forme de message WhatsApp depuis votre numéro.

Avant l'appel à n8n, l'exécution a déjà passé les contrôles. Un envoi répété par Meta ne lance jamais une seconde exécution, une réponse que vous avez tapée dans l'application met l'automatisation en pause sur cette conversation (4 heures par défaut), et la réponse n'est envoyée que dans les 24 heures suivant le dernier message du client. Votre workflow décide seulement de ce qu'il faut dire.

1Customer writesTo the number you keep in the WhatsApp Business app
2Call my webhookSigned POST with the message and recent chat
3n8n AI AgentWebhook node, signature check, AI Agent node
4Respond to Webhook{"reply": "..."} within 20 seconds
5Reply sentAlso shown in the app's chat thread

Que reçoit le nœud Webhook de n8n depuis easyCoexistence ?

Un POST JSON avec le User-Agent easyCoexistence-automations/1, X-EC-Event défini sur automation.step et un en-tête X-EC-Signature. message contient le texte du client, ou un marqueur comme [image] accompagné de sa légende pour les médias ; une note vocale arrive sous la forme [voice message] suivie de son texte lorsqu'une clé OpenAI ou OpenRouter est enregistrée. history contient jusqu'à 10 messages récents de la conversation, du plus ancien au plus récent, chacun avec une direction : in pour le client, out pour une réponse d'automatisation et echo pour une personne qui écrit depuis le téléphone. Cela couvre les messages conservés pendant la durée de rétention du compte (30, 90 ou 365 jours, 90 par défaut), et uniquement ceux reçus pendant que les messages du numéro passaient par easyCoexistence.

Un test depuis le panneau Try it de l'éditeur envoie le même POST avec dry_run à true, un history vide, le contact d'exemple 15550000000 nommé Test customer et un identifiant de message commençant par test_. Rien n'est envoyé à qui que ce soit, mais votre workflow s'exécute réellement : évitez donc les effets de bord, comme la création de commandes, lorsque dry_run vaut true.

POST body of a Call my webhook step
{
  "event": "automation.step",
  "dry_run": false,
  "automation": { "id": "b7e0c3a2-5d1f-4c8e-9a6b-2f4d8e1c7a90", "name": "Send to my system" },
  "run_id": "0d9f6a41-8c2e-4b7a-a315-6e9c2b8d4f17",
  "channel": {
    "type": "whatsapp",
    "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f",
    "phone": "+1 631-555-0142",
    "phone_number_id": "106540352242922"
  },
  "connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
  "contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
  "message": {
    "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==",
    "type": "text",
    "text": "Do you have gluten-free bread today?",
    "at": "2026-11-11T14:02:11.000Z"
  },
  "history": [
    { "direction": "in", "text": "Hi! Are you open today?", "at": "2026-11-11T13:58:40.000Z" },
    { "direction": "out", "text": "Hi Ana! Yes, until 8 pm.", "at": "2026-11-11T13:58:45.000Z" },
    { "direction": "in", "text": "Do you have gluten-free bread today?", "at": "2026-11-11T14:02:11.000Z" }
  ]
}

Comment vérifier la signature dans n8n ?

Ajoutez un nœud Code juste après le nœud Webhook. X-EC-Signature se lit t=<unix seconds>,v1=<hex>, où v1 est un HMAC-SHA256 de t, d'un point et du corps, avec pour clé le Signing secret de l'automatisation. Pour le copier, ouvrez l'automatisation enregistrée et sélectionnez son étape Call my webhook. Chaque automatisation a son propre secret, et les outils MCP ne le renvoient jamais : une automatisation créée par votre IA a donc besoin de cette seule copie depuis le tableau de bord. Un bouton New secret le remplace et l'ancien cesse de fonctionner immédiatement, et seul le propriétaire du compte peut le voir, pas un membre d'équipe invité.

Rejetez un t éloigné de plus de 5 minutes de votre horloge, comparez en temps constant et levez une erreur en cas d'échec : le workflow échoue alors avant Respond to Webhook, n8n répond 500 et rien n'est envoyé. n8n Cloud autorise le module crypto dans les nœuds Code ; n8n auto-hébergé nécessite NODE_FUNCTION_ALLOW_BUILTIN=crypto. L'action Hmac du nœud Crypto avec un nœud IF fonctionne aussi, bien qu'une comparaison IF ne soit pas à temps constant.

n8n Code node: verify X-EC-Signature
// n8n Code node, mode "Run Once for Each Item", placed right after the Webhook node.
// n8n Cloud allows require('crypto'); self-hosted needs NODE_FUNCTION_ALLOW_BUILTIN=crypto.
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the automation's Signing secret, from its editor page

const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec($json.headers['x-ec-signature'] || '');
if (!m) throw new Error('Missing X-EC-Signature');
if (Math.abs(Date.now() / 1000 - Number(m[1])) > 300) throw new Error('Stale signature');

// The body was signed as compact JSON, which JSON.stringify rebuilds from the parsed body.
const mac = crypto.createHmac('sha256', SECRET).update(`${m[1]}.${JSON.stringify($json.body)}`).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(m[2], 'hex'))) throw new Error('Bad signature');

return { json: $json.body }; // event, dry_run, contact, message, history...

Comment configurer le nœud AI Agent et la réponse ?

Donnez au nœud AI Agent le texte du client comme message utilisateur, et tout le reste dans son message système : qui est l'entreprise, les faits qu'il peut citer, le ton, et l'historique récent de history pour qu'une question de suivi ait du sens. Branchez le modèle de chat souhaité, ainsi que des outils comme un outil HTTP Request qui consulte une commande.

Terminez par un nœud Respond to Webhook qui répond en JSON et place le texte de l'agent dans un champ nommé reply. easyCoexistence supprime les espaces en trop, ignore une réponse vide ou qui n'est pas une chaîne, et envoie le reste comme un seul message texte WhatsApp de 4 096 caractères au maximum : demandez donc au modèle des phrases simples plutôt que du markdown.

AI Agent and Respond to Webhook settings
AI Agent node
  Prompt: Define below
  Prompt (User Message): {{ $json.message.text }}
  Options > System Message:
    You answer WhatsApp messages for Bloom Café, 12 Baker St, open Tue to Sun 8:00 to 20:00.
    Reply in 1 to 3 short sentences, in the customer's language, as plain text.
    Never invent prices or stock. If unsure, say a person will reply here soon.
    Recent chat, oldest first:
    {{ $json.history.map(h => (h.direction === 'in' ? 'Customer: ' : 'Business: ') + h.text).join('\n') }}
  Chat Model: your OpenAI, Anthropic or OpenRouter model
  Tools (optional): an HTTP Request tool that looks up orders

Respond to Webhook node
  Respond With: JSON
  Response Body: { "reply": {{ $json.output.toJsonString() }} }

Que se passe-t-il si le workflow est lent, échoue ou ne renvoie rien ?

Chaque résultat est consigné dans l'onglet Runs de l'automatisation, avec la sortie ou l'erreur de l'étape, pour que vous puissiez voir lequel de ces cas s'est produit :

  • Pas de réponse dans les 20 secondes : l'étape échoue avec Webhook did not answer, rien n'est envoyé et l'exécution affiche Failed.
  • Un statut hors 2xx, redirections comprises : l'étape échoue avec Webhook answered HTTP suivi du code.
  • Un 2xx sans chaîne de réponse : l'exécution est Done, l'étape affiche HTTP 200, no reply, et le client ne reçoit rien automatiquement.
  • Une exécution en échec vous envoie un e-mail pour que vous répondiez vous-même à ce client, au plus une fois toutes les 6 heures par automatisation.
  • Une conversation à laquelle vous avez répondu depuis le téléphone pendant la pause (4 heures par défaut, réglable sous Advanced) est ignorée avec human_active avant tout appel à n8n.
  • Plusieurs messages rapprochés lancent plusieurs exécutions. Une étape Wait de 1 minute avant Call my webhook ne répond qu'une fois, car un message plus récent qui cible la même automatisation remplace l'exécution en attente.

Quand n8n doit-il recevoir directement le webhook de Meta ?

Lorsque l'agent a besoin de plus de 20 secondes, lorsque le workflow doit voir chaque événement (statuts, réponses depuis votre téléphone, identifiants de médias), lorsqu'il envoie quelque chose qu'aucune étape ne couvre, comme un Flow ou un message de catalogue, ou lorsque l'entreprise veut l'import de l'historique sur 6 mois, qui n'est possible que vers une destination directe enregistrée dans les 24 heures suivant la connexion. Le mode direct désactive les automatisations pour le numéro : Meta envoie son propre payload directement à n8n et easyCoexistence ne voit jamais les messages.

Dans n8n, utilisez le nœud Webhook simple, et non le nœud WhatsApp Trigger, qui attend votre propre application Meta et son secret. Activez l'option Allow Multiple HTTP Methods pour qu'un long chemin aléatoire unique reçoive la requête GET de vérification de Meta ainsi que les POST, répondez à la GET avec le hub.challenge brut en texte, puis enregistrez cette URL de production avec un verify token via set_webhook_destination. Les réponses partent ensuite d'un nœud HTTP Request vers l'endpoint d'envoi, et la déduplication, la pause du téléphone et la vérification des 24 heures vous reviennent.

Call my webhook (Automations on)Direct webhook (automations off)
Who calls n8neasyCoexistence, when the automation matchesMeta, for every event on the number
Time to answer20 seconds, reply in the responseNo limit: send later through the Graph API
AuthenticationX-EC-Signature with the automation's secretA long random secret in the URL path
GuardsDedupe, phone pause and 24-hour check built inYours to write
What n8n can sendText in the reply; the other steps of the automation can send buttons, files and templatesAny Cloud API message type, templates included
History importNot availableIf saved within 24 hours of connecting
Kept by easyCoexistenceMessage text for your retention period (90 days by default), run logs 30 daysNothing

Comment le configurer

  1. Turn on automations for the numberOn the number's page, the Automations and incoming messages card shows Automations on or Direct to your server. Click Turn on automations if needed; numbers connected without a webhook URL start with automations on.
  2. Build and publish the workflowWebhook node (POST, Respond: Using 'Respond to Webhook' Node), Code node, AI Agent node, Respond to Webhook node. Publish or activate it and copy the Production URL.
  3. Create the automation, switched OffIn Automations, click New automation and pick Send to my system under Start from an example. Paste the Production URL into Webhook URL, set the switch to Off so it does not answer customers yet, and click Save.
  4. Copy the Signing secret into n8nSelect the Call my webhook step of the saved automation, copy Signing secret and paste it into the Code node.
  5. Test, then switch it OnClick Test, type a sample message in Try it and press Run test: n8n runs with dry_run true and the result shows the reply. When it reads right, switch the automation On and save.

Erreurs courantes

  • Laisser l'option Respond du nœud Webhook sur Immediately. n8n répond aussitôt Workflow got started, l'exécution consigne HTTP 200, no reply, et le client ne reçoit rien. Choisissez Using 'Respond to Webhook' Node.
  • Coller l'URL de test, celle avec /webhook-test/. Elle n'écoute que pendant que l'éditeur attend un événement de test ; les automatisations ont besoin de l'URL de production d'un workflow publié.
  • Vérifier avec le secret de transfert du numéro. Call my webhook est signé avec le Signing secret propre à l'automatisation ; le secret de transfert ne signe que les événements transférés, donc les étapes authentiques échouent au contrôle.
  • Renvoyer le texte sous une autre forme. Seul un corps JSON avec une chaîne de premier niveau nommée reply est envoyé ; {"output": "..."} ou un corps text/plain sont consignés comme no reply.
Faire cela avec EasyCoexistence

Son étape Call my webhook transmet le message du client à n8n et renvoie la réponse, avec déduplication, pause lorsque vous répondez depuis le téléphone et vérification des 24 heures intégrées, sans frais supplémentaire par exécution. De US$ 9 à US$ 0,75 par numéro et par mois, dégressif à mesure que vous ajoutez des numéros, avec les 3 premiers jours en essai gratuit.

Questions fréquemment posées

Est-ce que ChatGPT ou Claude peuvent créer cette automatisation pour moi ?

Oui. Une fois le connecteur easyCoexistence ajouté, demandez une automatisation sur votre numéro qui envoie les messages entrants à votre URL n8n ; l'IA appelle create_automation avec une étape call_webhook, puis test_automation. Demandez-lui de créer l'automatisation désactivée jusqu'à la réussite du test. Le Signing secret n'est pas renvoyé par MCP : copiez-le donc depuis la page de l'automatisation.

Le workflow peut-il envoyer des images, des boutons ou des templates ?

Pas via le champ de réponse, qui ne transporte que du texte. Laissez plutôt l'automatisation s'en charger : des étapes comme Send a picture or file, Ask a question with buttons et Send a template peuvent se placer avant ou après Call my webhook. Pour les autres types de message, envoyez-les depuis un nœud HTTP Request vers la Cloud API, avec l'endpoint d'envoi et le token renvoyés par get_api_credentials, et ne renvoyez aucune réponse afin que le client ne soit pas contacté deux fois.

Un seul workflow peut-il répondre à plusieurs numéros ?

Oui. Associez une automatisation par numéro à la même URL de production et branchez-vous sur channel.phone_number_id ou automation.id. Chaque automatisation a son propre Signing secret, donc choisissez le secret par automation.id avant de vérifier la signature.

Un n8n auto-hébergé fonctionne-t-il ?

Oui, si son URL de production est en HTTPS public. easyCoexistence refuse les adresses http, localhost, privées et internes lorsque vous enregistrez l'URL, puis à nouveau avant chaque appel, et ne suit pas les redirections.

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 gratuit

Vérifié le