لاگ اِن کریںفری ٹرائل شروع کریں
Meta Tech Provider

n8n میں WhatsApp AI ایجنٹ، جواب آپ کا ورک فلو لکھے

ایک آٹومیشن قدم گاہک کا میسج، دستخط شدہ اور چیٹ کے حالیہ 10 میسجز تک کے ساتھ، n8n Webhook نوڈ کو POST کرتا ہے۔ AI Agent نوڈ جواب لکھتا ہے، Respond to Webhook نوڈ 20 سیکنڈ کے اندر {"reply": "..."} واپس کرتا ہے، اور وہ متن WhatsApp Business نمبر سے بھیجا جاتا ہے جو ایپ میں کام کرتا رہتا ہے۔ سست ایجنٹس Meta کا ویب ہک براہ راست وصول کرتے ہیں اور Graph API کے ذریعے جواب دیتے ہیں۔

easyCoexistence آپ کا موجودہ WhatsApp Business نمبر ایپ میں Coexistence کے ذریعے Meta کے Cloud API سے جوڑتا ہے اور اس پر آٹومیشنز چلاتا ہے۔

20 s

وہ مدت جو Call my webhook قدم آپ کے ورک فلو کے جواب کا انتظار کرتا ہے، اس کے بعد قدم ناکام ہو جاتا ہے۔

10

چیٹ کے حالیہ ترین میسجز جو history میں سب سے پرانے سے نئے کی ترتیب سے بھیجے جاتے ہیں، آخر میں وہ میسج ہوتا ہے جس نے رن شروع کیا۔

4,096

ایک WhatsApp ٹیکسٹ کے طور پر بھیجے جانے والے جواب کے حروف؛ اس سے لمبا حصہ کاٹ دیا جاتا ہے۔

6 hours

کسی آٹومیشن کے لیے دو ناکامی ای میلز کے درمیان کم سے کم وقفہ، جب ویب ہک قدم ناکام ہو۔

2 modules

n8n Cloud کے Code نوڈ میں اجازت: crypto اور moment؛ خود میزبانی والا n8n crypto کو NODE_FUNCTION_ALLOW_BUILTIN سے فعال کرتا ہے۔

24 hours

آخری گاہک میسج کے بعد کسٹمر سروس ونڈو؛ اس کے بعد Meta صرف ٹیمپلیٹ میسجز قبول کرتا ہے۔

WhatsApp میسج n8n AI ایجنٹ تک کیسے پہنچتا ہے؟

نمبر پر ایک آٹومیشن کے ذریعے۔ نمبر کو اپنے میسجز easyCoexistence کے ذریعے وصول کرنے چاہئیں (موڈ "Through easyCoexistence")، تاکہ Meta انہیں یہاں بھیجے؛ ایک آٹومیشن جس کا ٹرگر A message arrives ہو اور جس کا قدم Call my webhook ہو، میسج کو آپ کے n8n Production URL پر POST کرتا ہے۔ ورک فلو اسی HTTP جواب میں جواب دیتا ہے، اور وہ متن گاہک کو آپ کے نمبر سے WhatsApp میسج کے طور پر جاتا ہے۔

n8n کو کال کرنے سے پہلے رن پہلے ہی گارڈز سے گزر چکا ہوتا ہے۔ Meta کی دہرائی گئی ڈیلیوری سے دوسرا رن شروع نہیں ہوتا، ایپ میں آپ کا ٹائپ کیا ہوا جواب اس چیٹ پر آٹومیشن کو روکتا ہے (ڈیفالٹ 4 گھنٹے)، اور جواب صرف گاہک کے آخری میسج کے 24 گھنٹوں کے اندر جاتا ہے۔ آپ کا ورک فلو صرف یہ طے کرتا ہے کہ کیا کہنا ہے۔

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 نوڈ کو کیا بھیجتا ہے؟

JSON POST جس کا User-Agent easyCoexistence-automations/1 ہے، X-EC-Event کی قدر automation.step ہے، اور X-EC-Signature ہیڈر۔ message میں گاہک کا متن ہوتا ہے، یا میڈیا کے لیے [image] جیسا placeholder اور کیپشن؛ وائس نوٹ [voice message] کے طور پر آتا ہے، اور اس کے بعد اس کے الفاظ ہوتے ہیں جب OpenAI یا OpenRouter key محفوظ ہو۔ 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 ہو تو آرڈر بنانے جیسے سائیڈ ایفیکٹس چھوڑ دیں۔

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 میں دستخط کیسے چیک کریں؟

Webhook نوڈ کے فوراً بعد ایک Code نوڈ شامل کریں۔ X-EC-Signature کی شکل t=<unix seconds>,v1=<hex> ہوتی ہے، جہاں v1، t، ایک نقطہ اور باڈی کا HMAC-SHA256 ہے، جس کی کلید آٹومیشن کا Signing secret ہے۔ اسے نقل کرنے کے لیے محفوظ شدہ آٹومیشن کھولیں اور اس کا Call my webhook قدم منتخب کریں۔ ہر آٹومیشن کا اپنا خفیہ کلید ہوتا ہے، اور MCP ٹولز اسے کبھی واپس نہیں کرتے، اس لیے وہ آٹومیشن جو آپ کے AI نے بنائی ہو، پھر بھی ڈیش بورڈ سے یہ ایک بار نقل کرنے کی ضرورت رکھتی ہے۔ New secret بٹن اسے بدل دیتا ہے اور پرانا فوراً کام کرنا بند کر دیتا ہے، اور اسے صرف اکاؤنٹ کا مالک دیکھ سکتا ہے، مدعو کیا گیا ٹیم ممبر نہیں۔

اپنی گھڑی سے 5 منٹ سے زیادہ دور t کو مسترد کریں، موازنہ مستقل وقت (constant time) میں کریں، اور ناکامی پر throw کریں: تب ورک فلو Respond to Webhook سے پہلے خرابی دیتا ہے، n8n 500 جواب دیتا ہے اور کچھ نہیں بھیجا جاتا۔ n8n Cloud کے Code نوڈز میں crypto ماڈیول کی اجازت ہے؛ خود میزبانی والے n8n کو NODE_FUNCTION_ALLOW_BUILTIN=crypto درکار ہے۔ Crypto نوڈ کا Hmac عمل IF نوڈ کے ساتھ بھی کام کرتا ہے، البتہ IF کا موازنہ مستقل وقت میں نہیں ہوتا۔

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 نوڈ اور جواب کیسے ترتیب دیں؟

AI Agent نوڈ کو گاہک کا متن اس کے user message کے طور پر دیں، اور باقی سب کچھ system message میں: کاروبار کیا ہے، کون سے حقائق حوالہ دیے جا سکتے ہیں، لہجہ، اور history سے حالیہ چیٹ تاکہ فالو اپ سوال کا مطلب بنے۔ جو چیٹ ماڈل چاہیں منسلک کریں، اور ٹولز بھی، جیسے کسی آرڈر کو دیکھنے والا HTTP Request ٹول۔

آخر میں ایک Respond to Webhook نوڈ لگائیں جو JSON میں جواب دے اور ایجنٹ کا متن reply نام کے فیلڈ میں رکھے۔ easyCoexistence متن کی تراش کرتا ہے، خالی یا غیر string reply کو نظر انداز کرتا ہے، اور باقی کو 4,096 حروف تک کے ایک WhatsApp ٹیکسٹ کے طور پر بھیجتا ہے، اس لیے ماڈل سے سادہ جملے مانگیں، 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() }} }

جب ورک فلو سست ہو، ناکام ہو یا کچھ واپس نہ کرے تو کیا ہوتا ہے؟

ہر نتیجہ آٹومیشن کے Runs ٹیب میں قدم کے آؤٹ پٹ یا خرابی کے ساتھ درج ہوتا ہے، تاکہ آپ دیکھ سکیں کہ ان میں سے کیا ہوا:

  • 20 سیکنڈ میں جواب نہ ملے: قدم Webhook did not answer کے ساتھ ناکام ہوتا ہے، کچھ نہیں بھیجا جاتا اور رن Failed دکھاتا ہے۔
  • 2xx کے باہر کا status، redirects سمیت: قدم Webhook answered HTTP اور کوڈ کے ساتھ ناکام ہوتا ہے۔
  • 2xx جواب بغیر reply والے string کے: رن Done ہوتا ہے، قدم HTTP 200 دکھاتا ہے، کوئی reply نہیں، اور گاہک کو کچھ خودکار نہیں ملتا۔
  • ناکام رن آپ کو ای میل بھیجتا ہے تاکہ آپ اس گاہک کو خود جواب دے سکیں، ہر آٹومیشن کے لیے ہر 6 گھنٹے میں زیادہ سے زیادہ ایک بار۔
  • وہ چیٹ جس کا آپ نے وقفے (ڈیفالٹ 4 گھنٹے، Advanced کے تحت سیٹ) کے دوران فون سے جواب دیا ہو، n8n کو کال کرنے سے پہلے human_active کے طور پر چھوڑ دی جاتی ہے۔
  • کئی تیز میسجز کئی رن شروع کرتے ہیں۔ Call my webhook سے پہلے 1 منٹ کا Wait ایک بار جواب دیتا ہے، کیونکہ اسی آٹومیشن کو منتخب کرنے والا نیا میسج انتظار کرتے رن کو کالعدم کر دیتا ہے۔

Meta کا webhook براہ راست n8n کو کب بھیجا جائے؟

جب ایجنٹ کو 20 سیکنڈ سے زیادہ درکار ہو، جب ورک فلو ہر ایونٹ دیکھنا چاہے (اسٹیٹس، آپ کے فون کے جواب، میڈیا آئی ڈیز)، جب وہ ایسی چیز بھیجے جسے کوئی قدم نہیں سنبھالتا، جیسے Flow یا کیٹلاگ میسج، یا جب کاروبار 6 ماہ کی ہسٹری امپورٹ چاہے، جو صرف اس براہ راست منزل کو جاتی ہے جو کنیکٹ کرنے کے 24 گھنٹوں کے اندر محفوظ کی گئی ہو۔ ڈائریکٹ موڈ نمبر کے لیے آٹومیشنز بند کر دیتا ہے: Meta اپنا payload سیدھا n8n کو بھیجتا ہے اور easyCoexistence میسجز کو کبھی نہیں دیکھتا۔

n8n میں سادہ Webhook نوڈ استعمال کریں، WhatsApp Trigger نوڈ نہیں، جو آپ کی اپنی Meta ایپ اور اس کے سیکرٹ کی توقع کرتا ہے۔ Allow Multiple HTTP Methods فعال کریں تاکہ ایک لمبا بے ترتیب راستہ Meta کا GET ہینڈ شیک اور POST دونوں لے، GET کا جواب خام hub.challenge متن کے طور پر دیں، اور وہ Production URL set_webhook_destination کے ذریعے verify token کے ساتھ محفوظ کریں۔ پھر جواب ایک HTTP Request نوڈ سے send endpoint کو جاتے ہیں، اور dedupe، فون کا وقفہ اور 24 گھنٹے کی جانچ آپ کی ذمہ داری بن جاتی ہے۔

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

اسے کیسے سیٹ اپ کریں

  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.

عام غلطیاں

  • Webhook نوڈ کا Respond آپشن Immediately پر چھوڑ دینا۔ n8n فوراً Workflow got started جواب دیتا ہے، رن HTTP 200 لاگ کرتا ہے، کوئی جواب نہیں اور گاہک کو کچھ نہیں ملتا۔ Using 'Respond to Webhook' Node منتخب کریں۔
  • /webhook-test/ والا Test URL پیسٹ کرنا۔ وہ صرف تب سنتا ہے جب ایڈیٹر کسی ٹیسٹ ایونٹ کا انتظار کر رہا ہو؛ آٹومیشنز کو کسی شائع شدہ ورک فلو کا Production URL چاہیے۔
  • نمبر کے forward secret سے تصدیق کرنا۔ Call my webhook آٹومیشن کے اپنے Signing secret سے دستخط شدہ ہوتا ہے؛ forward secret صرف فارورڈ شدہ ایونٹس پر دستخط کرتا ہے، اس لیے اصلی قدم چیک میں ناکام ہو جاتے ہیں۔
  • متن کسی اور شکل میں واپس کرنا۔ صرف وہ JSON باڈی بھیجی جاتی ہے جس میں اوپری سطح پر reply نام کا string ہو؛ {"output": "..."} یا text/plain باڈی کو no reply کے طور پر لاگ کیا جاتا ہے۔
EasyCoexistence کے ساتھ یہ کام کرنا

اس کا Call my webhook قدم میسج n8n کو دیتا ہے اور جواب واپس لاتا ہے، جس میں ڈپلیکیٹ ہٹانا، فون کے جواب پر وقفہ اور 24 گھنٹے کی جانچ شامل ہیں، فی رن کوئی اضافی چارج نہیں۔ فی جڑے نمبر ماہانہ US$ 9 سے گھٹ کر US$ 0.75 تک، نمبر بڑھنے کے ساتھ کم ہوتی ہوئی، اور پہلے 3 دن فری ٹرائل میں۔

اکثر پوچھے جانے والے سوالات

کیا ChatGPT یا Claude میرے لیے یہ آٹومیشن بنا سکتے ہیں؟

ہاں۔ easyCoexistence کنیکٹر شامل کرنے کے بعد، اپنے نمبر پر ایسی آٹومیشن مانگیں جو آنے والے میسجز کو آپ کے n8n URL پر بھیجے؛ 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 webhook سے پہلے یا بعد میں آ سکتے ہیں۔ دوسری قسم کے میسجز کو ایک HTTP Request نوڈ سے Cloud API پر بھیجیں، send endpoint اور ٹوکن کے ساتھ جو get_api_credentials واپس کرتا ہے، اور کوئی reply واپس نہ کریں تاکہ گاہک کو دو بار جواب نہ ملے۔

کیا ایک ورک فلو کئی نمبروں کا جواب دے سکتا ہے؟

ہاں۔ ہر نمبر کی ایک آٹومیشن کو ایک ہی Production URL پر اشارہ کریں اور channel.phone_number_id یا automation.id پر شاخ بنائیں۔ ہر آٹومیشن کا اپنا Signing secret ہوتا ہے، اس لیے دستخط چیک کرنے سے پہلے automation.id سے secret منتخب کریں۔

کیا خود میزبانی والا n8n کام کرتا ہے؟

ہاں، اگر اس کا Production URL عوامی HTTPS ہو۔ easyCoexistence URL محفوظ کرتے وقت اور ہر کال سے پہلے http، localhost، نجی اور اندرونی پتے مسترد کرتا ہے، اور redirects کی پیروی نہیں کرتا۔

مزید پڑھیں

WhatsApp پیغام آپ کے سرور تک کیسے پہنچتے ہیں: ڈائریکٹ یا مینیج، اور دستخط کی تصدیقڈائریکٹ: Meta آپ کے سرور پر پوسٹ کرتا ہے۔ مینیج: آٹومیشنز جواب دیتی ہیں، اور دستخط شدہ کاپی Forward URL پر جاتی ہے۔ X-EC-Signature، پے لوڈ، دوبارہ کوششیں۔Coexistence نمبر پر Node.js اور Python میں WhatsApp AI ایجنٹ بنائیںCoexistence نمبر پر WhatsApp AI ایجنٹ کا Node.js اور Python کوڈ: دستخط کی تصدیق، انسانی جواب پر وقفہ، ڈپلیکیٹ چھوڑنا، 24 گھنٹے کی ونڈو چیک۔کاروبار کی قسم کے مطابق WhatsApp AI: ریسٹورنٹ، کلینک، سیلون اور اسٹور کے لیے تیار فلوریسٹورنٹ، کلینک، سیلون، آن لائن اسٹور، رئیل اسٹیٹ اور کورس بنانے والوں کے لیے WhatsApp کی تیار آٹومیشن: ٹریگر، مراحل، AI پرامپٹ اور فرد کو منتقلی۔WhatsApp آٹومیشن ریفرنس: ٹریگرز، مراحل، متغیرات اور حدودeasyCoexistence کے WhatsApp آٹومیشنز میں ہر ٹریگر، کی ورڈ موڈ، مرحلہ، فیلڈ، حد، ڈیفالٹ، متغیر اور ترجیح، create_automation اسکیما سمیت۔WhatsApp کو official Cloud API پر n8n سے کنیکٹ کریںMeta کے official Cloud API سے WhatsApp میسجز n8n ورک فلو میں بھیجیں، جبکہ نمبر فون پر چلتا رہے۔ کوئی linked device نہیں۔MCP یا ویب ہک: آپ کو اصل میں کس کی ضرورت ہےMCP بلانے پر کام کرتا ہے، ویب ہک واقعہ ہوتے ہی ردعمل دیتا ہے۔ جانیں اسسٹنٹ خود صارفین کو جواب کیوں نہیں دے سکتا اور دونوں کیوں درکار ہیں۔

شروع کرنے کے لیے تیار ہیں؟

WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔

فری ٹرائل شروع کریں

تصدیق شدہ تاریخ