Webhooks

مقدمة

تتيح لك webhooks تلقي إشعارات HTTP على خادمك عند حدوث أحداث مهمة، مثل:

• إنشاء حجز جديد
• إلغاء حجز
• اكتمال دفع
• تسجيل عميل جديد

بدلاً من الاستعلام الدوري للواجهة (polling)، يتلقى خادمك البيانات تلقائياً عند حدوث الأحداث.

الإعدادات

كوّن webhooks من لوحة التحكم:

1. اذهب إلى الإعدادات → التكاملات
2. في قسم Webhooks, انقر على إضافة Webhook
3. أدخل عنوان URL لنقطة النهاية (يجب أن يكون HTTPS)
4. اختر الأحداث التي تريد تلقيها
5. احفظ وانسخ Secret للتحقق من التوقيعات

تنسيق البيانات

يتضمن كل webhook البنية التالية:

{
    "id": "evt_abc123xyz789",
    "type": "booking.created",
    "created": "2024-01-20T10:30:00Z",
    "tenant_id": "uuid-del-tenant",
    "data": {
        // بيانات الحدث (تختلف حسب النوع)
    }
}

حقول webhook

رؤوس الطلب

يتضمن كل webhook هذه الرؤوس:

الاستجابة المتوقعة

يجب أن يستجيب خادمك برمز 2xx (200، 201، 202، 204) للإشارة إلى أن webhook تم استلامه بشكل صحيح.

HTTP/1.1 200 OK
Content-Type: application/json

{"received": true}

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

إذا لم يستجب خادمك أو أعاد خطأ (4xx أو 5xx)، نعيد المحاولة تلقائياً:

بعد 5 محاولات فاشلة، يتم تعليم webhook كفاشل ولا تتم إعادة المحاولة. يمكنك رؤية webhooks الفاشلة في لوحة التحكم.

الخطوات التالية