مرجع أحداث Webhook

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

ملاحظة: ستحتاج إلى تسجيل اشتراك كل تطبيقات المراسلة لدى نشاطك التجاري في أحداث webhooks المراسلة.

قائمة بأحداث Webhook

فيما يلي قائمة بالأحداث التي يمكن إرسالها إلى حدث webhook من منصة Messenger.

ملاحظة: يوصى باستخدام أحدث إصدار API لتلقي كل المعلومات المتوفرة حول كل حدث webhook.

حدث Webhookالوصف

messages

الاشتراك في أحداث تم استلام الرسالة

messaging_account_linking

الاشتراك في أحداث ربط الحسابات

messaging_checkout_updates (إصدار تجريبي)

الاشتراكات في أحداث تحديث إتمام الشراء

message_deliveries

الاشتراك في أحداث تم تسليم الرسالة

message_echoes

الاشتراك في أحداث صدى الرسالة

messaging_game_plays

الاشتراك في أحداث اللعبة الفورية

messaging_handovers (إصدار تجريبي)

الاشتراك في أحداث بروتوكول التسليم

messaging_optins

الاشتراكات في أحداث الاشتراك في المكون الإضافي

messaging_payments (إصدار تجريبي)

الاشتراك في أحداث الدفع

messaging_policy_enforcement

الاشتراك في أحداث تطبيق السياسة

messaging_postbacks

الاشتراك في أحداث تم استلام إعادة النشر

messaging_pre_checkouts (إصدار تجريبي)

الاشتراك في أحداث ما قبل إتمام الشراء للدفع

message_reads

الاشتراك في أحداث تم قراءة الرسالة

messaging_referrals

الاشتراك في أحداث الإحالة

standby (إصدار تجريبي)

الاشتراك في أحداث قناة الاستعداد في بروتوكول التسليم

تنسيق الحدث

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

{
  "object":"page",
  "entry":[
    {
      "id":"<PAGE_ID>",
      "time":1458692752478,
      "messaging":[
        {
          "sender":{
            "id":"<PSID>"
          },
          "recipient":{
            "id":"<PAGE_ID>"
          },

          ...
        }
      ]
    }
  ]
}

الخصائص

الخاصية النوع الوصف

object

String (سلسلة)

ستكون القيمة page

entry

مصفوفة من entry

مصفوفة تتضمن بيانات الحدث

entry

الخاصية النوع الوصف

id

String (سلسلة)

معرف الصفحة

time

الرقم

وقت التحديث (وقت البدء بالمللي ثانية)

messaging

Array (مصفوفة)<messaging>

مصفوفة تحتوي على كائن messaging واحد. لاحظ أنه على الرغم من أن هذه تُعد مصفوفة، فإنها ستحتوي فقط على كائن messaging واحد فقط.

entry.messaging

الخاصية النوع الوصف

sender.id

String (سلسلة)

معرف المستخدم الخاص بالمُرسل

recipient.id

String (سلسلة)

معرف المستخدم الخاص بالمستلم

معرفة المزيد

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