n8n में WhatsApp AI एजेंट, जवाब आपका वर्कफ़्लो लिखता है
एक ऑटोमेशन स्टेप ग्राहक का मैसेज, साइन के साथ और चैट के हाल के 10 मैसेज तक, n8n के वेबहुक नोड को POST करता है। AI Agent नोड जवाब लिखता है, Respond to वेबहुक नोड 20 सेकंड के भीतर {"reply": "..."} लौटाता है, और वह टेक्स्ट आपके WhatsApp Business नंबर से भेजा जाता है, जो ऐप में चलता रहता है। धीमे एजेंट सीधे Meta का वेबहुक पाते हैं और Graph एपीआई से जवाब देते हैं।
easyCoexistence आपके ऐप में पहले से इस्तेमाल हो रहे WhatsApp Business नंबर को Coexistence के ज़रिए Meta के Cloud एपीआई से जोड़ता है और उस पर ऑटोमेशन चलाता है।
आपके वर्कफ़्लो का जवाब आने तक Call my वेबहुक स्टेप कितनी देर इंतज़ार करता है, उसके बाद स्टेप विफल हो जाता है।
चैट के हाल के मैसेज, जो history में भेजे जाते हैं, सबसे पुराने से शुरू होकर उस मैसेज पर खत्म होते हैं जिसने रन शुरू किया।
एक WhatsApp टेक्स्ट के रूप में भेजे जाने वाले जवाब के अक्षर; इससे लंबा जवाब काट दिया जाता है।
जब वेबहुक स्टेप विफल हो, तो एक ही ऑटोमेशन के दो विफलता ईमेल के बीच सबसे कम अंतराल।
n8n Cloud में Code नोड क्या अनुमति देता है: crypto और moment; self-hosted n8n में crypto NODE_FUNCTION_ALLOW_BUILTIN से चालू होता है।
ग्राहक के आखिरी मैसेज के बाद कस्टमर सर्विस विंडो; उसके बाद Meta केवल टेम्पलेट मैसेज स्वीकार करता है।
WhatsApp मैसेज n8n AI एजेंट तक कैसे पहुँचता है?
नंबर पर एक ऑटोमेशन के ज़रिए। नंबर को अपने मैसेज easyCoexistence के ज़रिए मिलने चाहिए (“Through easyCoexistence” मोड), ताकि Meta उन्हें यहाँ पहुँचाए। जिस ऑटोमेशन का ट्रिगर A message arrives हो और स्टेप Call my वेबहुक हो, वह मैसेज को आपके n8n Production यूआरएल पर POST करता है। वर्कफ़्लो उसी HTTP जवाब में उत्तर देता है, और लौटाया गया टेक्स्ट आपके नंबर से WhatsApp मैसेज के रूप में ग्राहक तक जाता है।
n8n को कॉल करने से पहले रन ज़रूरी जाँचों से गुज़र चुका होता है। Meta जो डिलीवरी दोहराता है, उससे दूसरा रन शुरू नहीं होता, ऐप में आपका लिखा जवाब उस चैट पर ऑटोमेशन को रोक देता है (डिफ़ॉल्ट रूप से 4 घंटे), और जवाब केवल ग्राहक के आखिरी मैसेज के 24 घंटे के भीतर जाता है। आपका वर्कफ़्लो केवल तय करता है कि क्या कहना है।
easyCoexistence n8n के वेबहुक नोड को क्या भेजता है?
एक JSON POST, जिसमें User-Agent easyCoexistence-automations/1 होता है, X-EC-Event का मान automation.step होता है, और एक X-EC-Signature हेडर होता है। message में ग्राहक का टेक्स्ट होता है, या मीडिया के लिए कैप्शन के साथ [image] जैसा प्लेसहोल्डर; वॉइस नोट [voice message] के रूप में आता है, और OpenAI या OpenRouter की कुंजी सेव हो तो उसके बाद उसके शब्द। history में चैट के हाल के 10 मैसेज होते हैं, सबसे पुराना पहले, हर एक के साथ direction: ग्राहक के लिए in, ऑटोमेशन के जवाब के लिए out, और फ़ोन से लिखने वाले व्यक्ति के लिए echo। यह उन मैसेज को कवर करती है जो खाते की रिटेंशन अवधि (30, 90 या 365 दिन, डिफ़ॉल्ट 90) तक रखे जाते हैं, और केवल वे जो तब आए जब नंबर के मैसेज easyCoexistence के ज़रिए आ रहे थे।
एडिटर के Try it पैनल से किया गया टेस्ट वही POST भेजता है, जिसमें dry_run true होता है, history खाली होती है, सैंपल कॉन्टैक्ट 15550000000 का नाम Test customer होता है, और मैसेज आईडी test_ से शुरू होती है। किसी को कुछ नहीं भेजा जाता, पर आपका वर्कफ़्लो सच में चलता है, इसलिए जब dry_run 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" }
]
}n8n में सिग्नेचर कैसे जाँचें?
वेबहुक नोड के ठीक बाद एक Code नोड जोड़ें। X-EC-Signature का रूप t=<unix seconds>,v1=<hex> होता है, जहाँ v1, t, एक डॉट और बॉडी का HMAC-SHA256 है, जिसकी key ऑटोमेशन का Signing secret है। इसे कॉपी करने के लिए सेव किया गया ऑटोमेशन खोलें और उसका Call my वेबहुक स्टेप चुनें। हर ऑटोमेशन का अपना सीक्रेट होता है, और MCP टूल इसे कभी नहीं लौटाते, इसलिए आपके AI के बनाए ऑटोमेशन के लिए भी डैशबोर्ड से एक बार इसे कॉपी करना पड़ता है। New secret बटन उसे बदल देता है और पुराना तुरंत काम करना बंद कर देता है, और उसे केवल खाते का मालिक देख सकता है, आमंत्रित टीम सदस्य नहीं।
जिस t का अंतर आपकी घड़ी से 5 मिनट से ज़्यादा हो, उसे अस्वीकार करें, constant-time तुलना करें, और विफल होने पर throw करें: तब वर्कफ़्लो Respond to वेबहुक से पहले ही गड़बड़ी देता है, n8n 500 लौटाता है और कुछ नहीं भेजा जाता। n8n Cloud Code नोड में crypto मॉड्यूल की अनुमति देता है; self-hosted n8n को NODE_FUNCTION_ALLOW_BUILTIN=crypto चाहिए। Crypto नोड का Hmac एक्शन IF नोड के साथ भी काम करता है, हालाँकि IF तुलना constant-time नहीं होती।
// 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 नोड और जवाब कैसे सेट करें?
AI Agent नोड को ग्राहक का टेक्स्ट उसके यूज़र मैसेज के रूप में दें, और बाकी सब उसके सिस्टम मैसेज में: कारोबार कौन है, वह कौन से तथ्य बता सकता है, लहजा कैसा हो, और history से हाल की चैट, ताकि फ़ॉलो-अप सवाल का मतलब समझ आए। अपनी पसंद का चैट मॉडल जोड़ें, साथ में टूल भी, जैसे HTTP Request टूल जो कोई ऑर्डर खोजे।
अंत में एक Respond to वेबहुक नोड रखें जो JSON में जवाब दे और एजेंट का टेक्स्ट reply नाम के फ़ील्ड में रखे। easyCoexistence उसे ट्रिम करता है, खाली या स्ट्रिंग न होने वाला reply अनदेखा करता है, और बाकी को 4,096 अक्षरों तक के एक WhatsApp टेक्स्ट के रूप में भेजता है, इसलिए मॉडल से मार्कडाउन के बजाय सादे वाक्य माँगें।
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() }} }जब वर्कफ़्लो धीमा हो, विफल हो या कुछ न लौटाए तो क्या होता है?
हर नतीजा ऑटोमेशन के Runs टैब में स्टेप के आउटपुट या गड़बड़ी के साथ दर्ज होता है, ताकि आप देख सकें इनमें से क्या हुआ:
- 20 सेकंड में जवाब नहीं: स्टेप Webhook did not answer के साथ विफल होता है, कुछ नहीं भेजा जाता और रन Failed दिखता है।
- 2xx से बाहर का कोई स्टेटस, रीडायरेक्ट भी शामिल: स्टेप Webhook answered HTTP और कोड के साथ विफल होता है।
- reply स्ट्रिंग के बिना 2xx: रन Done होता है, स्टेप HTTP 200, no reply दिखाता है, और ग्राहक को कोई ऑटोमैटिक जवाब नहीं मिलता।
- विफल रन आपको ईमेल भेजता है ताकि आप उस ग्राहक को खुद जवाब दे सकें, प्रति ऑटोमेशन हर 6 घंटे में अधिकतम एक बार।
- जिस चैट का आपने फ़ोन से विराम की अवधि (डिफ़ॉल्ट 4 घंटे, Advanced में सेट होती है) के भीतर जवाब दिया, उसे n8n को कॉल करने से पहले
human_activeके रूप में छोड़ दिया जाता है। - कई जल्दी-जल्दी आए मैसेज कई रन शुरू करते हैं। Call my वेबहुक से पहले 1 मिनट का Wait एक ही जवाब देता है, क्योंकि वही ऑटोमेशन चुनने वाला नया मैसेज इंतज़ार कर रहे रन की जगह ले लेता है।
Meta का वेबहुक सीधे n8n को कब मिलना चाहिए?
जब एजेंट को 20 सेकंड से ज़्यादा चाहिए, जब वर्कफ़्लो को हर इवेंट देखना हो (स्टेटस, आपके फ़ोन से दिए जवाब, मीडिया आईडी), जब वह ऐसा कुछ भेजता हो जिसे कोई स्टेप कवर नहीं करता, जैसे Flow या कैटलॉग मैसेज, या जब कारोबार 6 महीने का history इंपोर्ट चाहता हो, जो केवल कनेक्ट होने के 24 घंटे के भीतर सेव किए गए सीधे वेबहुक डेस्टिनेशन पर जाता है। डायरेक्ट मोड नंबर के लिए ऑटोमेशन बंद कर देता है: Meta अपना पेलोड सीधे n8n को भेजता है और easyCoexistence मैसेज कभी नहीं देखता।
n8n में सादा वेबहुक नोड इस्तेमाल करें, WhatsApp Trigger नोड नहीं, जो आपका अपना Meta ऐप और उसका सीक्रेट माँगता है। Allow Multiple HTTP Methods चालू करें ताकि एक लंबा रैंडम पाथ Meta का GET हैंडशेक और POST दोनों ले, GET का जवाब कच्चे hub.challenge के साथ टेक्स्ट के रूप में दें, और वह Production यूआरएल एक वेरिफ़ाई टोकन के साथ set_webhook_destination से सेव करें। इसके बाद जवाब HTTP Request नोड से सेंड एंडपॉइंट पर जाते हैं, और डुप्लिकेट हटाना, फ़ोन से जवाब देने पर विराम और 24 घंटे की जाँच आपकी ज़िम्मेदारी बन जाती है।
| 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 |
कैसे कॉन्फ़िगर करें
- 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.
आम गड़बड़ियाँ
- वेबहुक नोड का Respond विकल्प Immediately पर छोड़ देना। n8n तुरंत Workflow got started लौटा देता है, रन HTTP 200, no reply दर्ज करता है, और ग्राहक को कुछ नहीं मिलता। Using 'Respond to वेबहुक' Node चुनें।
- Test यूआरएल चिपकाना, यानी जिसमें /webhook-test/ होता है। वह केवल तब सुनता है जब एडिटर टेस्ट इवेंट का इंतज़ार कर रहा हो; ऑटोमेशन को पब्लिश किए गए वर्कफ़्लो का Production यूआरएल चाहिए।
- नंबर के forward secret से पुष्टि करना। Call my वेबहुक ऑटोमेशन के अपने Signing secret से साइन होता है; forward secret केवल फ़ॉरवर्ड किए गए इवेंट साइन करता है, इसलिए असली स्टेप जाँच में विफल हो जाते हैं।
- टेक्स्ट को किसी और रूप में लौटाना। केवल वह JSON बॉडी भेजी जाती है जिसमें reply नाम की टॉप-लेवल स्ट्रिंग हो; {"output": "..."} या text/plain बॉडी को no reply दर्ज किया जाता है।
इसका Call my वेबहुक स्टेप ग्राहक का मैसेज n8n को देता है और जवाब वापस भेजता है, जिसमें डुप्लिकेट हटाना, फ़ोन से जवाब देने पर विराम और 24 घंटे की जाँच पहले से शामिल हैं, और प्रति रन कोई अतिरिक्त शुल्क नहीं है। प्रति नंबर प्रति माह US$ 9 से घटकर US$ 0.75, जैसे-जैसे नंबर बढ़ते हैं, और पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या ChatGPT या Claude यह ऑटोमेशन मेरे लिए बना सकते हैं?
हाँ। easyCoexistence कनेक्टर जोड़ने के बाद, अपने नंबर पर ऐसा ऑटोमेशन माँगें जो आने वाले मैसेज आपके n8n यूआरएल पर भेजे; AI call_webhook स्टेप के साथ create_automation कॉल करता है, फिर test_automation। उससे कहें कि टेस्ट पास होने तक ऑटोमेशन disabled रखे। Signing secret MCP के ज़रिए वापस नहीं आता, इसलिए उसे ऑटोमेशन के पेज से कॉपी करें।
क्या वर्कफ़्लो इमेज, बटन या टेम्पलेट भेज सकता है?
reply फ़ील्ड से नहीं, जो केवल टेक्स्ट ले जाता है। इसके बजाय ऑटोमेशन से करवाएँ: Send a picture or file, Ask a question with buttons और Send a template जैसे स्टेप Call my वेबहुक से पहले या बाद में रखे जा सकते हैं। दूसरे तरह के मैसेज के लिए, उन्हें HTTP Request नोड से Cloud एपीआई पर भेजें, उस सेंड एंडपॉइंट और टोकन के साथ जो get_api_credentials लौटाता है, और कोई reply न लौटाएँ ताकि ग्राहक को दो बार जवाब न मिले।
क्या एक वर्कफ़्लो कई नंबरों को जवाब दे सकता है?
हाँ। हर नंबर के लिए एक ऑटोमेशन बनाकर सबको उसी Production यूआरएल पर पॉइंट करें और channel.phone_number_id या automation.id पर ब्रांच करें। हर ऑटोमेशन का अपना Signing secret होता है, इसलिए सिग्नेचर जाँचने से पहले automation.id से सीक्रेट चुनें।
क्या self-hosted n8n काम करता है?
हाँ, अगर उसका Production यूआरएल सार्वजनिक HTTPS हो। easyCoexistence यूआरएल सेव करते समय, और हर कॉल से पहले फिर से, http, localhost, निजी और आंतरिक पतों को अस्वीकार करता है, और रीडायरेक्ट को फ़ॉलो नहीं करता।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित