تكامل Webhook

تتيح لك webhooks أن تتلقى أنظمتك إشعارات فورية عند حدوث أحداث في حساب Wink الخاص بك — مثل الحجوزات الجديدة، الإلغاءات، تحديثات الدفع، والمزيد. يوجهك هذا الدليل خلال الإعداد وأفضل الممارسات.

الجمهور

هذا الدليل موجه للمطورين الذين يدمجون Wink مع أنظمة خارجية مثل أنظمة إدارة العقارات (PMS)، مديري القنوات، أنظمة إدارة علاقات العملاء (CRM)، أو لوحات تحكم مخصصة.

كيف تعمل webhooks

تقوم بتسجيل عنوان URL الخاص بالـ webhook على Wink.
عند حدوث حدث (مثل حجز جديد)، يرسل Wink طلب HTTP POST إلى عنوان URL الخاص بك.
يعالج خادمك الحمولة ويرد بـ 200 OK.

إعداد webhook

سجّل الدخول إلى حسابك (Extranet، Studio، أو TripPay — جميعها تدعم webhooks).
انتقل إلى Applications ثم Webhooks. راجع Webhooks.
انقر على Create webhook.
أدخل اسمًا (مثلاً “مزامنة حجز PMS”).
أدخل عنوان URL الخاص بالـ webhook — نقطة النهاية HTTPS على خادمك.
اختر الأحداث — اختر الأحداث المحددة للاشتراك بها، أو اتركها فارغة لتلقي جميع الأحداث.
فعّل خيار Enabled.
انقر على Save.

أنواع الأحداث

يدعم Wink مجموعة متنوعة من أنواع الأحداث. تشمل الأحداث الشائعة:

تم إنشاء الحجز — تم تأكيد حجز جديد.
تم إلغاء الحجز — تم إلغاء حجز.
اكتمل الدفع — تم معالجة الدفع.
تم تحديث الحجز — تغيرت تفاصيل الحجز.

أفضل الممارسات

استخدم HTTPS — يرسل Wink الحمولة إلى نقاط نهاية HTTPS فقط.
استجب بسرعة — أعد 200 OK بمجرد استلام الحمولة. قم بأي معالجة ثقيلة بشكل غير متزامن.
الاستمرارية (Idempotency) — يجب أن يكون المعالج الخاص بك idempotent. قد يعيد Wink محاولة التسليم إذا لم يتلقَ رد 200.
تحقق من المصدر — تحقق من أن الطلبات الواردة من Wink قبل المعالجة.
التسجيل — سجّل كل حمولة webhook تستلمها. هذا يسهل كثيرًا من عملية تصحيح أخطاء التكامل.

الإيقاف المؤقت والحذف

يمكنك تعطيل webhook دون حذفه. هذا يوقف التسليم مؤقتًا حتى تتمكن من استكشاف الأخطاء دون فقدان الإعدادات. عندما تكون جاهزًا، فعّله مرة أخرى.

حذف webhook يزيله نهائيًا. أي تكامل يعتمد على هذا webhook سيتوقف عن تلقي الإشعارات.

قراءة إضافية

Webhooks — المرجع الكامل لإدارة webhooks.
Applications — إدارة بيانات اعتماد API الخاصة بك.
Developers > APIs — التوثيق الكامل لواجهة برمجة التطبيقات.