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

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

10K likes

ترسل إشعارات الإعجاب بالصفحة فقط للصفحات التي يقل عدد إعجاباتها عن هذا العدد.

Ad posts

حقل feed لا يرسل شيئاً عن منشورات الإعلانات نفسها، لكنه يرسل التعليقات عليها.

pages_manage_metadata

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

1,000

تجمّع Meta معظم التحديثات في تسليم webhook واحد، لكنها لا تضمن ذلك.

36 hours

المدة التي تستمر فيها 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 الأصلي، لشخص ينشر على الصفحة:

A feed change, as Meta sends it
{
  "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 في القيمة فهو وقت إنشاء الكائن.
إنجاز ذلك باستخدام EasyCoexistence

من 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، الذي يعيد توجيه كل حدث إلى نقطة النهاية التي حددتها لتلك الصفحة.

تابع القراءة

خطاف الويب (webhook) لـ Messenger في صفحات Facebook: الرسائل وأحداث الإشاراتحقول webhook الخاصة بصفحات Facebook لرسائل Messenger والإشارات: شكل الحمولة ومعرّفات المرسلين والمرفقات، وكيف تصل الأحداث إلى نقطة النهاية الخاصة بك.واجهة برمجة التطبيقات (API) لإدارة تعليقات صفحات Facebook: قراءة التعليقات والرد عليها وإخفاؤها وحذفهاطريقة قراءة صفحة Facebook للتعليقات على منشوراتها والرد عليها وإخفائها وحذفها عبر Graph API، مع المهام والأذونات والفلاتر المرتبطة بها.واجهة API للرد الخاص على Facebook: أرسل رسالة لمن علّق على الصفحةأرسل ردًا خاصًا على Facebook عبر API من Meta: POST /{page-id}/messages مع معرّف التعليق، ورسالة واحدة على Messenger خلال 7 أيام، والأخطاء.أذونات واجهة برمجة التطبيقات (API) لصفحات Facebook ومتطلبات مراجعة التطبيقالأذونات التسعة لصفحات Facebook، وما يتيحه كل منها، وما تطلبه مراجعة التطبيق من Meta: Advanced Access، والتحقق من النشاط التجاري، وتسجيل الشاشة.واجهة برمجة نشر منشورات صفحات Facebook: نص وروابط وصور وفيديوهاتطريقة نشر منشورات صفحة Facebook عبر Graph API: نص وروابط على /feed، وصور من رابط على /photos، وفيديوهات على /videos، وقواعد Meta.خطاف الويب (webhook) للإشارة على Facebook: متى يشير أحد إلى صفحتكما يرسله خطاف الويب عند الإشارة إلى صفحتك في منشور أو تعليق على Facebook، وحقول الحمولة، والصلاحية المطلوبة.

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

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

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

تم التحقق في