Giriş yapınÜcretsiz denemeyi başlatın
Meta Tech Provider

n8n'de WhatsApp AI agent'ı: yanıtı iş akışınız yazar

Bir otomasyon adımı, müşterinin imzalı mesajını ve sohbetin en fazla 10 son mesajını bir n8n Webhook node'una POST eder. Bir AI Agent node yanıtı yazar, bir Respond to Webhook node 20 saniye içinde {"reply": "..."} döndürür ve bu metin, uygulamada çalışmaya devam eden WhatsApp Business numarasından gönderilir. Daha yavaş agent'lar Meta'nın webhook'unu doğrudan alır ve Graph API üzerinden yanıtlar.

easyCoexistence, zaten kullandığınız WhatsApp Business numarasını Coexistence üzerinden Meta'nın Cloud API'sine bağlar ve numarada otomasyonları çalıştırır.

20 s

Call my webhook adımının, iş akışınızın yanıtını beklediği süre; bu süre dolunca adım başarısız olur.

10

Geçmiş olarak gönderilen sohbetin en son mesajları, en eskisi önce, çalışmayı başlatan mesajla biten liste.

4,096

Tek bir WhatsApp metni olarak gönderilen yanıtın karakter sayısı; bundan uzun olan kısım kesilir.

6 hours

Bir webhook adımı başarısız olduğunda, aynı otomasyon için iki hata e-postası arasındaki en kısa süre.

2 modules

n8n Cloud'un bir Code node'unda izin verdikleri: crypto ve moment. Kendi sunucunuzdaki n8n, crypto'yu NODE_FUNCTION_ALLOW_BUILTIN ile etkinleştirir.

24 hours

Müşterinin son mesajından sonra müşteri hizmet penceresi; bu süre dolduktan sonra Meta yalnızca şablon mesajlarını kabul eder.

Bir WhatsApp mesajı n8n AI agent'ına nasıl ulaşır?

Numara üzerindeki bir otomasyon aracılığıyla. Numara mesajlarını easyCoexistence üzerinden almalıdır ("Through easyCoexistence" modu); böylece Meta bunları buraya iletir. Tetikleyicisi "A message arrives" ve adımı "Call my webhook" olan bir otomasyon, mesajı n8n Production URL'sine POST eder. İş akışı aynı HTTP yanıtında cevap verir ve döndürdüğü metin, numaranızdan müşteriye bir WhatsApp mesajı olarak gider.

n8n çağrılmadan önce çalıştırma zaten korumalardan geçmiştir. Meta'nın tekrar gönderdiği bir teslimat asla ikinci bir çalışma başlatmaz; uygulamadan yazdığınız bir yanıt o sohbetteki otomasyonu duraklatır (varsayılan 4 saat) ve yanıt yalnızca müşterinin son mesajından itibaren 24 saat içinde gider. İş akışınız yalnızca ne söyleneceğine karar verir.

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

easyCoexistence n8n Webhook node'una ne gönderir?

Bir JSON POST; User-Agent easyCoexistence-automations/1, X-EC-Event değeri automation.step ve bir X-EC-Signature başlığı. message, müşterinin metnini tutar; medya için [image] gibi bir yer tutucu (altyazısıyla birlikte) gelir; bir OpenAI ya da OpenRouter anahtarı kayıtlıysa sesli not [voice message] ve ardından sözcükleri olarak gelir. history, sohbetin en fazla 10 son mesajını içerir; en eskisi önce, her birinde bir direction bulunur: müşteri için in, bir otomasyonun yanıtı için out ve kişinin telefondan yazdığı mesaj için echo. Hesabın saklama süresi boyunca tutulan mesajları kapsar (30, 90 ya da 365 gün, varsayılan 90) ve yalnızca numaranın mesajları easyCoexistence üzerinden gelirken ulaşanları içerir.

Editörün Try it panelinden yapılan bir test aynı POST'u gönderir; ancak dry_run değeri true olur, history boş olur, örnek kişi 15550000000 ile Test customer adıyla gelir ve mesaj kimliği test_ ile başlar. Kimseye bir şey gönderilmez; ama iş akışınız gerçekten çalışır, bu yüzden dry_run true olduğunda sipariş oluşturma gibi yan etkileri atlayın.

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" }
  ]
}

n8n'de imzayı nasıl doğrularsınız?

Webhook node'unun hemen ardına bir Code node ekleyin. X-EC-Signature değeri t=<unix seconds>,v1=<hex> biçimindedir; burada v1, t'nin, bir noktanın ve gövdenin (body) HMAC-SHA256 değeridir ve otomasyonun Signing secret değeriyle anahtarlanır. Bunu kopyalamak için kayıtlı otomasyonu açın ve Call my webhook adımını seçin. Her otomasyonun kendi sırrı vardır ve MCP araçları bunu asla döndürmez; bu yüzden AI'nın oluşturduğu bir otomasyon da panelden bu tek kopyaya ihtiyaç duyar. New secret düğmesi onu değiştirir ve eskisi hemen çalışmayı bırakır; ayrıca onu yalnızca hesap sahibi görebilir, davet edilen bir ekip üyesi göremez.

t değeri saatinizden 5 dakikadan fazla uzaktaysa reddedin, karşılaştırmayı sabit sürede yapın ve başarısızlıkta hata fırlatın: iş akışı Respond to Webhook'tan önce hata verir, n8n 500 yanıtı döner ve hiçbir şey gönderilmez. n8n Cloud, Code node'larında crypto modülüne izin verir; kendi sunucunuzdaki n8n ise NODE_FUNCTION_ALLOW_BUILTIN=crypto gerektirir. Bir IF node ile birlikte Crypto node'unun Hmac işlemi de çalışır, ancak bir IF karşılaştırması sabit süreli değildir.

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

AI Agent node'unu ve yanıtı nasıl kurarsınız?

AI Agent node'una müşterinin metnini kullanıcı mesajı olarak verin; geri kalan her şeyi sistem mesajına yazın: işletmenin ne olduğu, alıntılayabileceği bilgiler, ton ve bir takip sorusunun anlamlı olması için history'deki son sohbet. İstediğiniz sohbet modelini ekleyin; bir siparişi sorgulayan bir HTTP Request aracı gibi araçları da ekleyebilirsiniz.

Sonunda, JSON ile yanıt veren ve agent'ın metnini reply adlı bir alana koyan bir Respond to Webhook node'u bulunsun. easyCoexistence yanıtı kırpar, boş ya da metin olmayan bir reply değerini yok sayar ve geri kalanı 4.096 karakterlik tek bir WhatsApp metni olarak gönderir; bu yüzden modelden markdown yerine düz cümleler isteyin.

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() }} }

İş akışı yavaş kalır, başarısız olur ya da boş dönerse ne olur?

Her sonuç, otomasyonun Runs sekmesinde adımın çıktısı ya da hatasıyla birlikte kaydedilir; böylece bunlardan hangisinin olduğunu görebilirsiniz:

  • 20 saniye içinde yanıt yoksa: adım Webhook did not answer hatasıyla başarısız olur, hiçbir şey gönderilmez ve çalıştırma Failed olarak görünür.
  • 2xx dışında bir durum kodu (yönlendirmeler dahil): adım, Webhook answered HTTP ve kodu ile başarısız olur.
  • Yanıt metni içermeyen bir 2xx: çalıştırma Done olur, adım HTTP 200 gösterir, reply yoktur ve müşteriye otomatik bir yanıt gitmez.
  • Başarısız bir çalıştırma size e-posta gönderir; böylece o müşteriyi kendiniz yanıtlayabilirsiniz. Bu e-posta en fazla her 6 saatte bir, otomasyon başına bir kez gelir.
  • Telefondan yanıt verdiğiniz bir sohbet, duraklatma süresi içinde (varsayılan 4 saat, Advanced altında ayarlanır) n8n çağrılmadan önce human_active nedeniyle atlanır.
  • Birkaç hızlı mesaj birkaç çalıştırma başlatır. Call my webhook'tan önce eklenen 1 dakikalık bir Wait, bekleyen çalıştırmayı aynı otomasyonu seçen daha yeni bir mesaj geçersiz kıldığı için yanıtı tek seferde verir.

Bunun yerine n8n Meta'nın webhook'unu doğrudan ne zaman almalı?

Agent'ın 20 saniyeden fazla süreye ihtiyaç duyduğunda, iş akışının her olayı görmesi gerektiğinde (durumlar, telefondan yanıtlarınız, medya kimlikleri), hiçbir adımın kapsamadığı bir şey, örneğin bir Flow ya da katalog mesajı gönderdiğinde ya da işletme 6 aylık geçmiş içe aktarmasını istediğinde. Bu geçmiş aktarması yalnızca bağlandıktan sonra 24 saat içinde kaydedilmiş doğrudan bir hedefe gider. Doğrudan mod, numara için otomasyonları kapatır: Meta kendi payload'unu doğrudan n8n'e gönderir ve easyCoexistence mesajları asla görmez.

n8n'de, kendi Meta uygulamanızı ve sırrını bekleyen WhatsApp Trigger node'unu değil, düz Webhook node'unu kullanın. Allow Multiple HTTP Methods seçeneğini açın; böylece uzun ve rastgele tek bir yol hem Meta'nın GET doğrulamasını hem de POST'ları alır. GET isteğine hub.challenge değerini ham metin olarak yanıtlayın ve bu Production URL'yi bir doğrulama token'ı ile set_webhook_destination üzerinden kaydedin. Yanıtlar bundan sonra gönderme uç noktasına bir HTTP Request node'u ile gider; tekrarların elenmesi (dedupe), telefon duraklatması ve 24 saatlik kontrol artık sizin sorumluluğunuzda olur.

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

Nasıl kurulur

  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.

Yaygın hatalar

  • Webhook node'unun Respond seçeneğini Immediately'de bırakmak. n8n hemen Workflow got started yanıtını verir, çalıştırma HTTP 200 kaydeder, reply yoktur ve müşteri hiçbir şey almaz. Using 'Respond to Webhook' Node seçeneğini seçin.
  • Test URL'yi, yani /webhook-test/ içereni yapıştırmak. Bu yalnızca editör bir test olayı beklerken dinler; otomasyonlar yayımlanmış bir iş akışının Production URL'sini ister.
  • İmzayı numaranın forward secret'ı ile doğrulamak. Call my webhook, otomasyonun kendi Signing secret değeriyle imzalanır; forward secret yalnızca iletilen olayları imzalar, bu yüzden gerçek adımlar kontrolden geçemez.
  • Metni başka bir biçimde döndürmek. Yalnızca en üst düzeyde reply adlı bir metin içeren JSON gövdesi gönderilir; {"output": "..."} ya da text/plain gövdesi, reply yok olarak kaydedilir.
Bunu EasyCoexistence'la yapmak

Call my webhook adımı, müşterinin mesajını n8n'e iletir ve yanıtı geri gönderir; dedupe, uygulamadan yanıt verdiğinizde duraklatma ve 24 saatlik kontrol yerleşik olarak gelir ve çalıştırma başına ek ücret yoktur. Numara başına aylık US$ 9'dan US$ 0,75'e kadar, numara ekledikçe düşer; ilk 3 gün ücretsizdir.

Sık sorulan sorular

ChatGPT ya da Claude bu otomasyonu benim yerime oluşturabilir mi?

Evet. easyCoexistence connector'ı eklendikten sonra, numaranızda gelen mesajları n8n URL'nize gönderen bir otomasyon isteyin; AI, create_automation ile bir call_webhook adımı oluşturur, ardından test_automation çağırır. Testi geçene kadar otomasyonun devre dışı oluşturulmasını isteyin. Signing secret MCP üzerinden döndürülmez; bu yüzden sırrı otomasyonun sayfasından kopyalayın.

İş akışı görsel, düğme ya da şablon gönderebilir mi?

Yanıt alanı üzerinden hayır; o alan yalnızca metin taşır. Bunu bunun yerine otomasyona yaptırın: Send a picture or file, Ask a question with buttons ve Send a template gibi adımlar Call my webhook'tan önce ya da sonra yer alabilir. Diğer mesaj türlerini, get_api_credentials'ın döndürdüğü gönderme uç noktası ve token ile bir HTTP Request node'undan Cloud API'ye gönderin ve müşteri iki kez yanıtlanmasın diye reply döndürmeyin.

Bir iş akışı birden fazla numaraya yanıt verebilir mi?

Evet. Her numara için bir otomasyonu aynı Production URL'ye yönlendirin ve channel.phone_number_id ya da automation.id'ye göre dallanın. Her otomasyonun kendi Signing secret değeri vardır; bu yüzden imzayı kontrol etmeden önce secret'ı automation.id'ye göre seçin.

Kendi sunucunuzda barındırılan n8n çalışır mı?

Evet, Production URL'si herkese açık HTTPS ise. easyCoexistence, URL'yi kaydederken ve her çağrıdan önce http, localhost, özel ve dahili adresleri reddeder; yönlendirmeleri de takip etmez.

Okumaya devam edin

Başlamaya hazır mısınız?

WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.

Ücretsiz denemeyi başlatın

Doğrulama tarihi