متطلبات: تحتاج إلى موقع واحد على الأقل لإعداد الويب هوك. الويب هوك متاح في جميع الخطط.

الويب هوك (Webhooks)

الويب هوك يتيح لك ربط منصتك بأنظمة خارجية من خلال إرسال إشعارات تلقائية عند حدوث أحداث معينة. يمكنك استخدامها للتكامل مع أنظمة المحاسبة، أو أدوات التسويق، أو أي نظام خارجي.

ما هو الويب هوك؟

عند حدوث حدث معين في منصتك (مثل طلب جديد أو تسجيل عميل)، يقوم النظام بإرسال طلب HTTP يحتوي على بيانات الحدث إلى عنوان URL تحدده أنت. يتيح ذلك لنظامك الخارجي التفاعل مع الحدث تلقائياً.

إنشاء ويب هوك

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

الأحداث المتاحة

• طلب جديد: عند تقديم طلب في المتجر أو المطعم.
• تحديث حالة الطلب: عند تغيير حالة أي طلب.
• عميل جديد: عند تسجيل عميل جديد.
• إرسال نموذج: عند استلام إرسال نموذج من أحد المواقع.
• دفعة مكتملة: عند إتمام عملية دفع بنجاح.

التحقق من التوقيع

كل طلب يتضمن توقيعاً رقمياً في الترويسة (Header) يمكنك استخدامه للتحقق من أن الطلب صادر من المنصة وليس من مصدر آخر. استخدم المفتاح السري للتحقق من صحة التوقيع.

سجل الويب هوك

يتم الاحتفاظ بسجل لجميع طلبات الويب هوك المرسلة مع حالة الاستجابة، مما يساعدك في تشخيص أي مشاكل في التكامل.