أحداث Webhooks للصفحات

يمكن لأحداث Webhooks للصفحات أن ترسل لك إشعارات فورية بالتغييرات على صفحاتك. على سبيل المثال، يمكنك تلقي تحديثات فورية عندما ينشر المستخدمون في الموجز لديك أو يعلقون على منشور أو يسجلون الإعجاب بمنشوراتك.

لإعداد Webhook للصفحة:

  1. قم بإعداد نقطة النهاية لديك وتكوين منتج Webhooks.
  2. قم بتثبيت تطبيقك باستخدام صفحة Facebook لديك.

إعداد نقطة النهاية ومنتج Webhook

اتبع دليل بدء الاستخدام لإنشاء نقطة النهاية لديك وتكوين منتج Webhooks. وأثناء التكوين، تأكد من اختيار كائن الصفحة والاشتراك في واحد أو أكثر من حقول الصفحات أدناه.

الحقلالوصف

feed

يرسل لك إشعارًا عند تغيير أخبار الصفحة؛ المنشورات والتفاعلات والمشاركات وغير ذلك.

messages

يرسل لك إشعارًا عند تلقي صفحتك لرسالة عبر Messenger. راجع دليل أحداث Webhooks في Messenger للحصول على قائمة بكل حقول أحداث webhooks الرسائل المتوفرة

تثبيت التطبيق

لن يتم إرسال إشعارات Webhook إلا إذا قامت صفحتك بتثبيت تطبيق Webhooks الذي تم تكوينه وإذا لم تقم الصفحة بتعطيل منصة التطبيق في إعدادات التطبيق الخاصة به. ولتثبيت التطبيق على صفحتك، اجعل تطبيقك يرسل طلب POST إلى عنصر الربط subscribed_apps التابع للصفحة باستخدام رمز وصول الصفحة.

المتطلبات

بالنسبة للحقول المتعلقة بالرسائل فقط

  • رمز وصول الصفحة المطلوب من جانب شخص يمكنه تنفيذ المهمة MESSAGING في الصفحة التي يتم الاستعلام عنها

عينة من الطلب

curl -i -X POST "https://graph.facebook.com/{page-id}/subscribed_apps
  ?subscribed_fields=feed
  &access_token={page-access-token}"

عينة من الاستجابة

{
  "success": "true"
}

لمعرفة التطبيق الذي قامت صفحتك بتثبيته، أرسل طلب GET بدلاً من ذلك:

عينة من الطلب

curl -i -X GET "https://graph.facebook.com/{page-id}/subscribed_apps &access_token={page-access-token} 

عينة من الاستجابة

{
  "data": [
    {
      "category": "Business",
      "link": "https://my-clever-domain-name.com/app",
      "name": "My Sample App",
      "id": "{page-id}"
    }
  ]
}

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

مستكشف Graph API

إذا لم ترغب في تثبيت تطبيقك بشكل برمجي، فيمكنك تثبيته بسهولة من خلال مستكشف Graph API بدلاً من ذلك:

  1. حدّد تطبيقك في قائمة التطبيق المنسدلة. سيؤدي هذا إلى إرجاع رمز وصول التطبيق.
  2. انقر على قائمة الحصول على الرمز المنسدلة وحدّد الحصول على رمز وصول المستخدم، ثم اختر الإذن pages_manage_metadata. وسيؤدي هذا إلى استبدال رمز التطبيق برمز وصول المستخدم من خلال الإذن pages_manage_metadata الذي تم منحه.
  3. انقر على الحصول على رمز مجددًا وحدّد صفحتك. وسيؤدي هذا إلى استبدال رمز وصول المستخدم برمز وصول الصفحة.
  4. قم بتغيير طريقة التشغيل من خلال النقر على القائمة المنسدلة GET وتحديد POST.
  5. استبدل استعلام me?fields=id,name الافتراضي بمعرف الصفحة المتبوع بـ /subscribed_apps، ثم أرسل الاستعلام.

الاستخدامات الشائعة

الحصول على تفاصيل أخبار الصفحة

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

عينة من استجابة حدث Webhook

[
  {
    "entry": [
      {
        "changes": [
          {
            "field": "feed",
            "value": {
              "from": {
                "id": "{user-id}",
                "name": "Cinderella Hoover"
              },
              "item": "post",
              "post_id": "{page-post-id}",
              "verb": "add",
              "created_time": 1520544814,
              "is_hidden": false,
              "message": "It's Thursday and I want to eat cake."
            }
          }
        ],
        "id": "{page-id}",
        "time": 1520544816
      }
    ],
    "object": "page"
  }
]

استخدم post_id من الإشعار للتعليق على منشور هذه الصفحة.

عينة من طلب API

curl -i -X POST   "https://graph.facebook.com/{page-post-id}/comments
  ?message=I%20want%20chocolate%20cake%20!
  &access_token=page-access-token" 

عينة من استجابة API

{
  "id": "{comment-id}"
}