حقول خطاف الويب (webhook) لصفحات Facebook: القائمة الكاملة
تُوثّق صفحة مرجع خطاف الويب (webhook) الخاصة بصفحات Meta 64 حقل اشتراك: feed للمنشورات والتعليقات والتفاعلات، وmention للإشارات إلى الصفحة، وحقول Messenger مثل messages وmessage_echoes وmessaging_postbacks وmessage_reads، وحقول الملف الشخصي مثل name وpicture وhours وwebsite. يحتاج كل منها إلى pages_manage_metadata، ولا يستقبل التطبيق حقلاً إلا إذا اشترك فيه على مستوى التطبيق، واشتركت الصفحة فيه عبر subscribed_apps.
يشترك easyCoexistence في feed وmessages وmention لكل صفحة تربطها، ويحوّل تلك الأحداث إلى endpoint الخاص بك عبر HTTPS فور وصولها، موقعة بـ X-EC-Signature، بينما تعمل قواعد التعليقات والأتمتة على التعليقات الجديدة والرسائل.
حقول الاشتراك الموثقة في صفحة مرجع webhook الخاصة بصفحات Meta، من feed وmention إلى حقول Messenger وحقول الملف الشخصي.
الصلاحية التي يجب أن يمنحها مشرف الصفحة الذي يملك صلاحيات MODERATE قبل أن تصل webhooks الصفحة إلى التطبيق.
حقل Messenger منفصل للرسائل التي ترسلها الصفحة، ويتوفر فقط لمحادثات Messenger.
المهمة المطلوبة على الصفحة للاشتراك في leadgen تتطلب الصلاحيات leads_retrieval وads_management وpages_read_engagement وpages_manage_metadata، وهي صلاحيات مطلوبة كلها.
لا تُنتج webhooks إلا الحقول المشترك فيها على مستوى الصفحة والتطبيق معاً.
كيف تنقسم حقول webhook الخاصة بالصفحة؟
توثّقها Meta في صفحة مرجعية واحدة لكائن الصفحة، وتنقسم إلى ثلاث فئات: النشاط على الصفحة وحولها، ومحادثات Messenger، والتعديلات على تفاصيل الصفحة نفسها. تصل تغييرات feed وmention والملف الشخصي في entry.changes، ويُذكر فيها اسم كل حقل، أو في changed_fields عندما يوقف التطبيق خيار Include Values. أما أحداث Messenger فتصل في entry.messaging، أو في entry.standby بالنسبة إلى تطبيق لا يملك المحادثة.
أي الحقول تسجّل النشاط على الصفحة؟
تغطي 12 حقلاً المحتوى والنشاط لا المحادثات. فالتعليق الجديد مثلاً يصل عبر feed كتغيير تكون فيه القيمة item هي comment والقيمة verb هي add، إلى جانب التفاعلات والمشاركات ومنشورات الصفحة نفسها. وفيما يلي ما يقدمه كل حقل بحسب المرجع:
أي الحقول تحمل أحداث Messenger؟
لدى Messenger أطول قائمة، ويوضح دليل webhook الخاص بـ Messenger لدى Meta ما يرسله كل حقل. وتغطي هذه الحقول الثلاثة عشر محادثات الصفحة، أما standby، الذي يحمل الرسائل إلى تطبيق لا يملك المحادثة، فهو موثّق في ذلك الدليل لا في مرجع الصفحة:
ما حقول Messenger الأخرى؟
عشرة حقول أخرى تخدم منتجات بعينها، من الاتصال الصوتي إلى التجارة وتقارير النزاهة:
send_cart: رسالة تحمل معلومات السلة أو الطلب؛message_context: الكشوفات التي تجريها نماذج Meta على رسالة، مع اسم الحدث ودرجته.- calls و
call_settings_updateوcall_permission_reply: مكالمات Messenger الصوتية، وتغييرات إعدادات اتصال الصفحة، ورد الشخص على طلب إذن الاتصال. messaging_customer_information: ما يدخله الشخص في شاشة معلومات العميل؛messaging_in_thread_lead_form_submit: نموذج عميل مُرسل داخل المحادثة.message_template_status_update: تغيّرت حالة مراجعة قالب رسالة خدمية.business_integrityوmessaging_integrity: تحديثات النزاهة، مع أحداث المخالفات والقيود والإجراءات ضمنbusiness_integrity.
أي الحقول تتابع تغييرات ملف الصفحة الشخصي؟
تغطي 29 حقلاً تعديلات تفاصيل الصفحة نفسها، حقل لكل تفصيلة، ويصل كل منها كتغيير يُذكر اسمه:
- الهوية: name وpicture وcategory، وهو يقبل حتى ثلاث فئات، وdescription، أي Story Description.
- تفاصيل النشاط:
company_overviewوmission وfounded وproducts وgeneral_infoوgeneral_managerوmembers وawards وaffiliation. - التواصل والمكان: email وphone وwebsite وlocation وhours و
current_locationوhometown وparking وpublic_transit. - المكان العام:
price_rangeوpayment_optionsوattire وculinary_team. - الشخصي: birthday و
personal_infoوpersonal_interests.
أي صلاحية يحتاجها كل حقل؟
pages_manage_metadata لأيٍّ منها، ويمنحها مشرف الصفحة الذي يملك صلاحيات MODERATE، وتحتاج بعضها صلاحيات أخرى. تُشترك الصفحة عبر subscribed_apps، وتحدد أدلة Meta رمز الوصول (token) والصلاحيات لكل نوع من الحقول. ولاستقبال أحداث تخص أشخاصاً خارج أدوار التطبيق، يلزم أيضاً Advanced Access لتلك الصلاحيات.
| Permissions | Task of the person behind the token | |
|---|---|---|
| Any field | pages_manage_metadata and pages_show_list | CREATE_CONTENT, MANAGE or MODERATE |
| messages and other Messenger fields | pages_messaging as well | MESSAGING |
| leadgen | leads_retrieval, pages_read_engagement and ads_management as well | ADVERTISE |
أي حقول يشترك فيها easyCoexistence؟
ثلاثة حقول: feed وmessages وmention. عند ربط صفحة، يرسل easyCoexistence طلب POST /{page-id}/subscribed_apps بهذه الحقول ورمز token الخاص بالصفحة، ثم يحوّل كل entry لتلك الصفحة إلى نقطة النهاية (endpoint) التي تحددها، موقعاً بالترويسة X-EC-Signature. تعمل قواعد التعليقات والأتمتة على التعليقات الجديدة من feed وعلى الرسائل، وتُحوَّل الإشارات كما هي. لا يُشترك في أي حقل آخر، لذا لا تُحوَّل echoes ولا postbacks ولا receipts ولا handovers ولا standby ولا تغييرات الملف الشخصي.
الأخطاء الشائعة
- اشتراك الصفحة في حقل لم يشترك فيه التطبيق. لا تُسلّم Meta إلا الحقول المشترك فيها على مستوى الصفحة والتطبيق معاً.
- معالجة أحداث Messenger كتغييرات. فهي تصل في entry.messaging، بكائن messaging واحد لكل entry، لا في entry.changes.
- توقّع ردود الصفحة نفسها على الرسائل. الرسائل التي ترسلها الصفحة تصل عبر message_echoes، وهو حقل منفصل.
- الاعتماد على feed لعدد الإعجابات في الصفحات الكبيرة. ترسل Meta إشعارات الإعجاب للصفحات التي لديها أقل من 10,000 إعجاب فقط.
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يتضمن حقل feed التعليقات على الإعلانات؟
نعم. لا ترسل Meta شيئاً عن منشورات الإعلانات نفسها، لكن التعليقات عليها تصل عبر feed.
ماذا يغيّر إعداد Include Values؟
عند تفعيله، يحمل التغيير القيم الجديدة في changes. وعند إيقافه، ترسل Meta أسماء الحقول المتغيرة فقط في changed_fields.
كيف أرى الحقول التي تشترك فيها صفحة ما؟
يعرض الطلب GET /{page-id}/subscribed_apps مع token الصفحة التطبيقات المثبتة عليها، ويعرض لكل تطبيق منها subscribed_fields الخاص به.
هل يحوّل easyCoexistence تغييرات الملف الشخصي للصفحة؟
لا. الصفحات المرتبطة بـ easyCoexistence مشترَكة في feed وmessages وmention فقط، لذا لا تُحوَّل name وpicture والحقول الأخرى في الملف الشخصي.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في