Webhooks - Shifton Help

Webhooks

April 15, 2026 Gary Leman

تتيح Webhooks لـ Shifton إرسال إشعارات في الوقت الحقيقي إلى أنظمة خارجية عند وقوع أحداث في شركتك.

التعليمات خطوة بخطوة

من الشريط الجانبي الأيسر، انقر على التكاملات.

انتقل إلى صفحة مطور → علامة تبويب Webhooks.

انقر «ويب هوك جديد».

املأ الإعدادات:

الحقل	الوصف
URL	نقطة النهاية لتلقي بيانات الأحداث
الأحداث	أحداث Shifton التي تُشغّل الـ webhook
نشط	مفتاح التفعيل/التعطيل

احفظ. سيُرسل Shifton طلبات HTTP POST إلى العنوان المحدد.

انقر على webhook لتعديل العنوان أو تحديث الأحداث أو تغيير حالة النشاط.

أطلق الحدث المقابل في Shifton (مثلاً أنشئ وردية اختبارية).

تحقق من سجلات الخادم — يجب أن تصل البيانات.

س: بأي تنسيق يُرسل نوبةon البيانات؟
HTTP POST بجسم بتنسيق JSON. هيكل البيانات لكل نوع حدث موضّح في توثيق API.

س: هل يمكن إنشاء عدة webhooks لنفس الحدث؟
نعم، بعناوين URL مختلفة.

س: ماذا لو كان الخادم غير متاح عند تشغيل webhook؟
قد يفشل التسليم. تفاصيل سياسة إعادة المحاولة في توثيق API.

س: الـ webhook لا يعمل — لماذا؟
تأكد من تفعيل مفتاح نشط وأن العنوان متاح للعامة.

س: كيف أتحقق من وصول البيانات للـ webhook؟
أنشئ حدثاً اختبارياً في Shifton (مثلاً أضف وردية) وتحقق من سجلات خادمك لوجود طلب POST وارد.

س: هل يمكن إعداد مصادقة للـ webhook؟
نعم. أضف مفتاحاً سرياً أو رمزاً في عنوان أو رؤوس webhook. التفاصيل في توثيق API.

س: كيف يبدو جسم طلب webhook؟
كائن JSON ببيانات الحدث. الهيكل يختلف حسب نوع الحدث — راجع توثيق API للأمثلة.

س: هل يمكن لـ webhook واحد تتبع عدة أحداث؟
نعم. عند إنشاء webhook، اختر عدة أحداث — عنوان واحد يتلقى إشعارات لجميع الأحداث المختارة.

س: ما هي «سياسة إعادة المحاولة» للـ webhook؟
إذا أعاد الخادم خطأ (ليس 200)، قد يُعيد Shifton الطلب. التفاصيل تعتمد على إعدادات المنصة.

س: هل هناك حد لعدد webhooks؟
لا توجد قيود محددة في التوثيق، لكن يُنصح بإنشاء ما هو ضروري فقط.

س: هل يجب استخدام HTTPS لعنوان webhook؟
يُنصح بذلك. عناوين HTTP قد تعمل، لكن HTTPS يضمن نقل آمن للبيانات.

س: هل يمكن تلقي إشعارات webhook عند كل تغيير في الجدول؟
نعم. أضف أحداثاً مثل «تم إنشاء الشيفت» أو «schedule updated» عند إعداد webhook.

س: من يملك صلاحية إنشاء webhooks؟
فقط Owner . المديرون والموظفون لا يرون قسم Developer.

س: هل يمكن تعطيل webhook بدون حذفه؟
نعم. أوقف مفتاح نشط في إعدادات webhook — يتوقف عن العمل لكن يحتفظ بالإعدادات.

س: هل تُسجّل عمليات تشغيل webhook في نوبةon؟
لا تُوفّر سجلات تفصيلية لتسليم webhook في الواجهة. التتبع على جانب خادمك.

س: هل يمكن تصفية webhook حسب المشروع أو الجدول؟
لا. يعمل webhook على جميع أحداث النوع المحدد في الشركة بأكملها. التصفية على جانب الخادم المستقبل.

س: ماذا يحدث للـ webhooks عند حذف الشركة؟
تُحذف جميع webhooks مع الشركة.