خطاف الويب (webhook) لـ feed صفحة Facebook: أحداث التعليقات والمنشورات والتفاعلات
يُبلغ حقل feed في خطافات webhook الخاصة بصفحات Facebook عن معظم التغييرات التي تطرأ على تغذية الصفحة لحظة حدوثها. يحمل كل تغيير الحقل item، مثل post أو comment أو reaction، والحقل verb، مثل add أو edit أو remove، إلى جانب المعرّفات ذات الصلة، والمؤلف في from، والنص في message. ترسل Meta ذلك بصيغة JSON، وتوقّعه بالترويسة X-Hub-Signature-256 ليتسنى التحقق منه.
يشترك easyCoexistence في حقل feed لكل صفحة تربطها، ويعيد توجيه تغييراتها إلى نقطة النهاية HTTPS الخاصة بك فور وصولها، موقّعة بسرّ تلك الصفحة، بينما تعمل قواعد comment-to-DM والأتمتة على التعليقات الجديدة.
ترسل إشعارات الإعجاب بالصفحة فقط للصفحات التي يقل عدد إعجاباتها عن هذا العدد.
حقل feed لا يرسل شيئاً عن منشورات الإعلانات نفسها، لكنه يرسل التعليقات عليها.
الإذن الذي يجب أن يمنحه مدير صفحة يملك صلاحيات MODERATE حتى تصل خطافات الصفحات إلى التطبيق.
تجمّع Meta معظم التحديثات في تسليم webhook واحد، لكنها لا تضمن ذلك.
المدة التي تستمر فيها Meta في إعادة محاولة التسليم الفاشل إلى نقطة النهاية الخاصة بالتطبيق، بوتيرة متناقصة.
ماذا يُبلغ حقل feed؟
معظم التغييرات التي تطرأ على تغذية الصفحة، بحسب تعبير Meta، مثل المنشورات والتعليقات والتفاعلات والمشاركات؛ وما يحمله التغيير يعتمد على نوعه. لا ترسل Meta شيئاً عن منشورات الإعلانات نفسها، لكن التعليقات عليها تصل، وترسل إشعارات الإعجاب بالصفحة فقط ما دامت الصفحة تملك أقل من 10,000 إعجاب.
ماذا يعني item وverb؟
حقلان في قيمة كل تغيير يحددان ما حدث:
- item: ما الذي تغيّر، وفق قائمة Meta التي تشمل القيم post وstatus وphoto وvideo وlink وshare وcomment وreaction وalbum.
- verb: ما الذي حدث له، وهي القيم add وedit وedited وdelete وremove وhide وunhide وblock وunblock وfollow وmute وupdate.
- يصل التعليق الجديد بالقيمة comment في item والقيمة add في verb، وهو ما تبحث عنه قواعد comment-to-DM.
- يحمل التفاعل القيمة reaction في item، ويحمل
reaction_typeالذي يسمّيه.
كيف يبدو تغيير في feed؟
طلب POST يحتوي JSON فيه object بقيمة page، وإدخال entry لكل صفحة يضم معرّف الصفحة والوقت ومصفوفة changes. وهذا مثال Meta الأصلي، لشخص ينشر على الصفحة:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1520544816,
"changes": [
{
"field": "feed",
"value": {
"from": { "id": "<USER_ID>", "name": "<NAME>" },
"item": "post",
"post_id": "<PAGE_POST_ID>",
"verb": "add",
"created_time": 1520544814,
"is_hidden": false,
"message": "<POST_TEXT>"
}
}
]
}
]
}ما الحقول التي قد يحملها التغيير؟
تذكر مرجعية Meta هذه الحقول من بين حقول قيمة تغيير feed، وتظهر بحسب نوع التغيير:
post_idوcomment_idوparent_id: المنشور والتعليق وما ينتمي إليه.- from: معرّف الشخص الذي أجرى التغيير واسمه.
- message: النص، مع link أو photo أو photos أو video للمحتوى المرفق.
created_time، وedited_timeللتعديلات.reaction_typeللتفاعلات، وis_hiddenلبيان ما إذا كان المنشور مخفياً.- post: تفاصيل مثل
status_typeوis_publishedوupdated_timeوpermalink_url.
كيف تُشترك الصفحة؟
يرسل التطبيق POST إلى /{page-id}/subscribed_apps مع subscribed_fields=feed ورمز الوصول (token) الخاص بالصفحة، من شخص يستطيع تنفيذ مهمة CREATE_CONTENT أو MANAGE أو MODERATE، مع منح pages_manage_metadata وpages_show_list. ترسل Meta الإشعارات فقط ما دامت الصفحة قد ثبّتت التطبيق ولم تُوقف منصة التطبيقات في إعداداتها. يشترك easyCoexistence في feed وmessages وmention لكل صفحة عند ربطها.
كيف تصل أحداث feed إلى endpoint الخاص بك؟
ترسلها Meta إلى تطبيق easyCoexistence، الذي يتحقق من X-Hub-Signature-256، ويرد على Meta فوراً، ويعيد توجيه كل entry لصفحة متصلة إلى عنوان HTTPS الذي حددته لها. تحمل الإعادة الترويسة X-EC-Signature، وهي HMAC-SHA256 لختم زمني والجسم الخام مع مفتاح سرّ تلك الصفحة، وتُرسل مرة واحدة، دون الاحتفاظ بنسخة ودون إعادة محاولة. اضبط العنوان بالأمر set_social_webhook_destination أو بالطلب PUT /channels/:id/webhook في Partner API.
أي تغييرات في feed تبدأ قواعد التعليقات والأتمتة؟
التعليقات الجديدة فقط: تغيير بقيمة comment في item وقيمة add في verb على أحد منشورات الصفحة. تفحص قواعد comment-to-DM الرسالة بحثاً عن كلماتها المفتاحية، وتتجاهل التعليقات التي كتبتها الصفحة بنفسها، وتأخذ الأتمتة التعليقات التي لم ترد عليها أي قاعدة. تُرسل التعديلات والإخفاءات والتفاعلات والمنشورات مباشرة إلى نقطة النهاية الخاصة بك، إن حددت واحدة.
الأخطاء الشائعة
- اعتبار أي تغيير في feed تعليقاً جديداً. افحص item وverb، فالتفاعلات والتعديلات والإخفاءات والإزالات تصل في الحقل نفسه.
- الرد على تعليقات الصفحة نفسها. تعود ردودها أيضاً كتغييرات في feed، لذا تجاوز تلك التي يكون فيها from.id هو معرّف الصفحة.
- افتراض تغيير واحد لكل تسليم. قد تجمع Meta حتى 1,000 تحديث، لذا كرّر على كل entry وكل change فيه.
- قراءة entry.time على أنه وقت حدوث التغيير. تضبطه Meta على وقت إرسال الإشعار، أما created_time في القيمة فهو وقت إنشاء الكائن.
من US$ 9 إلى US$ 0.75 لكل اتصال في الشهر، ينخفض مع إضافة الاتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يتضمن خطاف feed التعليقات؟
نعم. يصل التعليق الجديد كتغيير في feed بقيمة comment في item وقيمة add في verb، ويحمل comment_id وpost_id وfrom وmessage.
هل أتلقى خطافات لإعجابات الصفحة؟
فقط للصفحات التي يقل عدد إعجاباتها عن 10,000، وفق مرجعية Meta لخطافات الصفحات.
هل منشورات الإعلانات ضمن خطاف feed؟
ليس منشورات الإعلانات نفسها، لكن التعليقات عليها تُرسل.
هل أحتاج تطبيق Meta الخاص بي لأحصل على أحداث feed لصفحة؟
لا. ترسلها Meta إلى تطبيق easyCoexistence، الذي يعيد توجيه كل حدث إلى نقطة النهاية التي حددتها لتلك الصفحة.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في