WhatsApp-KI-Agent in n8n: Die Antwort schreibt Ihr Workflow
Ein Automatisierungsschritt sendet die Nachricht des Kunden, signiert und mit bis zu 10 letzten Nachrichten des Chats, per POST an einen n8n-Webhook-Node. Ein AI-Agent-Node schreibt die Antwort, ein Respond-to-Webhook-Node gibt {"reply": "..."} innerhalb von 20 Sekunden zurück, und dieser Text wird von Ihrer WhatsApp-Business-Nummer gesendet, die weiterhin in der App funktioniert. Langsamere Agenten erhalten den Webhook von Meta direkt und antworten über die Graph API.
easyCoexistence verbindet die WhatsApp-Business-Nummer, die Sie bereits in der App nutzen, über Coexistence mit der Cloud API von Meta und führt Automatisierungen darauf aus.
Wie lange der Schritt „Call my webhook“ auf die Antwort Ihres Workflows wartet, bevor er fehlschlägt.
Die letzten Nachrichten des Chats, übergeben in `history`, älteste zuerst und endend mit der Nachricht, die den Lauf gestartet hat.
Zeichen einer Antwort, die als eine WhatsApp-Textnachricht gesendet wird; alles darüber hinaus wird abgeschnitten.
Kürzester Abstand zwischen zwei Fehler-E-Mails für dieselbe Automatisierung, wenn ein Webhook-Schritt fehlschlägt.
Was n8n Cloud in einem Code-Node erlaubt: crypto und moment; selbst gehostetes n8n aktiviert crypto mit NODE_FUNCTION_ALLOW_BUILTIN.
Servicefenster nach der letzten Nachricht des Kunden; danach akzeptiert Meta nur Template-Nachrichten.
Wie gelangt eine WhatsApp-Nachricht zu einem n8n-KI-Agenten?
Über eine Automatisierung auf der Nummer. Die Nummer muss ihre Nachrichten über easyCoexistence erhalten (der Modus „Through easyCoexistence“), damit Meta sie hierher zustellt. Eine Automatisierung mit dem Auslöser für eingehende Nachrichten und dem Schritt „Call my webhook“ sendet die Nachricht dann per POST an Ihre n8n-Production-URL. Der Workflow antwortet in derselben HTTP-Antwort, und der zurückgegebene Text geht als WhatsApp-Nachricht von Ihrer Nummer an den Kunden.
Bevor n8n aufgerufen wird, hat der Lauf die Prüfungen bereits durchlaufen. Eine Zustellung, die Meta wiederholt, startet keinen zweiten Lauf. Eine Antwort, die Sie in der App eingeben, pausiert die Automatisierung für diesen Chat (standardmäßig 4 Stunden), und die Antwort geht nur innerhalb von 24 Stunden nach der letzten Nachricht des Kunden hinaus. Ihr Workflow entscheidet nur darüber, was gesagt wird.
Was sendet easyCoexistence an den n8n-Webhook-Node?
Einen JSON-POST mit dem User-Agent easyCoexistence-automations/1, dem Header X-EC-Event mit dem Wert automation.step und einem Header X-EC-Signature. Das Feld `message` enthält den Text des Kunden oder einen Platzhalter wie [image] mit der Bildunterschrift bei Medien. Eine Sprachnachricht kommt als `[voice message]` gefolgt von ihrem Wortlaut an, wenn ein OpenAI- oder OpenRouter-Schlüssel gespeichert ist. `history` enthält bis zu 10 letzte Nachrichten des Chats, älteste zuerst, jeweils mit einer `direction`: `in` für den Kunden, `out` für eine Antwort der Automatisierung und `echo` für eine Person, die vom Telefon aus schreibt. Es umfasst die Nachrichten, die für die Aufbewahrungsdauer des Kontos gespeichert werden (30, 90 oder 365 Tage, standardmäßig 90), und nur solche, die eingingen, während die Nachrichten der Nummer über easyCoexistence liefen.
Ein Test aus dem Panel „Try it“ im Editor sendet denselben POST mit `dry_run` auf `true`, einem leeren `history`, dem Beispielkontakt 15550000000 mit dem Namen „Test customer“ und einer Nachrichten-ID, die mit `test_` beginnt. Niemand erhält eine Nachricht, aber Ihr Workflow läuft tatsächlich. Überspringen Sie deshalb Nebenwirkungen wie das Anlegen von Bestellungen, wenn `dry_run` auf `true` steht.
{
"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" }
]
}Wie prüfen Sie die Signatur in n8n?
Fügen Sie direkt nach dem Webhook-Node einen Code-Node ein. `X-EC-Signature` lautet `t=<Unix-Sekunden>,v1=<hex>`, wobei `v1` ein HMAC-SHA256 von `t`, einem Punkt und dem Body ist, mit dem Signing secret der Automatisierung als Schlüssel. Zum Kopieren öffnen Sie die gespeicherte Automatisierung und wählen den Schritt „Call my webhook“. Jede Automatisierung hat ein eigenes Geheimnis, und MCP-Tools geben es nie zurück. Eine von Ihrer KI erstellte Automatisierung braucht daher trotzdem diese eine Kopie aus dem Dashboard. Eine Schaltfläche „New secret“ ersetzt es, und das alte funktioniert sofort nicht mehr. Außerdem kann nur der Kontoinhaber es sehen, kein eingeladenes Teammitglied.
Lehnen Sie ein `t` ab, das mehr als 5 Minuten von Ihrer Uhr abweicht, vergleichen Sie zeitkonstant und werfen Sie bei Fehlschlag einen Fehler: Der Workflow bricht dann vor Respond to Webhook ab, n8n antwortet mit 500, und nichts wird gesendet. n8n Cloud erlaubt das Modul crypto in Code-Nodes; selbst gehostetes n8n benötigt `NODE_FUNCTION_ALLOW_BUILTIN=crypto`. Die Aktion Hmac des Crypto-Nodes mit einem IF-Node funktioniert ebenfalls, allerdings ist ein IF-Vergleich nicht zeitkonstant.
// 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...Wie richten Sie den AI-Agent-Node und die Antwort ein?
Geben Sie dem AI-Agent-Node den Text des Kunden als User-Nachricht und alles Übrige in der System-Nachricht mit: wer das Unternehmen ist, welche Fakten es nennen darf, den Ton und den letzten Chatverlauf aus `history`, damit eine Rückfrage Sinn ergibt. Hängen Sie das gewünschte Chat-Modell an sowie Tools wie ein Tool für HTTP-Anfragen, das eine Bestellung nachschlägt.
Schließen Sie mit einem Respond-to-Webhook-Node ab, der mit JSON antwortet und den Text des Agenten in ein Feld namens `reply` legt. easyCoexistence kürzt den Text, ignoriert eine leere Antwort oder einen Wert, der kein Text ist, und sendet den Rest als eine WhatsApp-Textnachricht mit bis zu 4,096 Zeichen. Bitten Sie das Modell deshalb um einfache Sätze statt 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() }} }Was passiert, wenn der Workflow langsam ist, fehlschlägt oder nichts zurückgibt?
Jedes Ergebnis wird im Tab „Runs“ der Automatisierung mit der Ausgabe oder dem Fehler des Schritts protokolliert, sodass Sie sehen, welcher der folgenden Fälle eingetreten ist:
- Keine Antwort innerhalb von 20 Sekunden: Der Schritt schlägt mit „Webhook did not answer“ fehl, nichts wird gesendet, und der Lauf zeigt Failed.
- Ein Status außerhalb von 2xx, Weiterleitungen eingeschlossen: Der Schritt schlägt mit „Webhook answered HTTP“ und dem Code fehl.
- Eine 2xx-Antwort ohne Text im Feld `reply`: Der Lauf ist Done, der Schritt zeigt HTTP 200, keine Antwort, und der Kunde erhält keine automatische Nachricht.
- Ein fehlgeschlagener Lauf schickt Ihnen eine E-Mail, damit Sie diesem Kunden selbst antworten können, höchstens einmal pro Automatisierung alle 6 Stunden.
- Ein Chat, den Sie innerhalb der Pause (standardmäßig 4 Stunden, unter Advanced einstellbar) vom Telefon aus beantwortet haben, wird als `
human_active` übersprungen, bevor n8n aufgerufen wird. - Mehrere schnelle Nachrichten starten mehrere Läufe. Ein 1-minütiges Wait vor „Call my webhook“ führt zu nur einer Antwort, weil eine neuere Nachricht, die dieselbe Automatisierung auswählt, den wartenden Lauf ersetzt.
Wann sollte n8n stattdessen den Webhook von Meta direkt erhalten?
Wenn der Agent mehr als 20 Sekunden braucht, wenn der Workflow jedes Ereignis sehen muss (Status-Updates, Ihre Antworten vom Telefon, Medien-IDs), wenn er etwas sendet, das kein Schritt abdeckt, etwa einen Flow oder eine Katalognachricht, oder wenn das Unternehmen den Import des 6-Monats-Verlaufs möchte. Dieser Import geht nur an ein direktes Ziel, das innerhalb von 24 Stunden nach dem Verbinden gespeichert wurde. Der direkte Modus schaltet die Automatisierungen für die Nummer aus: Meta sendet seine eigene Payload direkt an n8n, und easyCoexistence sieht die Nachrichten nie.
In n8n verwenden Sie den einfachen Webhook-Node, nicht den WhatsApp-Trigger-Node, der Ihre eigene Meta-App und deren Geheimnis erwartet. Aktivieren Sie Allow Multiple HTTP Methods, damit ein langer, zufälliger Pfad sowohl den GET-Handshake von Meta als auch die POSTs annimmt. Beantworten Sie das GET mit dem unveränderten `hub.challenge` als Text und speichern Sie diese Production-URL mit einem Verify-Token über `set_webhook_destination`. Antworten gehen dann von einem HTTP-Anfrage-Node an den Send-Endpoint hinaus, und die Deduplizierung, die Telefonpause und die 24-Stunden-Prüfung liegen bei Ihnen.
| 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 |
So richten Sie es ein
- 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.
Häufige Fehler
- Die Option Respond im Webhook-Node auf Immediately zu lassen. n8n antwortet sofort mit Workflow got started, der Lauf protokolliert HTTP 200, keine Antwort, und der Kunde erhält nichts. Wählen Sie „Using 'Respond to Webhook' Node“.
- Die Test-URL mit /webhook-test/ einzufügen. Sie hört nur, während der Editor auf ein Testereignis wartet; Automatisierungen brauchen die Production-URL eines veröffentlichten Workflows.
- Die Prüfung mit dem Forward Secret der Nummer durchzuführen. Call my webhook wird mit dem eigenen Signing secret der Automatisierung signiert; das Forward Secret signiert nur weitergeleitete Ereignisse, daher schlagen echte Schritte die Prüfung fehl.
- Den Text in einer anderen Form zurückzugeben. Nur ein JSON-Body mit einem obersten String namens `reply` wird gesendet; {"output": "..."} oder ein Body als text/plain wird als keine Antwort protokolliert.
Der Schritt „Call my webhook“ übergibt die Nachricht des Kunden an n8n und sendet die Antwort zurück, mit eingebauter Deduplizierung, der Pause bei Antworten vom Telefon und der 24-Stunden-Prüfung, ohne Aufpreis pro Lauf. Von US$ 9 bis US$ 0.75 pro Nummer und Monat, sinkend mit jeder weiteren Nummer, die ersten 3 Tage sind kostenlos.
Häufig gestellte Fragen
Kann ChatGPT oder Claude diese Automatisierung für mich erstellen?
Ja. Fügen Sie den easyCoexistence-Connector hinzu und bitten Sie um eine Automatisierung auf Ihrer Nummer, die eingehende Nachrichten an Ihre n8n-URL sendet. Die KI ruft dann create_automation mit einem call_webhook-Schritt und anschließend test_automation auf. Bitten Sie sie, die Automatisierung deaktiviert anzulegen, bis der Test besteht. Das Signing secret wird über MCP nicht zurückgegeben; kopieren Sie es deshalb von der Seite der Automatisierung.
Kann der Workflow Bilder, Buttons oder Templates senden?
Nicht über das Feld reply, das nur Text transportiert. Lassen Sie stattdessen die Automatisierung das übernehmen: Schritte wie Send a picture or file, Ask a question with buttons und Send a template können vor oder nach Call my webhook stehen. Andere Nachrichtentypen senden Sie von einem HTTP-Anfrage-Node an die Cloud API, mit dem Send-Endpoint und dem Token, die get_api_credentials zurückgibt, und geben Sie keine reply zurück, damit der Kunde nicht doppelt antwortet.
Kann ein Workflow mehrere Nummern beantworten?
Ja. Richten Sie pro Nummer eine Automatisierung auf dieselbe Production-URL und verzweigen Sie anhand von channel.phone_number_id oder automation.id. Jede Automatisierung hat ein eigenes Signing secret, wählen Sie das Geheimnis daher über automation.id aus, bevor Sie die Signatur prüfen.
Funktioniert ein selbst gehostetes n8n?
Ja, wenn seine Production-URL öffentlich über HTTPS erreichbar ist. easyCoexistence lehnt http, localhost sowie private und interne Adressen ab, wenn Sie die URL speichern, und erneut vor jedem Aufruf, und folgt keinen Weiterleitungen.
Weiterlesen
Bereit für den Start?
Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.
Kostenlose Testphase startenVerifiziert am