‏Webhooks من Meta‏

Webhooks من Meta

تتيح لك أحداث Webhooks تلقي إشعارات HTTP فورية تتضمن التغييرات التي تطرأ على كائنات محددة في مخطط التواصل الاجتماعي على Meta. على سبيل المثال، يمكننا أن نرسل لك إشعارًا عندما يقوم أي من مستخدمي تطبيقك بتغيير عنوان البريد الإلكتروني أو عندما يعلِّقون على صفحة فيسبوك. ويغنيك هذا الأمر عن الاضطرار إلى إرسال استعلام إلى واجهة Graph API بحثًا عن التغييرات التي حدثت للكائنات أو لم تحدث، كما يساعدك في تجنب الوصول إلى تقييد معدلات الاستدعاء.

تتضمن أحداث Webhooks لعمليات الدفع وأحداث Webhooks في Messenger خطوات تكوين مختلف قليلاً. إذا كنت تقوم بإعداد حدث Webhook لأي من هذين المنتجين، فيُرجى الرجوع إلى المستندات ذات الصلة للحصول على إرشادات الإعداد.

الكائنات والحقول والقيم

توجد العديد من أنواع الكائنات في مخطط التواصل الاجتماعي في Meta، مثل كائنات المستخدم وكائنات الصفحة، لذا عندما تحاول تكوين حدث Webhook، يجب عليك أولاً اختيار نوع الكائن. نظرًا لأن الكائنات المختلفة لديها حقول مختلفة، يجب الاشتراك في حقول محددة لنوع الكائن هذا. عند وجود تغيير في القيمة الخاصة بأي حقل كائن قمت بالاشتراك فيه، سنرسل لك إشعارًا.

يتم إرسال الإشعارات إليك كطلبات HTTP POST وتحتوي على حمولة بيانات JSON تصف التغيير. على سبيل المثال، لنفترض أنك قمت بإعداد حدث Webhook لـ User واشتركت في الحقل Photos. إذا قام أحد مستخدمي التطبيق بتحميل صورة، فسنرسل إليك إشعارًا يبدو كالتالي:

عينة من الإشعار

{
  "entry": [
    {
      "time": 1520383571,
      "changes": [
        {
          "field": "photos",
          "value": {
            "verb": "update",
            "object_id": "10211885744794461"
          }
        }
      ],
      "id": "10210299214172187",
      "uid": "10210299214172187"
    }
  ],
  "object": "user"
}

خادم HTTPS

يتم إرسال أحداث Webhooks باستخدام HTTPS، لذلك يجب أن يكون خادمك قادرًا على تلقي طلبات HTTPS ومعالجتها، ويجب أن يكون مثبتًا عليه شهادة TLS/SSL صالحة. علمًا بأن الشهادات الموقّعة ذاتيًا غير مدعومة.

مراجعة التطبيقات

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

الأذونات

قبل توفير التطبيق للعامة، يجب أن يخضع لعملية "مراجعة التطبيقات". خلال المراجعة، يمكن للتطبيقات طلب الموافقة على أذونات محددة، والتي تتحكم في أنواع البيانات التي يمكن للتطبيق الوصول إليها عند استخدام واجهة Graph API.

على الرغم من أن منتج Webhooks لا يتطلب الخضوع لعملية مراجعة التطبيقات، فإنه يراعي الأذونات. وهذا يعني أنه إذا قمت بإعداد حدث Webhook والاشتراك في الحقول المحددة حسب نوع الكائن، فلن تتلقى إشعارات بأي تغييرات على كائن من ذلك النوع ما لم:

  • يتم اعتماد تطبيقك للحصول على الإذن (الأذونات) الذي يتوافق مع ذلك النوع من البيانات،
  • يتم منح الكائن الذي يمتلك البيانات تطبيقك إمكانية الوصول إلى تلك البيانات (على سبيل المثال، مستخدم يسمح لتطبيقك بالوصول إلى الموجز)

وضع التطوير

لا يمكن للتطبيقات في وضع التطوير تلقي سوى الإشعارات الاختبارية التي تم بدؤها من خلال لوحة معلومات التطبيق أو الإشعارات التي بدأها أشخاص لديهم دور في التطبيق.

لاحظ أن سلوك وضع التطوير يكون مختلفًا بالنسبة لأحداث Webhooks في Messenger. يمكنك الرجوع إلى مستند أحداث Webhooks في Messenger لمزيد من التفاصيل.

الإعداد

لاستخدام أحداث Webhooks، ستحتاج إلى إعداد نقطة نهاية على خادم (HTTPS) آمن، ثم إضافة منتج Webhooks وتكوينه في لوحة معلومات تطبيقك. توضح بقية هذه المستندات كيفية إكمال هاتين الخطوتين.

هل أنت جاهز؟ دعنا نبدأ!

معرفة المزيد