Conectați-văÎncepeți perioada de probă gratuită
Meta Tech Provider

Agent AI pentru WhatsApp în n8n, cu răspunsul scris de workflow-ul dumneavoastră

Un pas de automatizare trimite un POST cu mesajul clientului, semnat și cu până la 10 mesaje recente din conversație, către un nod Webhook din n8n. Nodul AI Agent scrie răspunsul, nodul Respond to Webhook returnează {"reply": "..."} în 20 de secunde, iar acest text este trimis de pe numărul WhatsApp Business, care continuă să funcționeze în aplicație. Agenții mai lenți primesc direct webhook-ul Meta și răspund prin Graph API.

easyCoexistence conectează numărul WhatsApp Business pe care îl folosiți deja în aplicație la Cloud API prin Coexistence și rulează pe el automatizări.

20 s

Cât timp așteaptă pasul Call my webhook răspunsul fluxului dumneavoastră, înainte ca pasul să eșueze.

10

Cele mai recente mesaje ale conversației, trimise în history, de la cel mai vechi la cel mai recent, terminând cu mesajul care a pornit rularea.

4,096

Caractere dintr-un răspuns trimis ca un singur mesaj text WhatsApp; ce depășește această limită este tăiat.

6 hours

Cel mai scurt interval între două e-mailuri de eroare pentru aceeași automatizare, când un pas webhook eșuează.

2 modules

Ce permite n8n Cloud într-un nod Code, crypto și moment; n8n self-hosted activează crypto cu NODE_FUNCTION_ALLOW_BUILTIN.

24 hours

Fereastra de serviciu pentru clienți după ultimul mesaj al clientului; după aceasta, Meta acceptă doar mesaje șablon.

Cum ajunge un mesaj WhatsApp la un agent AI n8n?

Printr-o automatizare pe număr. Numărul trebuie să primească mesajele prin easyCoexistence (modul „Through easyCoexistence”), ca Meta să le livreze aici; o automatizare al cărei declanșator este A message arrives și al cărui pas este Call my webhook trimite apoi POST mesajul către URL-ul Production al n8n. Fluxul răspunde în același răspuns HTTP, iar textul returnat ajunge la client ca mesaj WhatsApp de pe numărul dumneavoastră.

Înainte ca n8n să fie apelat, rularea a trecut deja de verificări. O livrare repetată de Meta nu pornește o a doua rulare, un răspuns scris de dumneavoastră în aplicație pune automatizarea pe pauză pentru conversația respectivă (4 ore implicit), iar răspunsul pleacă doar în 24 de ore de la ultimul mesaj al clientului. Fluxul dumneavoastră decide doar ce să spună.

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

Ce trimite easyCoexistence nodului Webhook din n8n?

Un POST JSON cu User-Agent easyCoexistence-automations/1, X-EC-Event setat la automation.step și un antet X-EC-Signature. message conține textul clientului sau un substituent precum [image] cu legenda pentru media; o notă vocală sosește ca [voice message] urmat de cuvintele ei, când este salvată o cheie OpenAI sau OpenRouter. history conține până la 10 mesaje recente ale conversației, de la cel mai vechi la cel mai nou, fiecare cu o direcție: in pentru client, out pentru răspunsul unei automatizări și echo pentru o persoană care scrie de pe telefon. Acoperă mesajele păstrate pe perioada de retenție a contului (30, 90 sau 365 de zile, implicit 90) și doar pe cele care au sosit cât timp mesajele numărului treceau prin easyCoexistence.

Un test din panoul Try it al editorului trimite același POST cu dry_run setat la true, un history gol, contactul de probă 15550000000 numit Test customer și un id de mesaj care începe cu test_. Nu se trimite nimic nimănui, dar fluxul dumneavoastră rulează efectiv, așa că ocoliți efectele secundare, precum crearea de comenzi, când dry_run este 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" }
  ]
}

Cum verificați semnătura în n8n?

Adăugați un nod Code imediat după nodul Webhook. X-EC-Signature are forma t=<unix seconds>,v1=<hex>, unde v1 este un HMAC-SHA256 al lui t, al unui punct și al corpului, cheiat cu Signing secret al automatizării. Pentru a-l copia, deschideți automatizarea salvată și selectați pasul Call my webhook. Fiecare automatizare are propriul secret, iar instrumentele MCP nu îl returnează niciodată, așa că o automatizare creată de AI are nevoie totuși de această copiere unică din panou. Un buton New secret îl înlocuiește, iar cel vechi nu mai funcționează imediat, și doar proprietarul contului îl poate vedea, nu un membru invitat al echipei.

Respingeți un t cu mai mult de 5 minute diferență față de ceasul dumneavoastră, comparați în timp constant și aruncați o eroare la eșec: fluxul se oprește atunci înainte de Respond to Webhook, n8n răspunde cu 500 și nu se trimite nimic. n8n Cloud permite modulul crypto în nodurile Code; n8n self-hosted are nevoie de NODE_FUNCTION_ALLOW_BUILTIN=crypto. Acțiunea Hmac a nodului Crypto împreună cu un nod IF funcționează și ea, deși comparația într-un IF nu este în timp 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...

Cum configurați nodul AI Agent și răspunsul?

Dați nodului AI Agent textul clientului ca mesaj de utilizator și restul în mesajul de sistem: cine este afacerea, faptele pe care le poate cita, tonul și conversația recentă din history, pentru ca o întrebare de continuare să aibă sens. Atașați modelul de chat dorit, plus unelte precum o unealtă HTTP Request care caută o comandă.

Finalizați cu un nod Respond to Webhook care răspunde în JSON și pune textul agentului într-un câmp numit reply. easyCoexistence taie spațiile, ignoră un reply gol sau care nu este șir de caractere și trimite restul ca un singur mesaj text WhatsApp de până la 4.096 de caractere, așa că cereți modelului propoziții simple, nu 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() }} }

Ce se întâmplă când fluxul este lent, eșuează sau nu returnează nimic?

Fiecare rezultat este înregistrat în fila Runs a automatizării, cu ieșirea sau eroarea pasului, astfel încât să vedeți care dintre acestea s-a întâmplat:

  • Niciun răspuns în 20 de secunde: pasul eșuează cu Webhook did not answer, nu se trimite nimic, iar rularea apare ca Failed.
  • Un cod de stare în afara intervalului 2xx, inclusiv redirecționările: pasul eșuează cu Webhook answered HTTP și codul.
  • Un 2xx fără un șir de caractere reply: rularea este Done, pasul arată HTTP 200, fără reply, iar clientul nu primește nimic automat.
  • O rulare eșuată vă trimite un e-mail ca să puteți răspunde dumneavoastră acelui client, cel mult o dată la 6 ore pentru fiecare automatizare.
  • O conversație la care ați răspuns de pe telefon în timpul pauzei (4 ore implicit, setată în Advanced) este omisă ca human_active înainte ca n8n să fie apelat.
  • Mai multe mesaje rapide pornesc mai multe rulări. Un Wait de 1 minut înainte de Call my webhook răspunde o singură dată, deoarece un mesaj mai nou care alege aceeași automatizare înlocuiește rularea în așteptare.

Când ar trebui să primească n8n direct webhook-ul Meta?

Când agentul are nevoie de mai mult de 20 de secunde, când fluxul trebuie să vadă fiecare eveniment (statusurile, răspunsurile dumneavoastră de pe telefon, id-urile media), când trimite ceva ce niciun pas nu acoperă, precum un Flow sau un mesaj de catalog, ori când firma dorește importul istoricului de 6 luni, care merge doar către o destinație directă salvată în 24 de ore de la conectare. Modul direct oprește automatizările pentru număr: Meta trimite direct către n8n payload-ul său, iar easyCoexistence nu mai vede mesajele.

În n8n, folosiți nodul Webhook simplu, nu nodul WhatsApp Trigger, care așteaptă propria aplicație Meta și secretul ei. Activați Allow Multiple HTTP Methods, ca o cale lungă și aleatoare să preia atât handshake-ul GET al Meta, cât și POST-urile, răspundeți la GET cu hub.challenge brut, ca text, și salvați acel URL Production cu un verify token prin set_webhook_destination. Răspunsurile pleacă apoi dintr-un nod HTTP Request către endpoint-ul de trimitere, iar deduplicarea, pauza de pe telefon și verificarea de 24 de ore devin ale dumneavoastră.

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

Cum să îl configurați

  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.

Greșeli frecvente

  • Lăsarea opțiunii Respond din nodul Webhook pe Immediately. n8n răspunde imediat Workflow got started, rularea înregistrează HTTP 200, fără reply, iar clientul nu primește nimic. Alegeți Using 'Respond to Webhook' Node.
  • Folosirea URL-ului Test, cel cu /webhook-test/. Acesta ascultă doar cât timp editorul așteaptă un eveniment de test; automatizările au nevoie de URL-ul Production al unui flux publicat.
  • Verificarea cu secretul de redirecționare al numărului. Call my webhook este semnat cu propriul Signing secret al automatizării; secretul de redirecționare semnează doar evenimentele redirecționate, așa că pașii autentici eșuează la verificare.
  • Returnarea textului într-o altă formă. Se trimite doar un corp JSON cu un șir de caractere de nivel superior numit reply; {"output": "..."} sau un corp text/plain este înregistrat ca no reply.
Faceți acest lucru cu EasyCoexistence

Pasul său Call my webhook trimite mesajul clientului către n8n și returnează răspunsul, cu deduplicare, pauză când răspundeți de pe telefon și verificare de 24 de ore incluse, fără taxă suplimentară pentru fiecare rulare. De la US$ 9 până la US$ 0,75 per număr pe lună, scăzând pe măsură ce adăugați numere, cu primele 3 zile gratuite.

Întrebări frecvente

Pot ChatGPT sau Claude să creeze automatizarea pentru mine?

Da. Cu conectorul easyCoexistence adăugat, cereți o automatizare pe numărul dumneavoastră care trimite mesajele primite către URL-ul n8n; AI-ul apelează create_automation cu un pas call_webhook, apoi test_automation. Cereți să fie creată dezactivată până trece testul. Signing secret nu este returnat prin MCP, așa că copiați-l de pe pagina automatizării.

Poate fluxul să trimită imagini, butoane sau șabloane?

Nu prin câmpul reply, care transportă doar text. Lăsați în schimb automatizarea să o facă: pași precum Send a picture or file, Ask a question with buttons și Send a template pot sta înainte sau după Call my webhook. Pentru alte tipuri de mesaje, trimiteți-le dintr-un nod HTTP Request către Cloud API, cu endpoint-ul de trimitere și token-ul pe care le returnează get_api_credentials, și nu returnați niciun reply, ca clientul să nu primească două răspunsuri.

Poate un singur flux să răspundă mai multor numere?

Da. Legați câte o automatizare pentru fiecare număr de același URL Production și ramificați după channel.phone_number_id sau automation.id. Fiecare automatizare are propriul Signing secret, așa că alegeți secretul după automation.id înainte de a verifica semnătura.

Funcționează un n8n self-hosted?

Da, dacă URL-ul său Production este HTTPS public. easyCoexistence refuză adresele http, localhost, private și interne când salvați URL-ul și din nou înainte de fiecare apel, iar nu urmărește redirecționările.

Continuați să citiți

Gata să începeți?

Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.

Începeți perioada de probă gratuită

Verificat la