تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

حقول خطاف الويب (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، بينما تعمل قواعد التعليقات والأتمتة على التعليقات الجديدة والرسائل.

64

حقول الاشتراك الموثقة في صفحة مرجع webhook الخاصة بصفحات Meta، من feed وmention إلى حقول Messenger وحقول الملف الشخصي.

pages_manage_metadata

الصلاحية التي يجب أن يمنحها مشرف الصفحة الذي يملك صلاحيات MODERATE قبل أن تصل webhooks الصفحة إلى التطبيق.

message_echoes

حقل Messenger منفصل للرسائل التي ترسلها الصفحة، ويتوفر فقط لمحادثات Messenger.

ADVERTISE

المهمة المطلوبة على الصفحة للاشتراك في leadgen تتطلب الصلاحيات leads_retrieval وads_management وpages_read_engagement وpages_manage_metadata، وهي صلاحيات مطلوبة كلها.

Both levels

لا تُنتج webhooks إلا الحقول المشترك فيها على مستوى الصفحة والتطبيق معاً.

كيف تنقسم حقول webhook الخاصة بالصفحة؟

توثّقها Meta في صفحة مرجعية واحدة لكائن الصفحة، وتنقسم إلى ثلاث فئات: النشاط على الصفحة وحولها، ومحادثات Messenger، والتعديلات على تفاصيل الصفحة نفسها. تصل تغييرات feed وmention والملف الشخصي في entry.changes، ويُذكر فيها اسم كل حقل، أو في changed_fields عندما يوقف التطبيق خيار Include Values. أما أحداث Messenger فتصل في entry.messaging، أو في entry.standby بالنسبة إلى تطبيق لا يملك المحادثة.

أي الحقول تسجّل النشاط على الصفحة؟

تغطي 12 حقلاً المحتوى والنشاط لا المحادثات. فالتعليق الجديد مثلاً يصل عبر feed كتغيير تكون فيه القيمة item هي comment والقيمة verb هي add، إلى جانب التفاعلات والمشاركات ومنشورات الصفحة نفسها. وفيما يلي ما يقدمه كل حقل بحسب المرجع:

feedNearly all changes to the Page's feed: posts, comments, reactions, shares; likes only below 10,000 likes
mentionNew mentions of the Page in posts and comments; some IDs it returns cannot be queried
ratingsNew ratings, and comments or reactions on a rating
videosChanges to the encoding status of a video on the Page
live_videosChanges to a live video's status, with its ID
leadgenNew leads from the Page's lead ads, with leadgen_id, form_id and ad_id
group_feedComments on the Page's posts in the business's Facebook Group
product_reviewA product item's review status: pending, approved, rejected or outdated
inbox_labelsLabel changes on people in the Page inbox: the user, the action and the label
page_upcoming_changeUpcoming changes to the Page, with their type and effective time
page_change_proposalProposals to change the Page, created, accepted or rejected
invoice_access_invoice_draft_changeChanges to an invoice draft, such as its shipping address

أي الحقول تحمل أحداث Messenger؟

لدى Messenger أطول قائمة، ويوضح دليل webhook الخاص بـ Messenger لدى Meta ما يرسله كل حقل. وتغطي هذه الحقول الثلاثة عشر محادثات الصفحة، أما standby، الذي يحمل الرسائل إلى تطبيق لا يملك المحادثة، فهو موثّق في ذلك الدليل لا في مرجع الصفحة:

messagesA message from a person, through any entry point, with text or attachments
message_echoesA message the Page sent, with the app_id of the app that sent it
message_deliveriesA message from the Page was delivered
message_readsThe person read a message from the Page
message_reactionsThe person reacted to a message from the Page
message_editsThe person edited a message they had sent
messaging_postbacksA tap on a postback button, Get Started or a persistent menu item
messaging_referralsThe person came back to the conversation through an m.me link or an ad
messaging_optinsA Messenger plugin click, an accepted message request or a checkbox opt-in
messaging_handoversThread control passed, taken or requested between apps
messaging_policy_enforcementA policy warning, block or unblock on the Page's messaging
messaging_account_linkingThe person linked or unlinked their account with the business
response_feedbackFeedback buttons, such as thumbs up or down, on a message the Page sent

ما حقول 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 لتلك الصلاحيات.

PermissionsTask of the person behind the token
Any fieldpages_manage_metadata and pages_show_listCREATE_CONTENT, MANAGE or MODERATE
messages and other Messenger fieldspages_messaging as wellMESSAGING
leadgenleads_retrieval, pages_read_engagement and ads_management as wellADVERTISE

أي حقول يشترك فيها 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 إعجاب فقط.
إنجاز ذلك باستخدام EasyCoexistence

من 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 والحقول الأخرى في الملف الشخصي.

تابع القراءة

التحقق من خطاف الويب (webhook) في Facebook: hub.challenge و X-Hub-Signature-256التحقق من webhook على Facebook: إعادة hub.challenge عند تطابق hub.verify_token، ثم فحص X-Hub-Signature-256 لكل حدث بمفتاح App Secret الخاص بالتطبيق.الاشتراك في خطاف الويب (webhook) لصفحة فيسبوك: الحافة subscribed_appsكيف تشترك صفحة فيسبوك في webhook عبر POST /{page-id}/subscribed_apps: الرموز والمهام، والاشتراك على مستوى التطبيق، والتحقق والإزالة.خطاف الويب (webhook) لـ feed صفحة Facebook: أحداث التعليقات والمنشورات والتفاعلاتما يرسله خطاف feed صفحة Facebook للتعليقات والمنشورات والتفاعلات: حقلا item وverb، وشكل الحمولة في Meta، وكيفية اشتراك الصفحة.خطاف الويب (webhook) لـ Messenger في صفحات Facebook: الرسائل وأحداث الإشاراتحقول webhook الخاصة بصفحات Facebook لرسائل Messenger والإشارات: شكل الحمولة ومعرّفات المرسلين والمرفقات، وكيف تصل الأحداث إلى نقطة النهاية الخاصة بك.واجهة برمجة التطبيقات (API) للملف الشخصي في Messenger: التحية وزر Get Started وكاسرات الجليد والقائمة الثابتةحدّد الملف الشخصي لصفحة Facebook في Messenger عبر /{page-id}/messenger_profile: زر Get Started والتحية وكاسرات الجليد والقائمة الثابتة والأوامر.قراءة سجل محادثات Messenger عبر واجهة برمجة التطبيقات (API)اقرأ سجل محادثات صفحة Facebook في Messenger عبر Conversations API: المسارات والحقول وحد الرسائل العشرين والأذونات.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في