WhatsApp AI agent sa n8n, isinulat ng inyong workflow ang sagot
Ipinapadala ng automation step ang mensahe ng customer, may signature at hanggang 10 kamakailang mensahe ng chat, sa isang n8n Webhook node sa pamamagitan ng POST. Sinusulat ng AI Agent node ang sagot, ibinabalik ito ng Respond to Webhook node bilang {"reply": "..."} sa loob ng 20 segundo, at ipinapadala ang tekstong iyon mula sa numerong WhatsApp Business, na patuloy na gumagana sa app. Ang mas mabagal na agent ay direktang tumatanggap ng webhook ng Meta at sumasagot sa pamamagitan ng Graph API.
Ikinokonekta ng easyCoexistence ang WhatsApp Business na numerong ginagamit na ninyo sa app sa Cloud API ng Meta sa pamamagitan ng Coexistence, at pinapatakbo rito ang mga automation.
Gaano katagal hihintayin ng hakbang na Call my webhook ang sagot ng workflow ninyo bago ito mabigo.
Pinakabagong mga mensahe ng chat na ipinapadala sa history, mula sa pinakalumang, nagtatapos sa mensaheng nagpasimula ng run.
Bilang ng karakter ng sagot na ipinapadala bilang isang WhatsApp text; ang sobra ay pinuputol.
Pinakamaikling pagitan ng dalawang email ng pagkabigo para sa parehong automation kapag pumalya ang webhook step.
Ano ang pinapayagan ng n8n Cloud sa Code node, crypto at moment; ang self-hosted n8n ay nagpapagana ng crypto gamit ang NODE_FUNCTION_ALLOW_BUILTIN.
Bintana ng customer service pagkatapos ng huling mensahe ng customer; pagkatapos nito, tumatanggap lang ang Meta ng template na mensahe.
Paano nakakarating ang mensahe ng WhatsApp sa AI agent sa n8n?
Sa pamamagitan ng automation sa numero. Dapat tumatanggap ang numero ng mga mensahe nito sa pamamagitan ng easyCoexistence (ang mode na “Through easyCoexistence”), kaya dito ito inihahatid ng Meta. Ang automation na may trigger na tumatanggap ng mensahe at step na Call my webhook ay nagpo-POST ng mensahe sa inyong n8n Production URL. Sinasagot ng workflow sa parehong HTTP response, at ang tekstong ibinalik nito ay ipinapadala sa customer bilang WhatsApp text mula sa inyong numero.
Bago tawagin ang n8n, nakadaan na sa mga guard ang run. Hindi nagsisimula ng panibagong run ang delivery na inulit ng Meta, humihinto ang automation sa chat na iyon kapag may sagot na tinype ninyo sa app (4 na oras bilang default), at lalabas lang ang sagot sa loob ng 24 na oras mula sa huling mensahe ng customer. Ang workflow ninyo ang nagpapasya lamang kung ano ang sasabihin.
Ano ang ipinapadala ng easyCoexistence sa n8n Webhook node?
Isang JSON POST na may User-Agent easyCoexistence-automations/1, X-EC-Event na naka-set sa automation.step, at header na X-EC-Signature. Hawak ng `message` ang teksto ng customer, o placeholder gaya ng [image] na may caption para sa media; dumarating ang voice note bilang [voice message] na sinusundan ng mga salita nito kapag may naka-save na OpenAI o OpenRouter key. Hawak ng `history` ang hanggang 10 kamakailang mensahe ng chat, mula sa pinakalumang, bawat isa may direction: in para sa customer, out para sa sagot ng automation, at echo para sa taong sumusulat mula sa telepono. Saklaw nito ang mga mensaheng itinatago sa loob ng retention period ng account (30, 90 o 365 araw, 90 bilang default), at ang mga dumating lamang habang dumaraan sa easyCoexistence ang mga mensahe ng numero.
Ang test mula sa Try it panel ng editor ay nagpapadala ng parehong POST na may dry_run na naka-set sa true, walang laman na history, ang sample contact na 15550000000 na may pangalang Test customer, at isang id ng mensahe na nagsisimula sa test_. Walang ipinapadala kahit kanino, pero tunay na tumatakbo ang workflow ninyo, kaya laktawan ang side effects gaya ng paggawa ng order kapag true ang dry_run.
{
"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" }
]
}Paano i-verify ang signature sa n8n?
Maglagay ng Code node pagkatapos ng Webhook node. Ang X-EC-Signature ay may anyong t=<unix seconds>,v1=<hex>, kung saan ang v1 ay HMAC-SHA256 ng t, isang tuldok, at ng body, na ginagamitan ng Signing secret ng automation. Para kopyahin ito, buksan ang naka-save na automation at piliin ang step na Call my webhook. Magkakaiba ang secret ng bawat automation, at hindi ibinabalik ng MCP tools ang mga ito, kaya kailangan pa rin ng automation na ginawa ng inyong AI ang isang kopyang ito mula sa dashboard. Pinapalitan ito ng button na New secret at agad humihinto sa paggana ang luma, at ang may-ari lang ng account ang makakakita nito, hindi ang inimbitahang miyembro ng team.
Tanggihan ang t na lampas 5 minuto mula sa orasan ninyo, ihambing sa constant time, at mag-throw kapag pumalya: magkakaroon ng error ang workflow bago ang Respond to Webhook, sasagot ang n8n ng 500 at walang ipapadala. Pinapayagan ng n8n Cloud ang crypto module sa Code nodes; ang self-hosted n8n ay kailangan ng NODE_FUNCTION_ALLOW_BUILTIN=crypto. Gumagana rin ang Hmac action ng Crypto node kasama ang IF node, bagaman hindi constant-time ang paghahambing ng IF.
// 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...Paano i-set up ang AI Agent node at ang sagot?
Ibigay sa AI Agent node ang teksto ng customer bilang user input nito, at ilagay ang lahat ng iba pa sa system message nito: sino ang negosyo, ang mga katotohanang maaari nitong banggitin, ang tono, at ang kamakailang chat mula sa history para may saysay ang follow-up na tanong. Ikabit ang chat model na gusto ninyo, kasama ang mga tool gaya ng HTTP Request tool na tumitingin ng order.
Tapusin ang workflow sa Respond to Webhook node na sumasagot ng JSON at inilalagay ang teksto ng agent sa field na pinangalanang reply. Pinuputol ng easyCoexistence ang sagot, binabalewala ang walang laman o hindi string na sagot, at ipinapadala ang natitira bilang isang WhatsApp text na hanggang 4,096 na karakter, kaya humingi sa model ng simpleng pangungusap, hindi 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() }} }Ano ang mangyayari kapag mabagal, pumalya o walang ibinalik ang workflow?
Bawat resulta ay naka-log sa Runs tab ng automation na may output o error ng step, kaya makikita ninyo kung alin sa mga ito ang nangyari:
- Walang sagot sa loob ng 20 segundo: papalya ang step na may Webhook did not answer, walang ipapadala, at ipapakitang Failed ang run.
- Status na labas sa 2xx, kasama ang redirect: papalya ang step na may Webhook answered HTTP at ang code.
- 2xx na walang reply string: Done ang run, ipinapakita ng step ang HTTP 200, walang reply, at walang awtomatikong sagot na matatanggap ang customer.
- Nagpapadala sa inyo ng email ang pumalyang run para masagot ninyo nang personal ang customer na iyon, isang beses lamang bawat automation kada 6 na oras.
- Ang chat na sinagot ninyo mula sa telepono sa loob ng pause (4 na oras bilang default, itinakda sa ilalim ng Advanced) ay nilalaktawan bilang
human_activebago tawagin ang n8n. - Ilang mabilisang mensahe ang nagsisimula ng ilang run. Ang 1-minute Wait bago ang Call my webhook ay sumasagot nang minsan, dahil ang mas bagong mensahe na pumipili sa parehong automation ay pumapalit sa naghihintay na run.
Kailan dapat direktang tanggapin ng n8n ang webhook ng Meta?
Kapag mas matagal sa 20 segundo ang kailangan ng agent, kapag dapat makita ng workflow ang bawat event (statuses, mga sagot ninyo mula sa telepono, media ids), kapag nagpapadala ito ng bagay na hindi saklaw ng anumang step, gaya ng Flow o catalog message, o kapag gustong ng negosyo ang 6-buwang history import, na sa direktang destinasyon lang napupunta at dapat naka-save sa loob ng 24 na oras mula sa pagkonekta. Ang direct mode ay nagpapatay ng automations para sa numero: direktang ipinapadala ng Meta ang sarili nitong payload sa n8n at hindi kailanman nakikita ng easyCoexistence ang mga mensahe.
Sa n8n, gamitin ang karaniwang Webhook node, hindi ang WhatsApp Trigger node, na nangangailangan ng sarili ninyong Meta app at secret nito. I-on ang Allow Multiple HTTP Methods para iisang mahabang random na path ang tumanggap ng GET handshake ng Meta at ng mga POST, sagutin ang GET ng hilaw na hub.challenge bilang text, at i-save ang Production URL na iyon kasama ang verify token sa pamamagitan ng set_webhook_destination. Ang mga sagot ay ipinapadala mula sa HTTP Request node papunta sa send endpoint, at ang dedupe, ang phone pause, at ang 24-hour check ay magiging inyong responsibilidad.
| 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 |
Paano ito i-set up
- 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.
Mga karaniwang pagkakamali
- Pag-iwan sa opsyon na Respond ng Webhook node sa Immediately. Sumasagot ang n8n ng Workflow got started kaagad, naglo-log ang run ng HTTP 200, walang sagot, at walang natatanggap ang customer. Piliin ang Using 'Respond to Webhook' Node.
- Pagkopya ng Test URL, ang may /webhook-test/. Nakikinig lang ito habang naghihintay ang editor ng test event; kailangan ng automation ang Production URL ng isang na-publish na workflow.
- Pag-verify gamit ang forward secret ng numero. Naka-sign ang Call my webhook ng sariling Signing secret ng automation; ang forward secret ay para lang sa mga forwarded event, kaya papalya ang tunay na step sa pagsusuri.
- Pagbabalik ng sagot sa ibang hugis. Ang tanging tinatanggap ay JSON body na may top-level na string na pinangalanang reply; ang {"output": "..."} o text/plain body ay naka-log bilang no reply.
Ipinapasa ng step nitong Call my webhook ang mensahe ng customer sa n8n at ibinabalik ang sagot, kasama na ang dedupe, ang pause kapag sumasagot kayo mula sa telepono, at ang 24-oras na pagsusuri, nang walang dagdag na singil kada run. Mula US$ 9 kada naka-connect na numero kada buwan, bumababa hanggang US$ 0.75 habang dumarami ang mga numero, na may unang 3 araw na libre.
Mga madalas itanong
Maaari bang gumawa ng automation na ito para sa akin ang ChatGPT o Claude?
Oo. Kapag naidagdag na ang easyCoexistence connector, humiling ng automation sa numero na nagpapadala ng mga papasok na mensahe sa inyong n8n URL. Tatawagin ng AI ang create_automation na may call_webhook step, pagkatapos ay test_automation. Hilingin na gawing disabled ang automation hanggang pumasa ang test. Hindi ibinabalik ng MCP ang Signing secret, kaya kopyahin ito mula sa pahina ng automation.
Maaari bang magpadala ng larawan, buttons o templates ang workflow?
Hindi sa pamamagitan ng reply field, na text lang ang dala. Hayaan na lang ang automation ang gumawa nito: ang mga step gaya ng Send a picture or file, Ask a question with buttons at Send a template ay maaaring ilagay bago o pagkatapos ng Call my webhook. Para sa ibang uri ng mensahe, ipadala ang mga ito mula sa HTTP Request node papunta sa Cloud API, gamit ang send endpoint at token na ibinabalik ng get_api_credentials, at huwag magbalik ng reply para hindi makatanggap ang customer ng dalawang sagot.
Maaari bang sagutin ng iisang workflow ang ilang numero?
Oo. Ituro ang isang automation bawat numero sa parehong Production URL at mag-branch sa channel.phone_number_id o automation.id. May sariling Signing secret ang bawat automation, kaya piliin ang secret ayon sa automation.id bago i-verify ang signature.
Gumagana ba ang self-hosted na n8n?
Oo, basta pampubliko ang Production URL nito sa HTTPS. Tinatanggihan ng easyCoexistence ang http, localhost, private at internal na address kapag sine-save ang URL at muli bago ang bawat tawag, at hindi ito sumusunod sa redirect.
Magpatuloy sa pagbabasa
Handa na po ba kayong magsimula?
I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.
Magsimula ng Libreng TrialNa-verify noong