وكيل ذكاء اصطناعي على WhatsApp داخل n8n، يكتب سير عملك الرد بنفسه
تُرسل خطوة الأتمتة رسالة العميل موقّعةً، مع ما يصل إلى 10 رسائل حديثة من المحادثة، إلى عقدة Webhook في n8n. تكتب عقدة AI Agent الإجابة، وتعيد عقدة Respond to Webhook الرد بصيغة {"reply": "..."} خلال 20 ثانية، ويُرسل هذا النص من رقم WhatsApp Business الذي يبقى يعمل في التطبيق. أما الوكلاء الأبطأ فيتلقون خطاف الويب (webhook) من Meta مباشرة، ويردون عبر Graph API.
يربط easyCoexistence رقم WhatsApp Business الذي تستخدمه أصلاً في التطبيق بـ Cloud API من Meta عبر Coexistence، ويشغّل الأتمتة عليه.
المدة التي تنتظر فيها خطوة Call my webhook رد سير عملك قبل أن تفشل الخطوة.
أحدث رسائل المحادثة المرسلة في history، من الأقدم إلى الأحدث، وتنتهي بالرسالة التي بدأت التشغيل.
عدد أحرف الرد الذي يُرسل كرسالة WhatsApp نصية واحدة، وما يزيد عليه يُقتطع.
عند فشل خطوة webhook، أقصر فترة تفصل بين رسالتي بريد إلكتروني متتاليتين عن الأتمتة نفسها.
ما يسمح به n8n Cloud في عقدة Code من وحدتي crypto وmoment، وفي n8n المستضاف ذاتيًا تُفعَّل crypto عبر NODE_FUNCTION_ALLOW_BUILTIN.
نافذة خدمة العملاء بعد آخر رسالة من العميل، وبعدها تقبل Meta رسائل القوالب فقط.
كيف تصل رسالة WhatsApp إلى وكيل ذكاء اصطناعي في n8n؟
عبر أتمتة على الرقم. يجب أن يستقبل الرقم رسائله عبر easyCoexistence (وضع Through easyCoexistence)، فتسلّمها Meta إلى هنا؛ ثم تُرسل الأتمتة التي يكون مشغّلها A message arrives وخطوتها Call my webhook الرسالة بطريقة POST إلى عنوان Production URL في n8n. يجيب سير العمل ضمن استجابة HTTP نفسها، ويصل النص الذي يعيده إلى العميل كرسالة WhatsApp من رقمك.
قبل استدعاء n8n يكون التشغيل قد اجتاز ضوابطه. لا يبدأ تشغيلاً ثانياً أي تسليم تكرره Meta، ويوقف الرد الذي تكتبه من التطبيق الأتمتة على تلك المحادثة (4 ساعات افتراضياً)، ولا يُرسل الرد إلا خلال 24 ساعة من آخر رسالة للعميل. سير عملك يقرر ما يُقال فقط.
ماذا يرسل easyCoexistence إلى عقدة Webhook في n8n؟
طلب JSON من نوع POST مع User-Agent بقيمة easyCoexistence-automations/1، وX-EC-Event بقيمة automation.step، ورأس X-EC-Signature. يحمل الحقل message نص العميل، أو عنصراً نائباً مثل [image] مع التعليق للوسائط؛ وتصل الرسالة الصوتية على هيئة [voice message] تليها كلماتها عند حفظ مفتاح OpenAI أو OpenRouter. ويحمل الحقل history ما يصل إلى 10 رسائل حديثة من المحادثة، من الأقدم إلى الأحدث، ولكل منها اتجاه: in لرسائل العميل، وout لرد الأتمتة، وecho لشخص يكتب من الهاتف. ويغطي ذلك الرسائل المحفوظة خلال مدة الاحتفاظ بالحساب (30 أو 90 أو 365 يوماً، و90 افتراضياً)، وفقط تلك التي وصلت أثناء مرور رسائل الرقم عبر easyCoexistence.
يرسل الاختبار من لوحة Try it في المحرر الطلب نفسه مع 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 مباشرةً بعد عقدة Webhook. يحمل الرأس X-EC-Signature القيمة t=<unix seconds>,v1=<hex>، حيث v1 هو HMAC-SHA256 للقيمة t ونقطة ونص الطلب، مفتاحه السري Signing secret الخاص بالأتمتة. لنسخه، افتح الأتمتة المحفوظة واختر خطوة Call my webhook. لكل أتمتة سرّها الخاص، ولا تعيده أدوات MCP أبداً، لذلك تحتاج أي أتمتة أنشأها الذكاء الاصطناعي إلى نسخ هذا السر مرة واحدة من لوحة التحكم. يستبدله زر New secret ويتوقف القديم عن العمل فوراً، ولا يراه إلا مالك الحساب، وليس عضو فريق مدعو.
ارفض القيمة t إذا فرقت أكثر من 5 دقائق عن ساعتك، وقارن بزمن ثابت، وألقِ خطأً عند الفشل: عندها يتوقف سير العمل قبل Respond to Webhook، فيرد n8n بالرمز 500 ولا يُرسل شيء. تسمح n8n Cloud بوحدة crypto في عقد Code، أما n8n المستضاف ذاتياً فيحتاج إلى المتغير NODE_FUNCTION_ALLOW_BUILTIN=crypto. كما تعمل عملية Hmac في عقدة Crypto مع عقدة IF، غير أن مقارنة IF ليست بزمن ثابت.
// 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 tool التي تبحث عن طلب شراء.
اختم بعقدة Respond to Webhook ترد بصيغة JSON وتضع نص الوكيل في حقل اسمه reply. يزيل easyCoexistence المسافات الزائدة من النص، ويتجاهل الرد الفارغ أو غير النصي، ويرسل الباقي كرسالة WhatsApp نصية واحدة تصل إلى 4,096 حرفاً، لذا اطلب من النموذج جملاً بسيطة بدلاً من 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() }} }ماذا يحدث إذا تأخر سير العمل أو فشل أو لم يُعد شيئاً؟
تُسجَّل كل نتيجة في تبويب Runs الخاص بالأتمتة مع مخرجات الخطوة أو خطئها، لترى أيّ هذه الحالات وقعت:
- لا رد خلال 20 ثانية: تفشل الخطوة برسالة Webhook did not answer، ولا يُرسل شيء، ويظهر التشغيل بالحالة Failed.
- رمز حالة خارج نطاق 2xx، بما في ذلك إعادة التوجيه: تفشل الخطوة برسالة Webhook answered HTTP ثم الرمز.
- استجابة 2xx دون نص رد: يكون التشغيل Done، وتعرض الخطوة HTTP 200 دون رد، ولا يتلقى العميل أي رد تلقائي.
- يرسل لك التشغيل الفاشل بريداً إلكترونياً لتتمكن من الرد على ذلك العميل بنفسك، بحد أقصى مرة لكل أتمتة كل 6 ساعات.
- تُتخطى المحادثة التي رددت عليها من الهاتف خلال فترة الإيقاف (4 ساعات افتراضياً، وتُضبط ضمن Advanced) بالحالة
human_activeقبل استدعاء n8n. - تبدأ رسائل عدة متتالية تشغيلات متعددة. ويضمن انتظار Wait مدته دقيقة قبل Call my webhook ردّاً واحداً، لأن رسالة أحدث تختار الأتمتة نفسها تُلغي التشغيل المنتظر.
متى يجب أن يتلقى n8n خطاف Meta مباشرة بدلاً من ذلك؟
حين يحتاج الوكيل أكثر من 20 ثانية، أو حين يجب أن يرى سير العمل كل حدث (الحالات، وردودك من الهاتف، ومعرّفات الوسائط)، أو حين يرسل شيئاً لا تغطيه أي خطوة، مثل Flow أو رسالة كتالوج، أو حين يرغب النشاط التجاري في استيراد سجل 6 أشهر، وهذا لا يُرسل إلا إلى وجهة مباشرة حُفظت خلال 24 ساعة من الربط. يُوقف الوضع المباشر الأتمتة للرقم: تُرسل Meta حمولتها مباشرةً إلى n8n ولا يرى easyCoexistence الرسائل أبداً.
في n8n استخدم عقدة Webhook العادية، لا عقدة WhatsApp Trigger التي تتوقع تطبيق Meta الخاص بك وسرّه. فعّل Allow Multiple HTTP Methods كي يستقبل مسار عشوائي طويل مصافحة GET من Meta وطلبات POST معاً، وأجب على GET بقيمة hub.challenge الخام كنص، واحفظ عنوان Production URL ذاك مع رمز تحقق عبر set_webhook_destination. ثم تُرسل الردود من عقدة HTTP Request إلى نقطة نهاية الإرسال (endpoint)، ويصبح من مسؤوليتك إزالة التكرار، وإيقاف الرد المؤقت عند الكتابة من الهاتف، والتحقق من نافذة 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 في عقدة Webhook على Immediately. يرد n8n فوراً بالرسالة Workflow got started، فيسجل التشغيل HTTP 200 دون رد، ولا يتلقى العميل شيئاً. اختر الخيار Using 'Respond to Webhook' Node.
- لصق عنوان Test URL، ذاك الذي يحمل /webhook-test/. لا يستمع إلا أثناء انتظار المحرر لحدث اختبار، بينما تحتاج الأتمتة إلى عنوان Production URL لسير عمل منشور.
- التحقق بسر التحويل الخاص بالرقم (forward secret). تُوقَّع خطوة Call my webhook بالسر الخاص بالأتمتة Signing secret؛ أما سر التحويل فيوقّع الأحداث المحوّلة فقط، فتفشل الخطوات الحقيقية في التحقق.
- إعادة النص بشكل آخر. لا يُرسل إلا جسم JSON يحتوي على حقل نصي في المستوى الأعلى باسم reply؛ أما {"output": "..."} أو جسم بصيغة text/plain فيُسجَّل على أنه بلا رد.
تسلّم خطوته Call my webhook رسالة العميل إلى n8n وتعيد الرد، مع إزالة التكرار، وإيقاف الرد المؤقت عند الرد من الهاتف، والتحقق من نافذة 24 ساعة، كلها مدمجة دون رسوم إضافية على كل تشغيل. من US$ 9 إلى US$ 0.75 لكل رقم في الشهر، ويتناقص السعر كلما أضفت أرقاماً، مع أول 3 أيام مجانية.
الأسئلة الشائعة
هل يستطيع ChatGPT أو Claude إنشاء هذه الأتمتة نيابةً عنّي؟
نعم. بعد إضافة الموصّل الخاص بـ easyCoexistence، اطلب أتمتة على رقمك ترسل الرسائل الواردة إلى عنوان n8n الخاص بك؛ يستدعي الذكاء الاصطناعي create_automation بخطوة call_webhook، ثم test_automation. اطلب منه إنشاء الأتمتة معطّلة حتى ينجح الاختبار. لا يُعاد Signing secret عبر MCP، لذا انسخه من صفحة الأتمتة.
هل يستطيع سير العمل إرسال صور أو أزرار أو قوالب؟
ليس عبر حقل الرد، إذ يحمل النص فقط. دع الأتمتة تتولى ذلك بدلاً منه: يمكن أن توضع خطوات مثل Send a picture or file وAsk a question with buttons وSend a template قبل Call my webhook أو بعده. أما أنواع الرسائل الأخرى فأرسلها من عقدة HTTP Request إلى Cloud API، باستخدام نقطة الإرسال ورمز الوصول (token) اللذين يعيدهما get_api_credentials، ولا تُرجع أي رد، كي لا يتلقى العميل ردّين.
هل يستطيع سير عمل واحد الرد على عدة أرقام؟
نعم. اجعل أتمتة لكل رقم تشير إلى عنوان Production URL نفسه، ثم فرّع حسب channel.phone_number_id أو automation.id. لكل أتمتة Signing secret خاص بها، لذا اختر السر بحسب automation.id قبل التحقق من التوقيع.
هل يعمل n8n المستضاف ذاتياً؟
نعم، إذا كان عنوان Production URL الخاص به عنوان HTTPS عاماً. يرفض easyCoexistence عناوين http وlocalhost والعناوين الخاصة والداخلية عند حفظ العنوان ومجدداً قبل كل استدعاء، ولا يتبع عمليات إعادة التوجيه.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في