إنتقل إلى المحتوى الرئيسي

الويب هوكس

تتيح لك الويب هوكس إرسال إشعارات من Scrollengine إلى أنظمتك الخارجية في الوقت الفعلي عند حدوث أحداث معينة. استخدمها لبناء تكاملات مخصصة أو أتمتة سير العمل أو مزامنة البيانات مع أدوات أخرى.

ما هي الويب هوكس​

الويب هوك هو طلب HTTP POST يُرسل إلى عنوان URL تحدده كلما حدث حدث معين في Scrollengine. يستقبل خادمك بيانات الحدث ويمكنه التصرف بناءً عليها.

أحداث الويب هوكس المتاحة​

الحدثالمُحفِّز
order.createdتم تقديم طلب توصيل جديد
order.updatedتغيير تفاصيل الطلب أو حالته
order.deliveredتم تحديد الطلب كـ "تم التوصيل"
order.cancelledتم إلغاء الطلب
route.createdتم إنشاء مسار جديد
route.startedبدأ السائق المسار
route.completedتم إنجاز جميع المحطات في المسار
driver.assignedتم تعيين سائق لطلب أو مسار

إعداد ويب هوك​

  1. انتقل إلى الإعدادات > التكاملات > الويب هوكس
  2. انقر على إضافة ويب هوك
  3. أدخل:
    • عنوان URL — نقطة النهاية على خادمك التي ستستقبل الويب هوك
    • الأحداث — حدد الأحداث التي تريد الاشتراك فيها
    • المفتاح السري — مفتاح سري مشترك للتحقق من صحة الويب هوك
  4. انقر على حفظ

محتوى الويب هوك​

يتم إرسال الويب هوكس كطلبات HTTP POST بجسم JSON:

{
  "event": "order.delivered",
  "timestamp": "2026-03-13T14:30:00Z",
  "data": {
    "order_id": "12345",
    "shopify_order_id": "98765",
    "delivery_method": "local_delivery",
    "status": "delivered",
    "driver": {
      "id": "d-001",
      "name": "John Driver"
    }
  }
}

التحقق من الويب هوكس​

يتضمن كل ويب هوك ترويسة توقيع للتحقق:

  1. يوقّع Scrollengine المحتوى باستخدام مفتاحك السري المشترك
  2. يتم تضمين التوقيع في ترويسة X-Scrollengine-Signature
  3. يجب على خادمك التحقق من التوقيع قبل المعالجة

سياسة إعادة المحاولة​

إذا أعاد نقطة النهاية الخاصة بك رمز حالة غير 2xx:

  • يعيد Scrollengine المحاولة حتى 3 مرات
  • تستخدم إعادة المحاولة تأخيرًا أسيًا (1 دقيقة، 5 دقائق، 30 دقيقة)
  • بعد 3 إخفاقات، يتم تحديد الويب هوك كفاشل
  • ستتلقى إشعارًا لإصلاح نقطة النهاية الخاصة بك

حالات الاستخدام​

  • المزامنة مع نظام ERP — إرسال بيانات التوصيل إلى نظام المخزون أو المحاسبة
  • إشعارات مخصصة — تفعيل رسائل SMS أو Slack أو تنبيهات أخرى
  • التحليلات — تغذية أحداث التوصيل إلى منصة التحليلات الخاصة بك
  • لوجستيات الطرف الثالث — إخطار شركات النقل أو الشركاء الخارجيين