أجب عملاء WhatsApp ببيانات لحظية: الأسعار والمخزون والتوفر من نظامك
للرد على أسئلة WhatsApp عن الأسعار أو المخزون أو التوفر بأرقام حالية، مرّر رسالة العميل إلى نظامك الخاص فور وصولها، وابحث عن القيمة هناك، ثم أعِد نص الرد. تقوم بذلك خطوة webhook في الأتمتة: ترسل الرسالة ورقم العميل بطريقة POST، ويُرسل الرد JSON يحتوي على حقل reply، يُعاد خلال 20 ثانية، كرد على WhatsApp.
تربط easyCoexistence رقم WhatsApp Business الذي تحتفظ به في التطبيق بـ Cloud API من Meta عبر Coexistence، وتشغّل عليه الأتمتات.
المدة التي تنتظر فيها خطوة Call my webhook رد نظامك قبل أن تفشل الخطوة.
آخر الرسائل في المحادثة تُرسل مع الطلب، من الأقدم إلى الأحدث، ليحتفظ السؤال المتابِع بسياقه.
عدد الأحرف التي يُرسل بها الرد كنص WhatsApp واحد؛ النص الأطول يُقطع.
يجب أن تكون عناوين webhook عامة عبر HTTPS؛ تُرفض http والعناوين الخاصة، ولا تُتبع عمليات إعادة التوجيه.
نافذة بعد آخر رسالة من العميل تقبل Meta فيها الردود الحرة، وأي سؤال جديد يفتحها من جديد.
كيف يعمل الرد ببيانات لحظية؟
تلتقط أتمتة واحدة الرسالة، عادةً أتمتة بالكلمات المفتاحية لكلمات السعر أو المخزون. تُرسل خطوة Call my webhook الرسالة ورقم العميل والمحادثة الأخيرة بطريقة POST إلى عنوانك، موقّعةً بالسر الخاص بالأتمتة. يقرأ الكود القيمة، ثم يرد بـ HTTP 200 وجسم JSON مثل {"reply": "Sourdough loaf: US$ 6.50, 14 left today."}. تتحقق easyCoexistence من نافذة الـ 24 ساعة، وترسل هذا النص من رقمك.
قبل استدعاء نظامك، يكون التشغيل قد مرّ بالحراس المدمجين: تكرار التسليم من Meta لا يبدأ تشغيلًا ثانيًا، والمحادثة التي رددت عليها من الهاتف تُترك دون تدخل لمدة 4 ساعات افتراضيًا. ويظهر الرد أيضًا في سلسلة المحادثة داخل التطبيق، فيعرف من يحمل الهاتف ما قيل للعميل.
لماذا لا نُبقي الأسعار والمخزون في رد ثابت أو في تعليمات الذكاء الاصطناعي؟
الرد الثابت يُكتب مرة واحدة، وخطوة Reply with AI تكتب من مصدرين فقط: تعليماتها والمحادثة الأخيرة. ولا يتغير أيٌّ منهما عندما ينفد منتج أو يُحجز موعد. كما أن خطوة الذكاء الاصطناعي مُوجَّهة وفق تعليماتك ألا تختلق أسعارًا أو مخزونًا أو مواعيد أو سياسات لا تراها، فيتلقى السؤال عن مخزون اليوم تحويلًا مهذبًا إلى شخص حقيقي بدل أن يتلقى رقمًا.
الأرقام التي تتغير خلال اليوم يجب أن تبقى في النظام الذي يحتفظ بها أصلًا: المتجر، أو الجدول، أو تقويم الحجوزات، أو نظام ERP. تتيح خطوة Call my webhook لذلك النظام أن يجيب العميل مباشرة، بالقيمة التي يملكها في تلك اللحظة، من رقم WhatsApp Business الذي يستخدمه الفريق داخل التطبيق.
أي الأسئلة يجب أن تذهب إلى نظامك؟
تلك التي تتغير إجابتها أسرع من أن تعدّل نصًا. وجِّهها بمُشغِّل Has keyword بوضع Contains، بحد أقصى 30 كلمة، في كل لغة تخدمها. تُفحص الأتمتات بالكلمات المفتاحية قبل First message وAfter hours والقاعدة الشاملة، ولا تجيب عن الرسالة إلا أتمتة واحدة، لذلك يبقى مساعد الذكاء الاصطناعي على القاعدة الشاملة متاحًا للأسئلة الأخرى. يطابق Contains داخل الكلمات، لذا فضّل المصطلحات الكاملة على المقاطع القصيرة:
- الأسعار: price، how much، price list، preço، quanto custa، precio، cuánto cuesta
- المخزون: stock، available، in store، estoque، disponível، disponible
- المواعيد الشاغرة: appointment، slot، table for، horário، vaga، una cita، mesa para
- رسوم التوصيل أو المنطقة حسب الرمز البريدي: delivery fee، frete، taxa de entrega، envío، código postal
- حالة اليوم: open today، holiday، aberto hoje، feriado، abierto hoy
ما الذي يستقبله نظامك ويعيده؟
طلب POST بصيغة JSON، والترويسة X-EC-Event تساوي automation.step. الحقول التي يحتاجها البحث هي message.text، حيث يظهر اسم المنتج أو رمزه، وcontact.wa_id، وهو رقم العميل بالأرقام الدولية دون علامة الزائد، ومفيد للأسعار حسب فئة العميل أو لسلة محفوظة. يحتوي history على 10 رسائل حديثة كحد أقصى، فيمكن قراءة السؤال "وباللون الأحمر؟" في ضوء السؤال السابق. ويرسل الاختبار من Try it القيمة dry_run بقيمة true مع history فارغ.
أجب بـ HTTP 200 مع حقل نصي على المستوى الأعلى اسمه reply. إذا كان reply فارغًا أو غائبًا فلا يُرسل شيء وتنتقل الأتمتة إلى أي خطوة لاحقة. ويفشل الإجراء إذا كانت الاستجابة خارج النطاق 2xx، أو عند إعادة توجيه، أو عند الصمت بعد 20 ثانية. تعرض صفحة وكيل n8n الجسم الكامل.
POST https://shop.example/whatsapp/live
X-EC-Event: automation.step
X-EC-Signature: t=1762869731,v1=5f0c...
{
"event": "automation.step",
"dry_run": false,
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": { "id": "wamid.HBgN...", "type": "text", "text": "Is the linen shirt in size M available?", "at": "2026-11-11T14:02:11.000Z" },
"history": [ ...up to 10 recent messages, oldest first... ]
}
HTTP 200, within 20 seconds:
{ "reply": "Linen shirt, size M: 3 left, US$ 42. Want me to hold one for you until 6 pm?" }كيف تبني نقطة النهاية في Node.js؟
اقرأ الجسم كنص خام، وتحقق من X-EC-Signature عليه، ثم حلّله. الترويسة بالشكل t=<unix seconds>,v1=<hex>، حيث v1 هو HMAC-SHA256 للقيمة t ونقطة ثم الجسم، ومفتاحه سر التوقيع whsec_ الكامل الخاص بالأتمتة. ارفض t إذا بعدت أكثر من 5 دقائق عن ساعتك، وقارن بزمن ثابت.
ثم نفّذ بحثًا سريعًا واحدًا: استعلام قاعدة بيانات، أو استدعاء مخزّن لواجهة API متجرك، أو قراءة من قائمة أسعار محفوظة في الذاكرة. سابقه بمؤقت، حتى تُنتج قاعدة بيانات بطيئة سطرًا لطيفًا قبل حد الـ 20 ثانية بدل تشغيل فاشل. وعندما لا يتطابق شيء، اطلب اسم المنتج أو رمزه بدل التخمين.
import express from "express";
import crypto from "node:crypto";
const SECRET = process.env.EC_SIGNING_SECRET; // the automation's Signing secret, from its editor page
function signed(req) {
const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(req.get("X-EC-Signature") || "");
if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
const mac = crypto.createHmac("sha256", SECRET).update(m[1] + "." + req.body).digest();
return crypto.timingSafeEqual(mac, Buffer.from(m[2], "hex"));
}
const app = express();
app.post("/whatsapp/live", express.text({ type: "application/json" }), async (req, res) => {
if (!signed(req)) return res.status(401).end();
const { message } = JSON.parse(req.body);
// Answer before the 20-second limit whatever happens: a slow lookup gets a fallback at 15 s.
const late = new Promise((r) => setTimeout(() => r("late"), 15000));
const item = await Promise.race([findProduct(message.text), late]); // your SQL, API or cache
if (item === "late") return res.json({ reply: "Let me check that for you. A person will reply here shortly." });
if (!item) return res.json({ reply: "Which product do you mean? Send its name or code and I will look it up." });
const stock = item.stock > 0 ? item.stock + " in stock" : "out of stock today";
res.json({ reply: item.name + ": " + item.price + ", " + stock + "." });
});
app.listen(3000);هل يمكن لنموذج أن يكتب الرد من البيانات اللحظية؟
نعم، خلف الـ webhook. تجلب نقطة نهايتك، أو سير عمل n8n يحوي عقدة AI Agent، الأرقام أولًا، عبر استعلام أو أداة، ثم تطلب من نموذجك صياغة الرد بها: "العميل سأل عن X. المخزون الحالي: Y. أجب بجملة أو جملتين، بلغة العميل." فيحمل الحقل reply عندئذ نص النموذج. أما خطوة Reply with AI وحدها فلا تملك أدوات ولا تصفحًا، لذلك هذا هو المسار للردود التي تجمع الصياغة مع البيانات.
أبقِ دورة الطلب كاملة، أي البحث مع استدعاء النموذج، أقل بكثير من 20 ثانية. اطلب من النموذج ردًا قصيرًا، واختر نموذجًا سريعًا، وأبقِ الرد الاحتياطي بالمؤقت في مكانه ليوم يكون فيه المزوّد بطيئًا.
ما حدود رد الـ webhook؟
رد الـ webhook نص عادي يُرسل مرة واحدة، وهذا يكفي لمعظم إجابات الأسعار والمخزون والتوفر. وأي محتوى أغنى يُرسله نظامك عبر Cloud API من Meta. النقاط التي تخطط لها:
- نص فقط، حتى 4,096 حرفًا، دون markdown. للصور أو الأزرار أو القوالب: أرسلها من نظامك بنقطة الإرسال من
get_api_credentials، ولا تُرجع reply - محاولة واحدة بلا إعادة. تعطل المهلة أو الخطأ التشغيل ويُسجَّل Failed، ويصلك بريد إلكتروني مرة واحدة كحد أقصى لكل أتمتة كل 6 ساعات
- خطوة رد بعد الـ webhook ترسل أيضًا، فيتلقى العميل رسالتين
- الردود الحرة تُرسل فقط خلال 24 ساعة من آخر رسالة للعميل، وقد تتجاوزها خطوة Wait قبل الـ webhook
كيفية إعداده
- Expose the lookupPublish an HTTPS endpoint or an n8n workflow that verifies X-EC-Signature, reads message.text and contact.wa_id, and returns {"reply": "..."}.
- Create the automation, switched OffIn Automations, click New automation, pick Send to my system under Start from an example, change the trigger to Has keyword with your price or stock words, paste the URL into Webhook URL, set the switch to Off and click Save.
- Copy the Signing secretSelect the Call my webhook step of the saved automation and copy Signing secret into your endpoint's settings.
- Try a real questionClick Test, type a question such as "Is the linen shirt in size M available?" in Try it and press Run test. Your system really runs with dry_run true; the result shows the reply.
- Switch it OnWhen the reply reads right, set the switch to On and save. Send a question from another phone and open the run under Runs to see the timing.
الأخطاء الشائعة
- لصق الأسعار في تعليمات الذكاء الاصطناعي ونسيانها. يقتبس النموذج أرقام الشهر الماضي بثقة، لذا أبقِ الأرقام المتغيرة في نظامك ودع الـ webhook يقرأها.
- تشغيل تقرير بطيء داخل الطلب. بعد 20 ثانية تفشل الخطوة ولا يُرسل شيء، لذا استعلم عن فهرس أو ذاكرة مؤقتة، وأرجع سطر احتياط عند 15 ثانية.
- إضافة خطوة Reply with text بعد الـ webhook كشبكة أمان. تعمل بعد الرد الناجح أيضًا، فيتلقى العملاء رسالتين، لذا ضع نصوص الاحتياط في نقطة نهايتك.
- استخدام مقاطع كلمات مفتاحية قصيرة مثل "tem" أو "cost". يطابق Contains داخل الكلمات، فـ item وtemperature وcostume تبدأ البحث، لذا استخدم مصطلحات كاملة واختبرها في Try it.
تُدخل خطوة Call my webhook نظامك الخاص إلى المحادثة: ترسل السؤال موقّعًا، وتسلّم الرد الذي يعيده نظامك، مع إزالة التكرار والإيقاف المؤقت عند ردك من الهاتف والتحقق من نافذة الـ 24 ساعة مدمجة، دون رسوم إضافية لكل تشغيل. ابتداءً من US$ 9 لكل رقم متصل شهريًا، ينخفض إلى US$ 0.75 كلما أضفت أرقامًا، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يمكن أن يكون جدول Google قائمة الأسعار؟
نعم. يستطيع سير عمل n8n البحث عن المنتج في الجدول بعقدة Google Sheets، ثم يُرجع سعر الصف ومخزونه كرد. تحدد Google عدد القراءات في الدقيقة لكل مستخدم، لذا للأرقام المزدحمة خزّن الجدول مؤقتًا في سير العمل أو في خلفيتك، وحدّثه كل بضع دقائق.
هل يحتاج نظامي إلى العمل على مدار الساعة؟
لهذه الأتمتة، نعم: الطلب الذي يفشل أو تنتهي مهلته يسجّل التشغيل Failed، ولا يُرسل شيء، ويصلك بريد إلكتروني. ضع أتمتة ثانية بأولوية أدنى، مثل مساعد ذكاء اصطناعي على القاعدة الشاملة، للأسئلة الأخرى، واحتفظ برد الاحتياط الخاص بنقطة نهايتك لأوقات البطء.
هل يستطيع ChatGPT أو Claude إعداد هذه الأتمتة لي؟
نعم. مع موصل easyCoexistence، اطلب أتمتة بالكلمات المفتاحية على رقمك تستدعي عنوانك؛ يستخدم الذكاء الاصطناعي create_automation مع خطوة call_webhook، ثم test_automation. لا يُعاد سر التوقيع عبر MCP، لذا انسخه من صفحة الأتمتة في لوحة التحكم.
هل تكلّف الردود ببيانات لحظية مالًا إضافيًا؟
ليس من easyCoexistence: الأتمتات لا تحمل رسوم تشغيل ولا سقفًا للتشغيلات. تفرض Meta رسومها على الرسائل داخل حساب WhatsApp Business للنشاط التجاري نفسه، لكل رسالة، حسب الفئة والدولة، ولا تضيف easyCoexistence عليها أي هامش. أما خادمك أو أداة سير العمل فتكلف ما تكلفه اليوم.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في