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

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

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

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

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

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

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

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

المتطلبات

• رمز وصول الصفحة المطلوب من جانب شخص يمكنه تنفيذ المهمة CREATE_CONTENT أو MANAGE أو MODERATE في الصفحة التي يتم الاستعلام عنها
• يلزم توفير الإذنين pages_manage_metadata وpages_show_list لأحداث webhooks feed
• pages_messaging مطلوب أيضًا لـ messages

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

• رمز وصول الصفحة المطلوب من جانب شخص يمكنه تنفيذ المهمة MESSAGING في الصفحة التي يتم الاستعلام عنها
• pages_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}"
}