دليل الويب هوك في Whats360: معمارية استقبال الأحداث والربط الخارجي بدون خوادم إضافية
يواجه المطورون وأصحاب المتاجر الإلكترونية تحدياً تقنياً متكرراً بمجرد التفكير في أتمتة إشعارات المعاملات الرقمية عبر واتساب. التساؤل المعتاد الذي يشغل الجميع هو: من أين أحصل على رابط الويب هوك لتشغيل النظام أو ربط متجري بالمنصة؟ وهل يلزم استئجار خادم سحابي مستقل وبرمجة مسار مخصص لاستقبال كل حركة شراء وتحويلها إلى رسالة فورية للعميل؟
هذا الالتباس التقني يقود الكثيرين إلى إنفاق أوقات طويلة في تجهيز بيئات برمجية وسيطة وتحمل تكاليف استضافة دورية لا داعي لها. المنظومة البرمجية داخل منصة Whats360 مبنية على معمارية معالجة تعتمد كلياً على تحديد اتجاه حركة البيانات بدقة؛ فالمنصة ليست مجرد مجرى صامت، بل تمتلك محركاً سحابياً متكاملاً يولد روابط استقبال أحداث مدمجة ومجانية لربط متاجرك ومواقعك دون كتابة سطر برمجي واحد أو استئجار سنتيمتر سحابي إضافي.
خلاصة مباشرة: حقيقة الروابط السحابية في Whats360
توفر منصة Whats360 روابط ويب هوك مدمجة ومستضافة سحابياً بشكل تلقائي لاستقبال البيانات الخارجية عبر قسم روابط الاستقبال HookURL أو قسم القوالب الجاهزة لمنصات التجارة مثل Shopify وتطبيق WooCommerce. يتم إنشاء هذه الروابط السحابية فورياً بصيغة مخصصة لتقوم بنسخها ووضعها مباشرة داخل متجرك التجاري دون أي خادم وسيط. أما الخادم الخارجي، فتحتاجه حصراً في مسار تصدير البيانات إلى الخارج عندما ترغب في جعل المنصة ترسل أحداث الواتساب الواردة إلى أنظمتك الخاصة.
المعمارية التقنية لمنظومة الويب هوك ثنائية الاتجاه
تقنية الويب هوك هي بروتوكول اتصال مبني على وقوع الأحداث داخل التطبيقات والأنظمة البرمجية. بمجرد إتمام العميل لعملية طلب، يقوم نظام المتجر بإطلاق حزمة برمجية مهيكلة بصيغة JSON إلى عنوان رابط يتم تحديده سلفاً من قِبل الطرف المستمع للحدث. يقع الخلط دائماً عندما يظن مدير المتجر أنه المسؤول عن توفير وبناء العنوان المستمع لطلبات الشراء، بينما الصحيح تقنياً هو أن المنصة المستقبلة هي المنوط بها منحك هذا المسار السحابي المهيأ للاستقبال.
ينقسم مسار تبادل البيانات داخل Whats360 إلى خطين وظيفيين متعاكسين لا يلتقيان في المتطلبات الهندسية، مما يجعل تحديد مصدر الرابط معتمداً على مسار المعاملة الرقمية:
E-Commerce Store (Shopify/Salla/Woo) ──(HTTP POST Payload)──► Whats360 HookURL Endpoint ──► Automated WhatsApp Dispatch
[Direction 2: Outbound Events]
Inbound Customer Message ──► Whats360 Ingestion Node ──(HTTP POST Event)──► Custom Listener / n8n / Private Server
توضيح هذه المسارات المعمارية يحدد بدقة متى تستخدم البنية المجانية المدمجة ومتى تتجه إلى تفعيل خادم استماع مستقل، وهو ما يلخصه الجدول التقني التالي لتجنب دفع تكاليف تشغيلية لا ضرورة لها لمشاريع الأتمتة في قطاع التجارة الرقمية.
تطبيق هذا الفصل الهندسي يرفع الكفاءة التشغيلية لمشاريع المتاجر الإلكترونية المتنوعة، ويمنع هدر الوقت في محاولات إعداد استضافات سحابية غير مطلوبة على الإطلاق.
احصل على استشارة ربط وتفعيل إشعارات الواتساب لمتجرك
لا تضيع وقتك في تجارب الربط غير المكتملة وتكاليف الخوادم غير اللازمة. دع خبراء الربط السحابي يساعدونك في ربط متجرك بضغطة زر وتفعيل إشعارات الشحن والطلبات تلقائياً.
- تفعيل روابط HookURL المدمجة لمتجرك بدون خوادم خارجية
- مطابقة حقول البيانات تلقائياً لمنصات شوبيفاي، سلة، وووكومرس
- إعداد قوالب رسائل معتمدة لتأكيد المعاملات والسلات المتروكة
مسار روابط الاستقبال المدمجة HookURL والقوالب السحابية
عندما تكون المهمة الأساسية هي أتمتة مراسلات المتجر مثل إرسال إشعار شراء فوري، رسالة تتبع شحنة، أو رمز مرور لمرة واحدة، فإن النظام التجاري الخارجي هو الطرف الذي يرسل الحدث. تمنحك المنصة في هذا المسار وصولاً لمولدات روابط سحابية متقدمة تتولى إتمام الاستقبال والمعالجة داخلياً عبر طريقتين عمليتين في لوحة التحكم.
محرك القوالب المهيأة مسبقاً لاستقبال الأحداث
صُمم قسم القوالب داخل منصة Whats360 لتوفير مسار أتمتة خالي من التعقيد لأصحاب الأعمال ومديري المبيعات، حيث يلغي الحاجة لربط مسارات حقول البيانات يدوياً. بمجرد اختيار القالب، تقوم المنصة بتوليد الـ Endpoint وتنسيق مخرجات الرسالة لتلائم البيانات القادمة من:
- Shopify: التعامل الفوري مع أحداث إنشاء الطلبات وتحديثات الدفع المكتمل.
- WooCommerce: إطلاق الرسائل فور تحول حالة الطلب داخل ووردبريس إلى قيد التنفيذ أو مكتمل.
- منصات سلة وزد: توجيه تنبيهات تأكيد الشراء والتتبع اللوجستي مباشرة لأرقام العملاء بالصيغة الدولية.
- Google Forms و Google Sheets: التقاط تحديثات النماذج المباشرة عبر Google Sheets وتحويل كل صف جديد إلى رسالة واتساب آلية.
- إعلانات جمع العملاء المحتملين: التقاط بيانات الحملات التسويقية فور ملء العميل لنموذج الإعلانات عبر شبكة Facebook التابعة لشركة Meta.
محرك الروابط المخصصة HookURL وعزل الأجهزة
بالنسبة للمطورين الذين يعملون على تطبيقات مخصصة أو برمجيات خاصة، يتيح قسم HookURL إنشاء عناوين استقبال فريدة ترتبط ارتباطاً وثيقاً برقم واتساب محدد داخل الحساب. تضمن هذه الآلية عزل الأجهزة البرمجي لمنع تداخل الأحداث عند إدارة أرقام تواصل متعددة لعدة فروع أو متاجر مستقلة.
يتولد الرابط السحابي بنقرة زر واحدة داخل لوحة التحكم بالصيغة الهندسية المعتمدة:
كل ما يلزم المطور هنا هو نسخ هذا المسار وتزويده لنظامه الخارجي لبدء تمرير الطلبات بصيغة POST، حيث تتولى المنصة فك التشفير، وقراءة المتغيرات، وتوجيه الرسائل للأرقام المحددة دون الحاجة لأي برمجة إضافية لمعالجة الطوابير.
متى تحتاج فعلياً إلى خادم خارجي لتصدير الأحداث؟
تتحول المنصة في هذا المسار لتصبح هي مصدر البيانات، حيث تراقب خوادم Whats360 حركة الرسائل والأحداث داخل رقم الواتساب، وتنشئ حزمة JSON منظمة لترسلها فورياً إلى رابط خارجي تحدده أنت داخل حسابك. تتطلب هذه العملية وجود جهة استقبال مستعدة لتلقي طلبات الشبكة ومعالجتها على مدار الساعة.
تنحصر الحاجة لبناء أو استئجار بنية خوادم خارجية في السيناريوهات التطويرية المعقدة التالية:
- المزامنة المركزية مع أنظمة إدارة علاقات العملاء: تدوين كل رسالة واردة من العملاء داخل سجل المحادثات الموحد في برمجيات مثل Odoo أو HubSpot أو منصة Zoho.
- هندسة سيناريوهات الذكاء الاصطناعي والأتمتة المتقدمة: تحويل الرسائل الواردة إلى محركات الأتمتة المفتوحة مثل n8n أو المنصات السحابية كـ Make و Zapier لبناء روبوتات دردشة ذكية تحلل نوايا العملاء وترد ببيانات قواعد البيانات الخاصة.
- مراقبة جودة التسليم ورصد الأرقام المعطلة: الاستماع لأحداث فشل الإرسال لاستبعاد الأرقام غير الفعالة تلقائياً وتحديث قوائم جهات الاتصال في أنظمتك التسويقية.
- بناء خطط بديلة عبر قنوات الرسائل القصيرة: إطلاق رسائل تنبيهية بديلة عبر بوابات الرسائل عند تعطل هاتف العميل بالاعتماد على خدمات متخصصة مثل بوابة SMS Control.
هيكل حزمة البيانات الصادرة من المنصة عند استقبال رسالة
ترسل المنصة كائن البيانات التالي عبر طلب HTTP POST فور استقبال أي تفاعل جديد على رقم الواتساب:
{
"event": "messages.upsert",
"instance_id": "instance_544",
"data": {
"message_id": "3EB0123456789ABCDEF",
"chat_jid": "201234567890@s.whatsapp.net",
"sender_phone": "+201234567890",
"sender_name": "Tamer Adel",
"message_text": "أريد معرفة موعد شحن طلبي الأخير؟",
"message_type": "text",
"timestamp": 1772712000
}
}
ترشيحات الاستضافة والبنية التحتية البرمجية لمسار التصدير
إذا كانت احتياجاتك التشغيلية تتطلب تفعيل هذا المسار الصادر، فإن اختيار بيئة الاستضافة المناسبة يعتمد على مرحلة المشروع البرمجي:
- مرحلة الفحص والاختبار التجريبي: يمكنك استخدام أدوات التحليل الفوري لحزم الشبكة مثل منصة Webhook.site لمشاهدة البيانات الخام، أو نشر خادمك التجريبي مجاناً عبر منصات مثل Render أو بيئة التطوير السحابية في Replit.
- بيئات التشغيل الحية المستقرة: تتطلب معالجة آلاف الحزم يومياً خوادم سحابية مخصصة ذات استقرار دائم وسرعة استجابة فائقة، ويُوصى بالاعتماد على خوادم الاستضافة في Hetzner أو البنية التحتية لمنصة DigitalOcean، أو بيئة الحوسبة المتطورة لدى Amazon Web Services.
طلب تكامل مخصص وبرمجة خوادم ويب هوك خاصة
هل تدير منصة ضخمة وترغب في هندسة خوادم متقدمة لربط محادثات الواتساب مع أنظمة تخطيط الموارد وسيرفرات الشركة بأعلى معايير الأمان والتوافر الدائم؟
شجرة اتخاذ القرار البرمجية لفرز متطلبات الربط
لتجنب اتخاذ قرارات هندسية غير متوافقة مع متطلباتك الفعلية، اتبع هذه الشجرة المنطقية المبسطة لفرز نوع الويب هوك وتحديد الخطوة التالية في حسابك خلال ثوانٍ معدودة:
كيف تحدد المسار الصحيح لإعداد الويب هوك؟
- هل ترغب في إرسال إشعارات من متجرك أو موقعك للعملاء عبر الواتساب؟
القرار: نوع العملية هو استقبال بيانات (Incoming). لا تحتاج لأي خادم وسيط إطلاقاً؛ توجه مباشرة لقسم HookURL أو القوالب وانسخ الرابط المجاني المولد سحابياً وضعه في متجرك. - هل ترغب في سحب رسائل العملاء الواردة ونقلها إلى برمجياتك الخاصة أو قاعدة بياناتك؟
القرار: نوع العملية هو تصدير بيانات (Outgoing). تحتاج إلى برمجة Endpoint على خادمك أو عبر n8n، ثم وضع رابطه داخل قسم الويب هوك المخصص في المنصة لبدء استقبال الأحداث.
دليل الربط العملي لأشهر منصات التجارة الإلكترونية
يتيح تطبيق مسار الاستقبال المدمج ربط المتاجر وإطلاق الإشعارات دون المساس بالأكواد البرمجية للموقع. فيما يلي الإجراءات الفنية الدقيقة لتفعيل الويب هوك على المنصات الأكثر انتشاراً:
خطوات ضبط الويب هوك لمتجر Shopify
تشترط منصة Shopify معايير محددة لضمان استقرار العناوين البرمجية واستجابتها الفورية لحزم البيانات. لربط متجرك بواتساب بنجاح:
- ادخل إلى حسابك في Whats360 ← توجه إلى قسم الويب هوك واختر قالب Shopify، أو انسخ الرابط الخاص برقم هاتفك من واجهة HookURL.
- انتقل إلى لوحة تحكم متجر شوبيفاي، واضغط على تبويب الإعدادات (Settings) أسفل القائمة، ثم اختر الإشعارات (Notifications).
- مرر الشاشة لأسفل حتى تصل إلى قسم Webhooks واضغط على زر إنشاء ويب هوك (Create Webhook).
- اضبط الحقول بالقيم التالية:
- الحدث (Event): اختر نوع المعاملة مثل إنشاء الطلب (`Order creation`) لإرسال رسائل التأكيد الفوري، أو دفع الطلب (`Order payment`).
- الصيغة (Format): حدد خيار `JSON` بشكل إلزامي.
- الرابط (URL): الصق رابط الاستقبال السحابي المنسوخ من منصة Whats360.
- إصدار واجهة الويب هوك: اعتمد الإصدار المستقر الموصى به من المنصة.
- احفظ الإعدادات. سيقوم شوبيفاي بإرسال طلب فحص فوري للتأكد من جاهزية العنوان للعمل.
{
“id”: 820982911946154508,
“order_number”: 1234,
“total_price”: “199.00”,
“customer”: {
“first_name”: “Mahmoud”,
“phone”: “+201030741766”
}
}
خطوات ضبط الويب هوك لمتجر WooCommerce
إذا كانت عملياتك التجارية تدار عبر نظام إدارة المحتوى WordPress وإضافة التجارة الإلكترونية WooCommerce، فإن عملية التفعيل تجري برمجياً عبر الخطوات التالية:
- توجه للوحة تحكم ووردبريس ← اضغط على قائمة WooCommerce ثم ادخل إلى الإعدادات (Settings).
- انتقل إلى التبويب المتقدم (Advanced) في أقصى اليسار، ثم اضغط على الروابط الفرعية لـ Webhooks.
- اضغط على زر إضافة ويب هوك جديد (Add webhook)، واملأ الخانات كالتالي:
- الاسم (Name): سجل اسماً دالاً على الوظيفة، مثل إشعارات طلبات واتساب.
- الحالة (Status): حوّل الحالة مباشرة إلى نشط (Active).
- الموضوع (Topic): حدد الحدث المطلوب مثل `Order created` أو `Order updated`.
- رابط التسليم (Delivery URL): الصق رابط الاستقبال المستخرج من قسم القوالب أو HookURL داخل Whats360.
- الرمز السري (Secret): أدخل رمز الحماية المخصص لمطابقته مع إعدادات المنصة.
- اضغط على حفظ الويب هوك (Save Webhook). سيقوم متجرك بإجراء اختبار اتصال شبكي والتفعيل الفوري.
ربط المنصات المحلية وبوابات السداد الإقليمية
تتوافق روابط الاستقبال السحابية بالكامل مع المنصات العربية الرائدة كمنصة سلة ومنصة زد. يتيح ربط الـ Endpoints السحابية بهذه المنصات تأكيد طلبات الدفع عند الاستلام لمواجهة ظاهرة رفض الشحنات وتفادي الخسائر اللوجستية، ومتابعة السلات المتروكة بدقة ترفع معدلات استرداد العملاء. كما يمكن تفعيل الويب هوك للتحقق الفوري من إشعارات تسليم المدفوعات والتحويلات عبر خدمات المحافظ الرقمية وحلول الدفع مثل منصة EGCash لتسريع تسليم الطلبات الرقمية فور التحصيل.
باقة تجار التجزئة والتجارة الإلكترونية
ضاعف أرباح متجرك الإلكتروني عبر أتمتة رسائل تأكيد الشراء واستعادة السلات المتروكة ومتابعة الشحنات تلقائياً عبر الواتساب بدون أي تكاليف سيرفرات خارجية مع استقرار تام 24/7.
- ربط مباشر وشامل مع شوبيفاي، سلة، زد، وووكومرس
- إرسال رسائل التتبع والفواتير بروابط تفاعلية سريعة
- حملات إعادة استهداف ذكية لرفع معدلات الشراء المكرر
بروتوكول الأمان وتفادي التعطيل التلقائي لروابط الويب هوك
يتطلب تشغيل الويب هوك في بيئات العمل التجارية الالتزام بالقواعد الهندسية للشبكات لمنع انقطاع تدفق الإشعارات وحماية الخوادم من الهجمات والاختراقات:
تأمين الطلبات عبر مفاتيح التحقق والتشفير
لمنع انتحال الشخصية أو إرسال حزم عشوائية للرابط، تدعم المنصة تأمين المسارات البرمجية عبر الهيدر المخصص X-Hook-Secret:
- عند إنشاء الرابط في واجهة HookURL، يمكنك إدخال مفتاح سري عشوائي ومعقد.
- يلتزم المتجر أو النظام الخارجي بتمرير هذا المفتاح في ترويسة الطلب؛ وإذا وصل الطلب بدون المفتاح المطابق، ترفضه الخوادم فورياً لحماية الحساب من الاستهلاك غير الشرعي.
- يدعم النظام التحقق التلقائي من بصمة التشفير الخاصة بمتاجر شوبيفاي والممررة عبر هيدر
X-Shopify-Hmac-Sha256للتأكد من أن الحدث وارد رسمياً من خوادم شوبيفاي المعتمدة حصراً.
معضلة المهلة الزمنية وقاعدة رد النجاح الفوري 200 OK
تعتمد المتاجر الكبرى سياسة الإيقاف الوقائي للويب هوك (Webhook Auto-Deactivation) عند حدوث أي خلل في سرعة استجابة الرابط:
- إذا أرسل المتجر بيانات الطلب ولم يستقبل رداً رقمياً بنجاح العملية (HTTP Status
200 OK) خلال مهلة ضيقة (تتراوح بين 5 إلى 10 ثوانٍ)، يفترض المتجر أن الخادم المستمع قد تعطل. - يعيد المتجر إرسال الحزمة بفواصل زمنية تصاعدية؛ وإذا استمر غياب الرد، يقوم المتجر بإيقاف الويب هوك تلقائياً وتتوقف الرسائل عن الوصول للمشترين.
- تتفادى المنصة هذه المعضلة عبر معمارية المعالجة غير المتزامنة (Asynchronous Queue Architecture)، حيث تقوم خوادم الاستقبال بتسجيل الحزمة والرد على المتجر فوراً بكود 200 OK خلال أجزاء من الثانية، ثم تتولى طوابير المهام الداخلية تنسيق وتوجيه الرسائل للعملاء، مما يمنع إيقاف الويب هوك في متجرك نهائياً.
مراقبة حالة اتصال الأجهزة وتنبيهات الطوارئ
يرتبط إرسال الرسائل الصادرة بوجود جلسة واتساب متصلة ونشطة في المنصة. عند حدوث أي انقطاع بالهاتف أو تغيير في رمز الربط:
- تحتفظ المنصة بالأحداث في طوابير انتظار ذكية لمنع ضياع المعاملات أثناء فترات إعادة الاتصال.
- يُنصح المطورون بربط تنبيهات البريد السحابية الفورية باستخدام خدمات بريد متقدمة مثل UltraMail لتلقي إشعارات انقطاع الجلسة على الفور وإعادة ربط الهاتف دون تأخير وصول الرسائل للعملاء.
تنبيه فني لتفادي أخطاء تنسيق الأرقام
تأكد دائماً من أن الحقول المسحوبة من متجرك الإلكتروني تتضمن مفتاح الدولة الدولي (صيغة E.164 الدولية المعتمدة مثل +20 أو +966). يوفر محرك القوالب في المنصة خاصية إضافة المفتاح الافتراضي تلقائياً في حال قام العميل بكتابة هاتفه المحلي فقط، مما يمنع فشل تسليم الرسائل بسبب أخطاء الصيغ الرقمية.
الأسئلة الشائعة حول تشغيل الويب هوك في Whats360
خلاصة عملية لتسريع الأتمتة
فهم الاتجاه الهندسي لتدفق المعاملات يلغي الغموض ويحمي مواردك التقنية والمالية. لتلخيص المسار في جملتين حاسمتين:
- لربط متاجرك الرقمية وإطلاق إشعارات المبيعات: لا تبحث عن خوادم، بل ادخل فوراً إلى حسابك في Whats360، انسخ رابطك السحابي المجاني من قسم HookURL أو قسم القوالب، وضعه في إعدادات متجرك ليبدأ الإرسال تلقائياً.
- لبناء تكاملات خارجية وأرشفة رسائل الواتساب الواردة: هنا فقط تقوم ببرمجة مسارك الخاص على سيرفرك أو أدواتك المفضلة، وتضعه في قسم إرسال البيانات في المنصة لبدء الاستماع للأحداث.
يمكنك التوسع في استكشاف أحدث الحلول الرقمية، وتطوير منصاتك التجارية بالتعاون مع منصة البرمجيات المتطورة Beincode أو مراجعة أدوات نمو التجارة الرقمية عبر منصة Toggaar لدعم توسع أعمالك التقنية المستمر.
ابدأ أتمتة إشعارات متجرك بواتساب خلال 5 دقائق
وفر تكاليف الخوادم وتوقف عن المعالجة اليدوية للطلبات. جرب الروابط السحابية الجاهزة في Whats360 الآن وتواصل فورياً مع عملائك على القناة الأكثر استخداماً عالمياً.
