أرسل رسائل WhatsApp من أي نظام باستخدام Webhook
متجرك أو نظام CRM أو أداة الحجوزات لديك يعرف بالفعل متى يُنشأ طلب، أو يفشل دفع، أو يُحجز موعد. ويمكن لـ Webhook أن يحوّل كل حدث من هذه الأحداث إلى رسالة على WhatsApp، دون أي برمجة من جهتك. إليك كيف تخطط له وتؤمّنه وتختبره.
فريق MonoChat آخر تحديث: 6 دقائق قراءة
في هذه الصفحة
لإرسال رسالة WhatsApp عندما يحدث شيء في نظام آخر، وجّه Webhook ذلك النظام إلى مستقبِل يعثر على العميل من رقم هاتفه ويرسل إليه قالب WhatsApp معتمدًا. متجرك أو نظام CRM أو أداة الحجوزات لديك يطلق بالفعل Webhooks للطلبات والمدفوعات والمواعيد؛ أما العمل الحقيقي فهو اختيار الأحداث التي تستحق رسالة، وكتابة القوالب، وتأمين الرابط، والاختبار بطلبات حقيقية قبل أن يرى العملاء أي شيء.
يشرح هذا الدليل التخطيط، وقواعد WhatsApp التي تحدد شكله، وكيفية تنفيذه في MonoChat بمسار يبدأ من رابط Webhook خاص به.
ما هو Webhook وما ليس هو
Webhook هو طلب HTTP يرسله نظام إلى رابط تحدده له عند وقوع حدث ما. يمكن أن يرسله Shopify عند إنشاء طلب، وWooCommerce عند تحديث طلب، ونظام CRM عند انتقال صفقة إلى مرحلة جديدة، وأداة الحجوزات عند حجز موعد. ويحمل الطلب تفاصيل الحدث، غالبًا بصيغة JSON: رقم الطلب، والمبلغ، واسم العميل، والأهم بالنسبة إلى WhatsApp: رقم الهاتف.
لا يرسل Webhook أي شيء إلى العميل بمفرده. لا بد من جهة تستقبل الطلب، وتقرر ما تفعله به، وتستدعي WhatsApp Business API. وهذه الجهة إما كود تكتبه وتستضيفه بنفسك، وإما منصة أتمتة تمنحك رابط Webhook وتتيح لك بناء الباقي دون برمجة.
ما الأحداث التي تستحق رسالة على WhatsApp
ليس كل حدث جديرًا برسالة. فالعميل الذي يتلقى خمسة إشعارات عن طلب واحد يبدأ في تجاهلها كلها. اختر اللحظات التي ينتظرها فعلًا:
| الحدث | الرسالة | فئة القالب |
|---|---|---|
| إنشاء الطلب أو دفعه | تأكيد برقم الطلب وما سيحدث بعد ذلك | أدوات (Utility) |
| فشل الدفع أو تعليقه | ملاحظة قصيرة وطريقة لإعادة الدفع | أدوات (Utility) |
| شحن الطلب | شركة الشحن ورابط التتبع | أدوات (Utility) |
| إنشاء طلب بالدفع عند الاستلام | سؤال: تأكيد الطلب أو تغيير العنوان أو الإلغاء | أدوات (Utility) |
| حجز موعد أو تعديله أو حلوله غدًا | التاريخ والوقت والمكان وطريقة لتغيير الموعد | أدوات (Utility) |
| ربح صفقة أو خسارتها في CRM | تسليم إلى مدير الحساب، أو سؤال عن رأي العميل | أدوات أو تسويقية، بحسب النص |
| سلة متروكة | تذكير، وربما مع عرض | تسويقية (Marketing) |
تحدد Meta الفئة بناءً على ما يقوله القالب، لا على التصنيف الذي تختاره أنت. فالرسالة المتعلقة بطلب أو دفعة أو حجز بعينه هي رسالة أدوات (Utility)؛ وكل ما يروّج أو يعرض أو يحاول الإقناع هو تسويقي، ويحتاج إلى موافقة تشمل الرسائل التسويقية. تجد في أمثلة رسائل قوالب WhatsApp صياغات جاهزة لحالات الأدوات المذكورة أعلاه.
قواعد WhatsApp التي تنطبق
معظم رسائل Webhook تحتاج إلى قالب
تُفتح نافذة خدمة العملاء عندما يراسلك العميل أو يتصل بك، وتستمر 24 ساعة من آخر رسالة منه. داخل النافذة يمكنك الرد بحرية؛ وخارجها لا يمكنك إرسال سوى رسائل قوالب معتمدة مسبقًا. ونادرًا ما تقع أحداث المتجر أو CRM داخل هذه النافذة، لذا خطط لكل رسالة Webhook على أنها قالب، وقدّم القوالب للمراجعة قبل تشغيل أي شيء.
يجب أن يكون رقم الهاتف صالحًا للاستخدام
يجب أن يحمل Webhook رقم هاتف يستطيع WhatsApp الوصول إليه: بالصيغة الدولية ومع رمز الدولة. كثير من المتاجر تترك العميل يكتب رقمه كما يشاء، فراجع بعض الطلبات الحقيقية. والرقم الخالي من رمز الدولة هو السبب الأكثر شيوعًا لنجاح الاختبار وفشل التشغيل الفعلي.
تغيرت الأسعار في 1 أكتوبر 2026
تحتسب Meta الرسوم على كل رسالة تُسلَّم منذ 1 يوليو 2025. ومنذ 1 أكتوبر 2026 عادت قوالب الأدوات (Utility) المرسلة داخل نافذة خدمة عملاء مفتوحة إلى الاحتساب بعد فترة كانت فيها مجانية، ويحصل كل رقم هاتف تجاري على 1,000 رسالة خدمة مجانية شهريًا. وتختلف الأسعار بحسب الفئة ودولة العميل. عمليًا، يكلّف تأكيد الطلب مالًا سواء راسلك العميل مؤخرًا أم لا، فأرسل الرسائل المهمة واستغنِ عن غيرها. ويشرح دليل أسعار WhatsApp Business API جدول الأسعار.
أمّن رابط Webhook
كل من يعرف رابط Webhook يستطيع استدعاءه. وإذا كان هذا الرابط يرسل رسائل WhatsApp، فإن تسريبه يعني أن شخصًا آخر يمكنه مراسلة عملائك باسمك أو تضخيم فاتورتك. ثلاث عادات تمنع ذلك:
- اشترط وجود سر. يضيف النظام المرسِل السر في ترويسة (Header)، أو يوقّع به محتوى الطلب (HMAC-SHA256) ليتمكن المستقبِل من التحقق من أن الطلب لم يُعدَّل في الطريق. وتُرفض الطلبات التي لا تحمل سرًّا أو توقيعًا صحيحًا.
- رابط واحد لكل غرض. يجب أن يكون لمسار الطلبات ومسار الحجوزات رابطان وسرّان مختلفان، حتى تتمكن من تغيير أحدهما دون المساس بالآخر.
- راقب الإخفاقات في جهة الإرسال. يعطّل WooCommerce الـ Webhook بعد أكثر من خمسة إخفاقات متتالية في التسليم، ويحذف Shopify اشتراك Webhook إذا كانت وجهته تعيد مرارًا استجابة غير 200. وقد يوقف مستقبِلٌ متوقف أو مضبوط بشكل خاطئ إشعاراتك دون أن تلاحظ.
أين تنشئ Webhook في Shopify وWooCommerce
- Shopify: من Settings › Notifications › Webhooks ثم Create webhook. اختر حدثًا واحدًا (Order creation أو Order payment أو Fulfillment creation وغيرها كثير)، وJSON صيغةً، ورابطًا يبدأ بـ
https://. لا يمكن تغيير الحدث بعد إنشاء الـ Webhook، لذا أنشئ Webhook لكل حدث. ويتحقق زر Send test من وصوله إلى الرابط. - WooCommerce: من WooCommerce › Settings › Advanced › Webhooks ثم Add webhook. اختر موضوعًا (أحداث الطلبات أو العملاء أو القسائم أو المنتجات)، وأدخل رابط التسليم وسرًّا؛ ويضيف WooCommerce إلى ترويسات الطلب قيمة Hash للمحتوى تُنشأ بهذا السر.
- نظام CRM أو أداة حجوزات: ابحث عن “Webhooks” أو “الأتمتة” أو “التكاملات الصادرة”. وإذا كان لا يوفّر إلا صيغة ثابتة، فتحقق من الحقل الذي يحمل رقم هاتف العميل قبل أن تبني أي شيء.
اختبر بطلبات حقيقية قبل الإطلاق
محتوى Webhook طويل، وكل منصة تسمّي حقولها بطريقتها: قد يكون رقم الهاتف في phone أو billing.phone أو customer.default_address.phone. لا تخمّن. أرسل طلب اختبار حقيقيًا، وانظر إلى ما وصل، واربط الحقول بناءً عليه. ثم اختبر الحالات الاستثنائية:
- طلب بلا رقم هاتف، أو برقم ينقصه رمز الدولة؛
- وصول الحدث نفسه مرتين، وهو ما تفعله المنصات عند إعادة المحاولة؛
- طلب يُنشأ في الثالثة فجرًا، إن كنت تفضّل أن تنتظر الرسالة حتى الصباح؛
- عميل يرد على الإشعار، حتى يكون موظف أو مساعد ذكاء اصطناعي جاهزًا للرد.
كيف تنفّذ ذلك في MonoChat
MonoChat شريك أعمال رسمي لـ Meta (Meta Business Partner). ومنذ الإصدار 3.8.37 (أكتوبر 2026) يمكن أن يبدأ المسار من Webhook، فيستطيع متجرك أو نظام CRM لديك تشغيل رسائل WhatsApp دون أي برمجة من جهتك.
1. ابدأ المسار بعقدة تم استلام Webhook. أضفها من عقد الأحداث. تحصل العقدة على رابط Webhook وسر خاصين بها. اختر القناة، مثل رقم WhatsApp الخاص بك، ثم مسار الهوية، أي موضع رقم هاتف العميل داخل الطلب (request.body.phone افتراضيًا). يعثر MonoChat على العميل في تلك القناة أو ينشئه، ثم يشغّل المسار له. وتردّ العقدة على المرسِل بالرمز 202 بمجرد إدراج المسار في قائمة الانتظار، وبرسالة خطأ واضحة إذا لم يُعثر على القناة أو رقم الهاتف.
2. فعّل طلب السر. يمكن للمرسِل وضع السر في ترويسة الرمز المميز (Authorization افتراضيًا، بمفرده أو بصيغة Bearer <secret>)، أو إرسال توقيع HMAC-SHA256 للمحتوى الخام في ترويسة التوقيع (X-Signature افتراضيًا). ويمكن تغيير اسمَي الترويستين ليتوافقا مع النظام المرسِل.
3. التقط طلبًا حقيقيًا. أضف /test إلى نهاية رابط Webhook ووجّه إليه Webhook الاختبار في متجرك. وما دامت إعدادات العقدة مفتوحة، يظهر الطلب تحت الطلب المستلم بمحتواه ومعاملات الاستعلام (Query) والترويسات، دون أن يبدأ المسار. استخدمه للعثور على المسارات التي تحتاج إليها، ثم احفظها متغيراتٍ للمسار، مثل request.body.orderId باسم orderId.
4. أرسل الرسالة. أضف عقدة إرسال رسالة قالب مع قالبك المعتمد، واملأ متغيراته من متغيرات المسار: رقم الطلب، والمبلغ، ورابط التتبع. واستخدم الشروط لإرسال قوالب مختلفة بحسب حالة الطلب.
5. أعد البيانات إلى نظامك عند الحاجة. يمكن لعقدة طلب HTTP أن تجلب بيانات إضافية من نظامك، أو تكتب فيه رد العميل، مثل “تم التأكيد” على طلب بالدفع عند الاستلام. وتواصل عبر المخرج عند نجاح الاستدعاء، وعبر عند الفشل عند إخفاقه، فتستطيع إرسال رسالة بديلة أو إسناد المحادثة إلى موظف.
عندما يرد العميل، تصل المحادثة إلى صندوق وارد الفريق نفسه في MonoChat مع بقية محادثاتك على WhatsApp وInstagram وMessenger، حيث يمكن لفريقك أو لمساعد ذكاء اصطناعي تولّيها. ولبناء المسارات، راجع أتمتة سير العمل.
طريقان آخران، بحسب من سيتولى العمل:
- مطوروك يستدعون API بالفعل. يرسل تطبيق WhatsApp Template API قالبًا معتمدًا باستدعاء API واحد، وتصل الردود إلى صندوق الوارد.
- تدير متجرًا على Shopify وتريد بيانات الطلبات داخل المحادثة. تزامن أتمتة دردشة Shopify المنتجات والطلبات حتى يتمكن الفريق ومساعد الذكاء الاصطناعي من الإجابة عن أسئلة الطلبات.
للبدء، أنشئ حسابًا مجانيًا على app.monochat.ai، واربط رقم WhatsApp الخاص بك، وقارن الباقات في صفحة الأسعار.
المصادر
طبّق ذلك مع MonoChat