Ejen AI WhatsApp dalam n8n, dengan balasan ditulis oleh aliran kerja anda
Satu langkah automasi menghantar (POST) mesej pelanggan, bertandatangan dan dengan sehingga 10 mesej terkini sembang, ke nod Webhook n8n. Nod AI Agent menulis jawapan, nod Respond to Webhook mengembalikan {"reply": "..."} dalam masa 20 saat, dan teks itu dihantar dari nombor WhatsApp Business, yang terus berfungsi dalam aplikasi. Ejen yang lebih perlahan menerima webhook Meta secara terus dan membalas melalui Graph API.
easyCoexistence menyambungkan nombor WhatsApp Business yang sudah anda guna dalam aplikasi kepada Cloud API Meta melalui Coexistence dan menjalankan automasi di atasnya.
Tempoh Call my webhook menunggu jawapan aliran kerja anda sebelum langkah itu gagal.
Mesej terkini sembang yang dihantar dalam history, paling lama dahulu, berakhir dengan mesej yang memulakan larian.
Aksara bagi balasan yang dihantar sebagai satu teks WhatsApp; apa-apa yang lebih panjang akan dipotong.
Jarak terpendek antara dua e-mel kegagalan untuk automasi yang sama apabila langkah webhook gagal.
Apa yang dibenarkan oleh n8n Cloud dalam nod Code: crypto dan moment; n8n yang dihoskan sendiri mengaktifkan crypto dengan NODE_FUNCTION_ALLOW_BUILTIN.
Tetingkap khidmat pelanggan selepas mesej terakhir pelanggan; selepas itu, Meta hanya menerima mesej template.
Bagaimana mesej WhatsApp sampai ke ejen AI n8n?
Melalui automasi pada nombor. Nombor mesti menerima mesejnya melalui easyCoexistence (mod "Through easyCoexistence"), supaya Meta menghantarnya ke sini. Automasi dengan pencetus A message arrives dan langkah Call my webhook kemudian menghantar POST mesej ke URL Production n8n anda. Aliran kerja menjawab dalam respons HTTP yang sama, dan teks yang dikembalikannya dihantar kepada pelanggan sebagai mesej WhatsApp dari nombor anda.
Sebelum n8n dipanggil, larian sudah melepasi semua pemeriksaan. Penghantaran yang diulang oleh Meta tidak memulakan larian kedua, balasan yang anda taip dalam aplikasi menjeda automasi pada sembang itu (4 jam secara lalai), dan balasan hanya dihantar dalam masa 24 jam dari mesej terakhir pelanggan. Aliran kerja anda hanya memutuskan apa yang hendak dikatakan.
Apakah yang dihantar easyCoexistence kepada nod Webhook n8n?
Satu POST JSON dengan User-Agent easyCoexistence-automations/1, X-EC-Event ditetapkan kepada automation.step dan header X-EC-Signature. message mengandungi teks pelanggan, atau tempat letak seperti [image] dengan kapsyen untuk media; nota suara tiba sebagai [voice message] diikuti kata-katanya apabila kunci OpenAI atau OpenRouter disimpan. history mengandungi sehingga 10 mesej terkini sembang, paling lama dahulu, setiap satu dengan direction: in untuk pelanggan, out untuk balasan automasi dan echo untuk orang yang menulis dari telefon. Ia meliputi mesej yang disimpan sepanjang tempoh pengekalan akaun (30, 90 atau 365 hari, 90 secara lalai), dan hanya yang tiba ketika mesej nombor itu melalui easyCoexistence.
Ujian dari panel Try it dalam editor menghantar POST yang sama dengan dry_run bernilai true, history kosong, kenalan contoh 15550000000 bernama Test customer dan id mesej yang bermula dengan test_. Tiada apa-apa dihantar kepada sesiapa, tetapi aliran kerja anda benar-benar berjalan, jadi langkau kesan sampingan seperti mencipta pesanan apabila dry_run bernilai true.
{
"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" }
]
}Bagaimana anda menyemak tandatangan dalam n8n?
Tambah nod Code betul-betul selepas nod Webhook. X-EC-Signature dibaca sebagai t=<unix seconds>,v1=<hex>, dengan v1 ialah HMAC-SHA256 bagi t, titik dan badan, dikunci dengan Signing secret automasi. Untuk menyalinnya, buka automasi yang disimpan dan pilih langkah Call my webhook. Setiap automasi mempunyai rahsia sendiri, dan alat MCP tidak pernah memulangkannya, jadi automasi yang dicipta oleh AI anda tetap memerlukan satu salinan ini dari dashboard. Butang New secret menggantikannya dan yang lama berhenti berfungsi serta-merta, dan hanya pemilik akaun boleh melihatnya, bukan ahli pasukan yang dijemput.
Tolak t yang lebih daripada 5 minit dari jam anda, bandingkan dalam masa tetap dan lontarkan ralat jika gagal: aliran kerja akan gagal sebelum Respond to Webhook, n8n menjawab 500 dan tiada apa dihantar. n8n Cloud membenarkan modul crypto dalam nod Code; n8n yang dihoskan sendiri memerlukan NODE_FUNCTION_ALLOW_BUILTIN=crypto. Tindakan Hmac nod Crypto bersama nod IF juga berfungsi, walaupun perbandingan IF tidak bermasa tetap.
// 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...Bagaimana anda menyediakan nod AI Agent dan balasan?
Berikan teks pelanggan kepada nod AI Agent sebagai mesej pengguna, dan segala yang lain dalam mesej sistemnya: siapa perniagaan itu, fakta yang boleh dipetiknya, nada, serta sembang terkini dari history supaya soalan susulan masuk akal. Sambungkan model sembang yang anda mahu, serta alat seperti HTTP Request yang mencari pesanan.
Tamatkan dengan nod Respond to Webhook yang membalas dengan JSON dan meletakkan teks ejen dalam medan bernama reply. easyCoexistence memangkas teks itu, mengabaikan balasan yang kosong atau bukan rentetan, dan menghantar selebihnya sebagai satu teks WhatsApp sehingga 4,096 aksara, jadi minta model menulis ayat biasa dan bukan 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() }} }Apa yang berlaku apabila aliran kerja lambat, gagal atau tidak memulangkan apa-apa?
Setiap hasil dilog dalam tab Runs automasi dengan output atau ralat langkah itu, supaya anda dapat melihat yang mana berlaku:
- Tiada jawapan dalam masa 20 saat: langkah gagal dengan Webhook did not answer, tiada apa dihantar dan larian menunjukkan Failed.
- Status di luar 2xx, termasuk ubah hala: langkah gagal dengan Webhook answered HTTP dan kodnya.
- 2xx tanpa rentetan balasan: larian ialah Done, langkah menunjukkan HTTP 200, tiada balasan, dan pelanggan tidak menerima apa-apa secara automatik.
- Larian yang gagal menghantar e-mel kepada anda supaya anda boleh menjawab pelanggan itu sendiri, paling banyak sekali bagi setiap automasi dalam tempoh 6 jam.
- Sembang yang anda jawab dari telefon dalam tempoh jeda (4 jam secara lalai, ditetapkan di bawah Advanced) dilangkau sebagai
human_activesebelum n8n dipanggil. - Beberapa mesej pantas memulakan beberapa larian. Wait 1 minit sebelum Call my webhook menjawab sekali sahaja, kerana mesej yang lebih baharu yang memilih automasi sama menggantikan larian yang sedang menunggu.
Bilakah n8n sebaliknya perlu menerima webhook Meta secara terus?
Apabila ejen memerlukan lebih 20 saat, apabila aliran kerja mesti melihat setiap peristiwa (status, balasan telefon anda, id media), apabila ia menghantar sesuatu yang tiada langkah meliputinya, seperti Flow atau mesej katalog, atau apabila perniagaan mahukan import sejarah 6 bulan, yang hanya pergi ke destinasi terus yang disimpan dalam masa 24 jam selepas menyambung. Mod terus mematikan automasi untuk nombor itu: Meta menghantar payloadnya sendiri terus ke n8n dan easyCoexistence tidak pernah melihat mesej itu.
Dalam n8n, gunakan nod Webhook biasa, bukan nod WhatsApp Trigger, yang memerlukan aplikasi Meta anda sendiri dan rahsianya. Hidupkan Allow Multiple HTTP Methods supaya satu laluan rawak yang panjang menerima jabat tangan GET Meta dan POST, jawab GET dengan hub.challenge mentah sebagai teks, dan simpan URL Production itu dengan verify token melalui set_webhook_destination. Balasan kemudian dihantar dari nod HTTP Request ke endpoint hantar, dan dedupe, jeda telefon serta semakan 24 jam menjadi tanggungjawab anda.
| 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 |
Cara menetapkannya
- 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.
Kesilapan biasa
- Membiarkan pilihan Respond pada nod Webhook sebagai Immediately. n8n menjawab Workflow got started serta-merta, larian melog HTTP 200, tiada balasan, dan pelanggan tidak menerima apa-apa. Pilih Using 'Respond to Webhook' Node.
- Menampal URL Test, yang mengandungi /webhook-test/. Ia hanya mendengar semasa editor menunggu peristiwa ujian; automasi memerlukan URL Production bagi aliran kerja yang diterbitkan.
- Mengesahkan dengan rahsia hadapan nombor. Call my webhook ditandatangani dengan Signing secret automasi itu sendiri; rahsia hadapan hanya menandatangani peristiwa yang dimajukan, jadi langkah yang sahih gagal semakan.
- Memulangkan teks dalam bentuk lain. Hanya badan JSON dengan rentetan peringkat atas bernama reply dihantar; {"output": "..."} atau badan text/plain dilog sebagai no reply.
Langkah Call my webhook menyerahkan mesej pelanggan kepada n8n dan menghantar balik balasan, dengan dedupe, jeda apabila anda menjawab dari telefon dan semakan 24 jam terbina dalam, tanpa caj tambahan bagi setiap larian. Dari US$ 9 turun kepada US$ 0.75 bagi setiap nombor yang disambungkan sebulan, menurun apabila anda menambah nombor, dengan percubaan percuma 3 hari.
Soalan lazim
Bolehkah ChatGPT atau Claude mencipta automasi ini untuk saya?
Boleh. Dengan penyambung easyCoexistence ditambah, minta automasi pada nombor anda yang menghantar mesej masuk ke URL n8n anda; AI memanggil create_automation dengan langkah call_webhook, kemudian test_automation. Minta ia mencipta automasi dalam keadaan dilumpuhkan sehingga ujian lulus. Signing secret tidak dipulangkan melalui MCP, jadi salinnya dari halaman automasi.
Bolehkah aliran kerja menghantar imej, butang atau template?
Tidak melalui medan balasan, yang hanya membawa teks. Biarkan automasi melakukannya: langkah seperti Send a picture or file, Ask a question with buttons dan Send a template boleh diletakkan sebelum atau selepas Call my webhook. Untuk jenis mesej lain, hantarkannya dari nod HTTP Request ke Cloud API, dengan endpoint hantar dan token yang dipulangkan oleh get_api_credentials, dan jangan pulangkan balasan supaya pelanggan tidak dijawab dua kali.
Bolehkah satu aliran kerja menjawab beberapa nombor?
Boleh. Hala satu automasi bagi setiap nombor ke URL Production yang sama dan cabangkan pada channel.phone_number_id atau automation.id. Setiap automasi mempunyai Signing secret sendiri, jadi pilih rahsia mengikut automation.id sebelum menyemak tandatangan.
Adakah n8n yang dihoskan sendiri berfungsi?
Berfungsi, jika URL Production-nya ialah HTTPS awam. easyCoexistence menolak http, localhost, alamat persendirian dan dalaman apabila anda menyimpan URL, dan sekali lagi sebelum setiap panggilan, dan ia tidak mengikut ubah hala.
Teruskan membaca
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaDisahkan pada