WhatsApp AI-agent in n8n, met het antwoord geschreven door je workflow
Een automatiseringsstap stuurt het bericht van de klant, ondertekend en met maximaal 10 recente berichten uit de chat, als POST naar een n8n Webhook-node. Een AI Agent-node schrijft het antwoord, een Respond to Webhook-node geeft {"reply": "..."} terug binnen 20 seconden, en die tekst wordt verstuurd vanaf het WhatsApp Business-nummer, dat in de app blijft werken. Langzamere agents ontvangen de webhook van Meta rechtstreeks en antwoorden via de Graph API.
easyCoexistence koppelt het WhatsApp Business-nummer dat je al in de app gebruikt aan de Cloud API van Meta via Coexistence en draait er automatiseringen op.
Hoelang de stap Call my webhook wacht op het antwoord van je workflow voordat de stap mislukt.
Meest recente berichten van de chat die als history worden meegestuurd, oudste eerst, eindigend met het bericht dat de run startte.
Tekens van een antwoord dat als één WhatsApp-tekst wordt verstuurd; alles daarboven wordt afgekapt.
Kortste tijd tussen twee foutmails voor dezelfde automatisering wanneer een webhook-stap mislukt.
Wat n8n Cloud toestaat in een Code-node: crypto en moment; zelf gehoste n8n activeert crypto met NODE_FUNCTION_ALLOW_BUILTIN.
Klantenserviceperiode na het laatste bericht van de klant; daarna accepteert Meta alleen template-berichten.
Hoe bereikt een WhatsApp-bericht een n8n AI-agent?
Via een automatisering op het nummer. Het nummer moet zijn berichten via easyCoexistence ontvangen (de modus „Through easyCoexistence”), zodat Meta ze hier levert. Een automatisering waarvan de trigger A message arrives is en waarvan de stap Call my webhook is, stuurt het bericht als POST naar je n8n Production URL. De workflow antwoordt in dezelfde HTTP-respons, en de tekst die hij teruggeeft gaat naar de klant als WhatsApp-bericht vanaf jouw nummer.
Voordat n8n wordt aangeroepen, is de run al langs de controles gegaan. Een bericht dat Meta opnieuw verstuurt, start nooit een tweede run. Een antwoord dat je in de app typt, pauzeert de automatisering voor die chat (standaard 4 uur), en het antwoord gaat alleen uit binnen 24 uur na het laatste bericht van de klant. Je workflow bepaalt alleen wat er gezegd wordt.
Wat stuurt easyCoexistence naar de Webhook-node van n8n?
Een JSON-POST met User-Agent easyCoexistence-automations/1, X-EC-Event op automation.step en een X-EC-Signature-header. message bevat de tekst van de klant, of een placeholder zoals [image] met het bijschrift bij media; een spraakbericht komt binnen als [voice message] gevolgd door de woorden ervan wanneer een OpenAI- of OpenRouter-sleutel is opgeslagen. history bevat maximaal 10 recente berichten van de chat, oudste eerst, elk met een direction: in voor de klant, out voor een antwoord van een automatisering en echo voor een persoon die vanaf de telefoon schrijft. Het omvat de berichten die worden bewaard gedurende de bewaartermijn van het account (30, 90 of 365 dagen, standaard 90), en alleen die welke binnenkwamen terwijl de berichten van het nummer via easyCoexistence liepen.
Een test vanuit het paneel Try it van de editor stuurt dezelfde POST met dry_run op true, een lege history, het voorbeeldcontact 15550000000 genaamd Test customer en een bericht-id dat begint met test_. Er wordt niemand iets gestuurd, maar je workflow draait echt, dus sla bijwerkingen over, zoals het aanmaken van bestellingen, wanneer dry_run true is.
{
"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" }
]
}Hoe controleer je de handtekening in n8n?
Voeg direct na de Webhook-node een Code-node toe. X-EC-Signature heeft de vorm t=<unix seconds>,v1=<hex>, waarbij v1 een HMAC-SHA256 is van t, een punt en de body, versleuteld met de Signing secret van de automatisering. Om die te kopiëren open je de opgeslagen automatisering en selecteer je de stap Call my webhook. Elke automatisering heeft een eigen geheim, en MCP-tools geven het nooit terug. Een automatisering die je AI heeft gemaakt, heeft dus nog steeds die ene kopie uit het dashboard nodig. Met de knop New secret vervang je het geheim en het oude werkt meteen niet meer, en alleen de accounteigenaar kan het zien, niet een uitgenodigd teamlid.
Weiger een t die meer dan 5 minuten van je klok afwijkt, vergelijk in constante tijd en gooi een fout bij mislukking. De workflow loopt dan vast vóór Respond to Webhook, n8n antwoordt met 500 en er wordt niets verstuurd. n8n Cloud staat de crypto-module in Code-nodes toe; zelf gehoste n8n heeft NODE_FUNCTION_ALLOW_BUILTIN=crypto nodig. De Crypto-node met de actie Hmac en een IF-node werkt ook, al is een IF-vergelijking niet constant in tijd.
// 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...Hoe stel je de AI Agent-node en het antwoord in?
Geef de AI Agent-node de tekst van de klant als gebruikersbericht en zet al het andere in het systeembericht: wie het bedrijf is, de feiten die het mag citeren, de toon, en de recente chat uit history, zodat een vervolgvraag begrijpelijk is. Koppel het chatmodel dat je wilt, plus tools zoals een HTTP Request-tool die een bestelling opzoekt.
Sluit af met een Respond to Webhook-node die reageert met JSON en de tekst van de agent in een veld met de naam reply zet. easyCoexistence haalt spaties weg, negeert een lege of niet-tekstuele reply, en verstuurt de rest als één WhatsApp-tekst van maximaal 4.096 tekens. Vraag het model dus om gewone zinnen in plaats van markdown.
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() }} }Wat gebeurt er als de workflow traag is, faalt of niets teruggeeft?
Elke uitkomst wordt geregistreerd in het tabblad Runs van de automatisering, met de uitvoer of fout van de stap, zodat je ziet welke van deze dingen er gebeurde:
- Geen antwoord binnen 20 seconden: de stap mislukt met Webhook did not answer, er wordt niets verstuurd en de run toont Failed.
- Een status buiten 2xx, inclusief redirects: de stap mislukt met Webhook answered HTTP en de code.
- Een 2xx zonder reply-tekst: de run is Done, de stap toont HTTP 200, no reply, en de klant krijgt niets automatisch.
- Een mislukte run stuurt je een e-mail zodat je die klant zelf kunt antwoorden, hooguit één keer per automatisering per 6 uur.
- Een chat die je vanaf de telefoon hebt beantwoord binnen de pauze (standaard 4 uur, in te stellen onder Advanced) wordt overgeslagen als
human_activevoordat n8n wordt aangeroepen. - Meerdere snelle berichten starten meerdere runs. Een Wait van 1 minuut vóór Call my webhook geeft één antwoord, omdat een nieuwer bericht dat dezelfde automatisering kiest de wachtende run vervangt.
Wanneer moet n8n juist de webhook van Meta rechtstreeks ontvangen?
Wanneer de agent meer dan 20 seconden nodig heeft, wanneer de workflow elke gebeurtenis moet zien (statussen, je telefoonantwoorden, media-id's), wanneer hij iets verstuurt dat geen enkele stap dekt, zoals een Flow of een catalogusbericht, of wanneer het bedrijf de import van de geschiedenis van 6 maanden wil. Die import gaat alleen naar een rechtstreekse bestemming die binnen 24 uur na het koppelen is opgeslagen. Directe modus zet automatiseringen voor het nummer uit: Meta stuurt zijn eigen payload rechtstreeks naar n8n en easyCoexistence ziet de berichten nooit.
Gebruik in n8n de gewone Webhook-node, niet de WhatsApp Trigger-node, die je eigen Meta-app en diens geheim verwacht. Zet Allow Multiple HTTP Methods aan zodat één lang willekeurig pad zowel Meta's GET-handshake als de POST's opvangt. Beantwoord de GET met de ruwe hub.challenge als tekst, en sla die Production URL op met een verify token via set_webhook_destination. Antwoorden gaan dan vanuit een HTTP Request-node naar het send-endpoint, en deduplicatie, de telefoonpauze en de 24-uurscontrole worden jouw taak.
| Call my webhook (Automations on) | Direct webhook (automations off) | |
|---|---|---|
| Who calls n8n | easyCoexistence, when the automation matches | Meta, for every event on the number |
| Time to answer | 20 seconds, reply in the response | No limit: send later through the Graph API |
| Authentication | X-EC-Signature with the automation's secret | A long random secret in the URL path |
| Guards | Dedupe, phone pause and 24-hour check built in | Yours to write |
| What n8n can send | Text in the reply; the other steps of the automation can send buttons, files and templates | Any Cloud API message type, templates included |
| History import | Not available | If saved within 24 hours of connecting |
| Kept by easyCoexistence | Message text for your retention period (90 days by default), run logs 30 days | Nothing |
Zo stel je het in
- 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.
- 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.
- 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.
- 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.
- 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.
Veelgemaakte fouten
- Het Respond-veld van de Webhook-node op Immediately laten staan. n8n antwoordt dan meteen Workflow got started, de run logt HTTP 200, geen antwoord, en de klant krijgt niets. Kies Using 'Respond to Webhook' Node.
- De Test URL plakken, die met /webhook-test/. Die luistert alleen zolang de editor op een testgebeurtenis wacht; automatiseringen hebben de Production URL van een gepubliceerde workflow nodig.
- Verifiëren met het forward secret van het nummer. Call my webhook wordt ondertekend met het eigen Signing secret van de automatisering. Het forward secret ondertekent alleen doorgestuurde gebeurtenissen, dus echte stappen falen de controle.
- Het antwoord in een andere vorm teruggeven. Alleen een JSON-body met een string op het hoogste niveau die reply heet wordt verstuurd; {"output": "..."} of een text/plain-body wordt gelogd als no reply.
De stap Call my webhook geeft het bericht van de klant aan n8n en stuurt het antwoord terug, met deduplicatie, de pauze wanneer je vanaf de telefoon antwoordt en de 24-uurscontrole ingebouwd, zonder extra kosten per run. US$ 9 tot US$ 0,75 per nummer per maand, dalend naarmate je nummers toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Kunnen ChatGPT of Claude deze automatisering voor mij maken?
Ja. Voeg de easyCoexistence-connector toe en vraag om een automatisering op je nummer die binnenkomende berichten naar je n8n-URL stuurt. De AI roept create_automation aan met een call_webhook-stap, daarna test_automation. Vraag hem de automatisering uitgeschakeld te maken totdat de test slaagt. Het Signing secret wordt niet via MCP teruggegeven, dus kopieer het van de pagina van de automatisering.
Kan de workflow afbeeldingen, knoppen of templates versturen?
Niet via het reply-veld, dat alleen tekst bevat. Laat de automatisering het in plaats daarvan doen: stappen zoals Send a picture or file, Ask a question with buttons en Send a template kunnen voor of na Call my webhook staan. Verstuur andere berichttypen vanuit een HTTP Request-node naar de Cloud API, met het send-endpoint en het token die get_api_credentials teruggeeft. Geef geen reply terug, zodat de klant niet twee keer een antwoord krijgt.
Kan één workflow meerdere nummers beantwoorden?
Ja. Laat per nummer één automatisering naar dezelfde Production URL wijzen en vertakken op channel.phone_number_id of automation.id. Elke automatisering heeft een eigen Signing secret, dus kies het geheim op automation.id voordat je de handtekening controleert.
Werkt een zelf gehoste n8n?
Ja, als de Production URL publiek via HTTPS bereikbaar is. easyCoexistence weigert http-, localhost-, private- en interne adressen wanneer je de URL opslaat en opnieuw vóór elke aanroep, en het volgt geen redirects.
Lees verder
Klaar om te beginnen?
Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.
Start je gratis proefperiodeGeverifieerd op