MasukMulai uji coba gratis
Meta Tech Provider

Agen AI WhatsApp di n8n, dengan balasan ditulis oleh workflow Anda

Sebuah langkah otomasi mengirim POST berisi pesan pelanggan, bertanda tangan dan disertai hingga 10 pesan terbaru dari chat, ke node Webhook n8n. Node AI Agent menulis jawaban, node Respond to Webhook mengembalikan {"reply": "..."} dalam 20 detik, dan teks itu dikirim dari nomor WhatsApp Business, yang tetap berfungsi di aplikasi. Agen yang lebih lambat menerima webhook Meta secara langsung dan membalas melalui Graph API.

easyCoexistence menghubungkan nomor WhatsApp Business yang sudah Anda pakai di aplikasi ke Cloud API Meta melalui Coexistence dan menjalankan otomasi di atasnya.

20 s

Berapa lama langkah Call my webhook menunggu jawaban workflow Anda sebelum langkah itu gagal.

10

Pesan terbaru dari chat yang dikirim dalam history, dari yang paling lama, diakhiri dengan pesan yang memulai run.

4,096

Jumlah karakter balasan yang dikirim sebagai satu teks WhatsApp; apa pun yang lebih panjang akan dipotong.

6 hours

Jeda minimum antara dua email kegagalan untuk otomasi yang sama saat langkah webhook gagal.

2 modules

Yang diizinkan n8n Cloud di node Code, yaitu crypto dan moment; n8n self-hosted mengaktifkan crypto dengan NODE_FUNCTION_ALLOW_BUILTIN.

24 hours

Jendela layanan pelanggan setelah pesan terakhir pelanggan; setelah itu, Meta hanya menerima pesan template.

Bagaimana pesan WhatsApp sampai ke agen AI n8n?

Melalui otomasi pada nomor. Nomor harus menerima pesannya melalui easyCoexistence (mode Through easyCoexistence), agar Meta mengirimnya ke sini; otomasi yang pemicunya pesan masuk dan langkahnya Call my webhook kemudian mengirim POST pesan ke Production URL n8n Anda. Workflow menjawab dalam respons HTTP yang sama, dan teks yang dikembalikan dikirim ke pelanggan sebagai pesan WhatsApp dari nomor Anda.

Sebelum n8n dipanggil, run sudah melewati pengaman. Pengiriman yang diulang Meta tidak pernah memulai run kedua, balasan yang Anda ketik di aplikasi menjeda otomasi pada chat itu (4 jam secara default), dan balasan hanya dikirim dalam 24 jam sejak pesan terakhir pelanggan. Workflow Anda hanya menentukan isi balasannya.

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

Apa yang dikirim easyCoexistence ke node Webhook n8n?

POST JSON dengan User-Agent easyCoexistence-automations/1, X-EC-Event berisi automation.step dan header X-EC-Signature. `message` berisi teks pelanggan, atau placeholder seperti [image] dengan keterangannya untuk media; pesan suara tiba sebagai [voice message] diikuti isinya jika kunci OpenAI atau OpenRouter tersimpan. `history` berisi hingga 10 pesan terbaru dari chat, dari yang paling lama, masing-masing dengan `direction`: `in` untuk pelanggan, `out` untuk balasan otomasi, dan `echo` untuk orang yang menulis dari ponsel. Mencakup pesan yang disimpan selama masa retensi akun (30, 90, atau 365 hari, 90 secara default), dan hanya pesan yang masuk saat pesan nomor itu datang melalui easyCoexistence.

Uji dari panel Try it di editor mengirim POST yang sama dengan dry_run bernilai true, history kosong, kontak contoh 15550000000 bernama Test customer, dan id pesan yang diawali test_. Tidak ada pesan yang dikirim ke siapa pun, tetapi workflow Anda benar-benar berjalan, jadi lewati efek samping seperti membuat pesanan saat dry_run bernilai 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" }
  ]
}

Bagaimana cara memeriksa tanda tangan di n8n?

Tambahkan node Code tepat setelah node Webhook. X-EC-Signature berbentuk t=<unix seconds>,v1=<hex>, dengan v1 adalah HMAC-SHA256 dari t, titik, dan body, dengan kunci berupa Signing secret milik otomasi. Untuk menyalinnya, buka otomasi yang sudah disimpan dan pilih langkah Call my webhook-nya. Setiap otomasi memiliki secret sendiri, dan tool MCP tidak pernah mengembalikannya, jadi otomasi yang dibuat AI Anda tetap memerlukan satu salinan ini dari dashboard. Tombol New secret menggantinya dan yang lama langsung berhenti berfungsi, dan hanya pemilik akun yang bisa melihatnya, bukan anggota tim yang diundang.

Tolak t yang selisihnya lebih dari 5 menit dari jam Anda, bandingkan dengan waktu konstan, dan lempar kesalahan jika gagal: workflow kemudian gagal sebelum Respond to Webhook, n8n menjawab 500, dan tidak ada yang dikirim. n8n Cloud mengizinkan modul crypto di node Code; n8n self-hosted memerlukan NODE_FUNCTION_ALLOW_BUILTIN=crypto. Aksi Hmac pada node Crypto dengan node IF juga bisa, meski perbandingan IF tidak berjalan dalam waktu konstan.

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...

Bagaimana cara mengatur node AI Agent dan balasannya?

Berikan teks pelanggan ke node AI Agent sebagai pesan pengguna, dan semua hal lain di pesan sistem: siapa bisnisnya, fakta yang boleh dikutip, nada bicara, serta chat terbaru dari history agar pertanyaan lanjutan masuk akal. Pasang model chat yang Anda inginkan, ditambah tool seperti HTTP Request tool yang mencari pesanan.

Akhiri dengan node Respond to Webhook yang merespons dengan JSON dan menaruh teks agen di field bernama reply. easyCoexistence memangkas teks itu, mengabaikan balasan kosong atau bukan string, dan mengirim sisanya sebagai satu teks WhatsApp hingga 4,096 karakter, jadi minta model menulis kalimat biasa, bukan 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() }} }

Apa yang terjadi jika workflow lambat, gagal, atau tidak mengembalikan apa pun?

Setiap hasil dicatat di tab Runs otomasi dengan output atau kesalahan langkahnya, sehingga Anda bisa melihat yang mana dari hal berikut yang terjadi:

  • Tidak ada jawaban dalam 20 detik: langkah gagal dengan Webhook did not answer, tidak ada yang dikirim, dan run ditampilkan sebagai Failed.
  • Status di luar 2xx, termasuk redirect: langkah gagal dengan Webhook answered HTTP dan kodenya.
  • Respons 2xx tanpa string balasan: run berstatus Done, langkah menampilkan HTTP 200, no reply, dan pelanggan tidak menerima balasan otomatis.
  • Run yang gagal mengirim email kepada Anda agar Anda bisa membalas pelanggan itu sendiri, paling banyak sekali per otomasi setiap 6 jam.
  • Chat yang Anda balas dari ponsel dalam jeda (4 jam secara default, diatur di Advanced) dilewati sebagai human_active sebelum n8n dipanggil.
  • Beberapa pesan cepat memulai beberapa run. Node Wait 1 menit sebelum Call my webhook membuat hanya satu jawaban, karena pesan baru yang memilih otomasi yang sama menggantikan run yang sedang menunggu.

Kapan n8n sebaiknya menerima webhook Meta secara langsung?

Saat agen membutuhkan lebih dari 20 detik, saat workflow harus melihat setiap event (status, balasan dari ponsel Anda, id media), saat mengirim sesuatu yang tidak tercakup langkah mana pun, seperti Flow atau pesan katalog, atau saat bisnis menginginkan impor riwayat 6 bulan, yang hanya dikirim ke tujuan langsung yang disimpan dalam 24 jam setelah koneksi dibuat. Mode langsung mematikan otomasi untuk nomor itu: Meta mengirim payload-nya sendiri langsung ke n8n dan easyCoexistence tidak pernah melihat pesannya.

Di n8n, gunakan node Webhook biasa, bukan node WhatsApp Trigger, yang memerlukan aplikasi Meta sendiri dan secret-nya. Aktifkan Allow Multiple HTTP Methods agar satu path acak panjang menerima handshake GET dari Meta dan POST, jawab GET dengan hub.challenge mentah sebagai teks, lalu simpan Production URL itu dengan verify token melalui set_webhook_destination. Balasan kemudian dikirim dari node HTTP Request ke endpoint pengiriman, dan dedupe, jeda dari ponsel, serta pemeriksaan 24 jam menjadi tanggung jawab Anda.

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

Cara mengonfigurasi

  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.

Kesalahan umum

  • Membiarkan opsi Respond di node Webhook pada Immediately. n8n langsung menjawab Workflow got started, run mencatat HTTP 200, no reply, dan pelanggan tidak menerima apa pun. Pilih Using 'Respond to Webhook' Node.
  • Menempelkan Test URL, yang berisi /webhook-test/. URL itu hanya mendengarkan saat editor menunggu event uji; otomasi membutuhkan Production URL dari workflow yang sudah dipublikasikan.
  • Memverifikasi dengan forward secret milik nomor. Call my webhook ditandatangani dengan Signing secret milik otomasi itu sendiri; forward secret hanya menandatangani event yang diteruskan, sehingga langkah asli gagal pemeriksaan.
  • Mengembalikan teks dalam bentuk lain. Hanya body JSON dengan string tingkat atas bernama reply yang dikirim; {"output": "..."} atau body text/plain dicatat sebagai no reply.
Melakukan ini dengan EasyCoexistence

Langkah Call my webhook menyerahkan pesan pelanggan ke n8n dan mengirim balasan kembali, dengan dedupe, jeda saat Anda membalas dari ponsel, serta pemeriksaan 24 jam sudah tersedia, tanpa biaya tambahan per run. US$ 9 turun ke US$ 0.75 per nomor per bulan, makin turun seiring penambahan nomor, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Bisakah ChatGPT atau Claude membuatkan otomasi ini untuk saya?

Bisa. Dengan konektor easyCoexistence sudah ditambahkan, minta otomasi di nomor Anda yang mengirim pesan masuk ke URL n8n Anda; AI akan memanggil create_automation dengan langkah call_webhook, lalu test_automation. Minta agar otomasi dibuat dalam keadaan nonaktif sampai uji lolos. Signing secret tidak dikembalikan melalui MCP, jadi salin dari halaman otomasi.

Bisakah workflow mengirim gambar, tombol, atau template?

Tidak melalui field balasan, yang hanya membawa teks. Serahkan pada otomasi: langkah seperti Send a picture or file, Ask a question with buttons, dan Send a template bisa berada sebelum atau sesudah Call my webhook. Untuk jenis pesan lain, kirimkan dari node HTTP Request ke Cloud API, dengan endpoint pengiriman dan token yang dikembalikan get_api_credentials, dan jangan kembalikan reply agar pelanggan tidak dibalas dua kali.

Bisakah satu workflow menjawab beberapa nomor?

Bisa. Arahkan satu otomasi per nomor ke Production URL yang sama dan cabangkan berdasarkan channel.phone_number_id atau automation.id. Setiap otomasi memiliki Signing secret sendiri, jadi pilih secret berdasarkan automation.id sebelum memeriksa tanda tangan.

Apakah n8n self-hosted bisa dipakai?

Bisa, asalkan Production URL-nya publik dengan HTTPS. easyCoexistence menolak alamat http, localhost, private, dan internal saat Anda menyimpan URL dan lagi sebelum setiap pemanggilan, serta tidak mengikuti redirect.

Lanjut membaca

Siap memulai?

Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.

Mulai uji coba gratis

Diverifikasi pada