Webhooks

نظرة عامة

تمكّن أحداث Webhooks تطبيقات الدمج المخصص من الاشتراك في الأحداث الموجودة في Workplace وتلقي تحديثات فورية. وعند حدوث أي تغيير في Workplace، يتم إرسال طلب HTTPS POST إلى عنوان URL للاستدعاء لكل تطبيق دمج مخصص مشترك في موضوع webhook ذي الصلة.

هذا يجعل التطبيقات أكثر كفاءة، لأنها تعرف بالضبط متى حدث التغيير ولا تحتاج إلى الاعتماد على طلبات واجهة Graph API المستمرة أو الدورية للحصول على أحدث محتوى.

يتم توفير دعم Webhook لـ Workplace بواسطة إطار العمل نفسه الذي يدير أحداث Webhooks في Facebook.

الاشتراك في موضوعات Webhook

يوفر مربع الحوار تعديل الدمج المخصص علامات تبويب لكل موضوع من موضوعات webhook المتوفرة لدى التطبيقات على Workplace.

علامة التبويب أحداث Webhooks في مربع الحوار "تعديل الدمج المخصص"

لإضافة اشتراك webhook جديد حول موضوع محدد، قم بتوفير عنوان URL للاستدعاء ورمز التحقق ثم حدّد حقول الاشتراك التي تحتاج إليها لدعم الوظائف التي سيوفرها تطبيقك.

لا يمكنك سوى الاشتراك في عنوان URL واحد لكل موضوع webhook، ولكن يمكنك استخدام عنوان URL نفسه لموضوعات متعددة.

معالجة طلبات التحقق من الصحة

عند إضافة اشتراك جديد أو تعديل اشتراك موجود بالفعل، ستُجري خوادم Facebook طلب GET لعنوان URL الاستدعاء لديك للتحقق من صلاحية خادم الاستدعاء.

سيتم إلحاق سلسلة استعلام بعنوان URL هذا مع تضمين المعلمات التالية:

hub.mode - يتم إدخال السلسلة "subscribe" في هذه المعلمة
hub.challenge - سلسلة عشوائية
hub.verify_token - قيمة verify_token التي حددتها عند إنشاء الاشتراك

عند تلقي طلب HTTP GET في عنوان URL الاستدعاء، يمكنك استخدام المعلمة verify_token للتحقق من أن الطلب يأتي من جانب خادم فيسبوك.

أمان Webhook

يتم إجراء كل استدعاءات webhook لعناوين URL للاستدعاء المحددة بواسطة المطوّر عبر HTTPS، مما يضمن أمانًا على مستوى النقل لحمولات بيانات webhook.

لتوفير مستوى إضافي من الأمان، يتم تضمين X-Hub-Signature-256 لعنوان HTTP في كل حمولة بيانات POST، والذي يجب عليك استخدامه للتحقق من أن حمولة البيانات مصدرها خادم فيسبوك.

للحصول على تفاصيل كاملة حول هذا السلوك، ارجع إلى وثائق إطار عمل Webhook في فيسبوك.

موضوعات Webhook

يتم تجميع النشاط على Workplace في الموضوعات. ويتضمن كل موضوع عدد من الحقول التي ترتبط بأحداث تتعلق بموضوع محدد. يمكن للتطبيقات الاشتراك في تحديثات webhook حول كل موضوع ولحقول محددة ضمن كل موضوع.

توفر Workplace حاليًا webhooks للموضوعات والمجموعات التالية:

الصفحة

تتوفر المزيد من المعلومات في المستندات المرجعية لموضوع الصفحة.

حقل الاشتراك	السلوك
`mention`	يتم التشغيل عند ذكر صفحة دمج مخصص (برنامج تلقائي) في مجموعة.
`messages`	يتم التشغيل عند مراسلة صفحة دمج مخصص (برنامج تلقائي) في Work Chat.
`message_deliveries`	يتم التشغيل عند تسليم رسالة مرسلة بواسطة صفحة دمج مخصص (برنامج تلقائي).
`messaging_postbacks`	يتم التشغيل عند الضغط على زر الرد الجاهز في Work Chat.
`message_reads`	يتم التشغيل عندما يقرأ المستلم رسالة من صفحة دمج مخصص (برنامج تلقائي).

المجموعة

تتوفر المزيد من المعلومات في المستندات المرجعية لموضوع المجموعة.

حقل الاشتراك	السلوك
`posts`	يتم التشغيل عند إضافة منشور في مجموعة أو تحديثه أو حذفه.
`comments`	يتم التشغيل في كل مرة تتم فيها إضافة تعليق جديد على منشور في مجموعة أو تحديثه أو حذفه.
`membership`	يتم التشغيل عند تغيير عضوية المجموعة.

المستخدم

تتوفر المزيد من المعلومات في المستندات المرجعية لموضوع المستخدم.

حقل الاشتراك	السلوك
`status`	يتم التشغيل عندما ينشر المستخدم حالة جديدة في الملف الشخصي أو يعدلها.
`events`	يتم التشغيل في كل مرة ينشئ فيها المستخدم حدثًا أو يقبله أو يرفضه.
`message_sends`	يتم التشغيل في كل مرة يرسل فيها المستخدم رسالة Workplace Chat.

الرابط

تتوفر المزيد من المعلومات في مستندات المعاينات التي تمت مصادقتها.

حقل الاشتراك	السلوك
`preview`	يتم تشغيله عندما يحتاج Workplace إلى استرداد معلومات حول عنوان URL.
`collection`	مناسب فقط للتطبيقات الموجودة في قائمة السماح التي تدعم التنقل الهرمي لأداة إنشاء المنشورات.

الأمان

تتوفر المزيد من المعلومات في المستندات المرجعية لموضوع الأمان.

`sessions`

يتم تشغيل الأحداث عندما يسجل شخص ما الدخول أو الخروج من Workplace.

الحدث السلوك

الحدث	السلوك
`log_in`	سجّل المستخدم الدخول إلى Workplace باستخدام كلمة السر أو تسجيل الدخول الأحادي إما على الويب (www) أو تطبيقات الهواتف المحمولة.
`log_out`	سجّل المستخدم الخروج من Workplace باستخدام كلمة السر أو تسجيل الدخول الأحادي إما على الويب (www) أو تطبيقات الهواتف المحمولة. لا يتضمن تسجيل الخروج الإجباري الذي بدأه المسؤول (راجع `admin_force_log_out`)

log_in

سجّل المستخدم الدخول إلى Workplace باستخدام كلمة السر أو تسجيل الدخول الأحادي إما على الويب (www) أو تطبيقات الهواتف المحمولة.

log_out

سجّل المستخدم الخروج من Workplace باستخدام كلمة السر أو تسجيل الدخول الأحادي إما على الويب (www) أو تطبيقات الهواتف المحمولة.

لا يتضمن تسجيل الخروج الإجباري الذي بدأه المسؤول (راجع admin_force_log_out)

`passwords`

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

الحدث	السلوك
`password_change`	تم تغيير كلمة سر المستخدم نتيجة لاستكمال استرداد كلمة السر أو عبر إعدادات حسابه.
`password_reset_request`	تم بدء تدفق استرداد كلمة سر المستخدم وتم إرسال رمز إلى عنوان البريد الإلكتروني للمستخدم.
`password_reset_wrong_code`	أدخل مستخدم رمز استرداد غير صحيح لإعادة تعيين كلمة السر.
`password_reset_success`	اكتمل دفق استرداد كلمة سر المستخدم بنجاح.

`admin_activity`

يتم تشغيل الأحداث عند إضافة مسؤول أو إزالته من مجتمع Workplace

الحدث	السلوك
`admin_set_to_unclaimed`	قام المسؤول بتعيين حالة حساب المستخدم إلى غير مُطالب به، من لوحة التحكم أو عبر واجهة API إدارة الحساب.
`admin_force_log_out`	فرض المسؤول على المستخدم تسجيل الخروج عبر كل الأجهزة من لوحة التحكم.
`admin_deactivate`	قام المسؤول بإلغاء تنشيط حساب من لوحة التحكم أو عبر واجهة API إدارة الحساب.
`admin_activate_account`	قام المسؤول بتنشيط حساب من لوحة التحكم أو عبر واجهة API إدارة الحساب.
`force_password_reset`	فرض المسؤول على المستخدم إعادة تعيين كلمة السر الخاصة به من لوحة التحكم.
`admin_create_account`	أنشأ المسؤول حسابًا من لوحة التحكم.

`two_factor`

يتم تشغيل الأحداث عندما يحاول شخص ما تمكين المصادقة الثنائية أو تعطيلها.

الحدث	السلوك
`two_factor_enable`	قام المستخدم بتمكين المصادقة الثنائية من علامة تبويب الإعدادات. ولا يتم تسجيل هذا عندما يؤكد شخص ما على هاتف معين، ولكنه يشير إلى أنه تم تمكين الميزة.
`two_factor_disable`	قام المستخدم بتعطيل المصادقة الثنائية من علامة تبويب الإعدادات. ولا يتم تسجيل هذا عندما يقوم شخص ما بتعطيل ميزة المصادقة الثنائية في هاتف معين، ولكنه يشير إلى أنه تم تعطيل الميزة.