إن أحداث Webhook هي الطريقة التي تستخدمها منصة Messenger لإبلاغ برنامجك التلقائي عند حدوث مجموعة من التفاعلات أو الأحداث، بما في ذلك عندما يرسل أحد الأشخاص رسالة. ويتم إرسال أحداث Webhook بواسطة منصة Messenger في شكل طلبات POST إلى حدث webhook الذي تستخدمه.
ملاحظة: ستحتاج إلى تسجيل اشتراك كل تطبيقات المراسلة لدى نشاطك التجاري في أحداث webhooks المراسلة.
فيما يلي قائمة بالأحداث التي يمكن إرسالها إلى حدث webhook من منصة Messenger.
ملاحظة: يوصى باستخدام أحدث إصدار API لتلقي كل المعلومات المتوفرة حول كل حدث webhook.
حدث Webhook | الوصف |
---|---|
| الاشتراك في أحداث تم استلام الرسالة |
| الاشتراك في أحداث ربط الحسابات |
| الاشتراكات في أحداث تحديث إتمام الشراء |
| الاشتراك في أحداث تم تسليم الرسالة |
| الاشتراك في أحداث صدى الرسالة |
| الاشتراك في أحداث اللعبة الفورية |
| الاشتراك في أحداث بروتوكول التسليم |
| الاشتراكات في أحداث الاشتراك في المكون الإضافي |
| الاشتراك في أحداث الدفع |
| الاشتراك في أحداث تطبيق السياسة |
| الاشتراك في أحداث تم استلام إعادة النشر |
| الاشتراك في أحداث ما قبل إتمام الشراء للدفع |
| الاشتراك في أحداث تم قراءة الرسالة |
| الاشتراك في أحداث الإحالة |
| الاشتراك في أحداث قناة الاستعداد في بروتوكول التسليم |
تتضمن كل الاستدعاءات التي تتم في منصة Messenger مجموعة مشتركة من الخصائص التي توفر معلومات يتعين عليك معالجتها والاستجابة إلى إدخالات الأشخاص الذين يستخدمون برنامجك التلقائي. بالإضافة إلى الخصائص الموضّحة أدناه، يتضمن كل حدث أيضًا مجموعة من الخصائص المحددة التي توضح تفاصيل الحدث.
{
"object":"page",
"entry":[
{
"id":"<PAGE_ID>",
"time":1458692752478,
"messaging":[
{
"sender":{
"id":"<PSID>"
},
"recipient":{
"id":"<PAGE_ID>"
},
...
}
]
}
]
}
الخاصية | النوع | الوصف |
---|---|---|
| String (سلسلة) | ستكون القيمة |
| مصفوفة من | مصفوفة تتضمن بيانات الحدث |
entry
الخاصية | النوع | الوصف |
---|---|---|
| String (سلسلة) | معرف الصفحة |
| الرقم | وقت التحديث (وقت البدء بالمللي ثانية) |
| Array (مصفوفة)< | مصفوفة تحتوي على كائن |
entry.messaging
الخاصية | النوع | الوصف |
---|---|---|
| String (سلسلة) | معرف المستخدم الخاص بالمُرسل |
| String (سلسلة) | معرف المستخدم الخاص بالمستلم |
إذا كان لديك أكثر من تطبيق واحد يعالج الرسائل، على سبيل المثال، تطبيق واحد يعالج الردود التلقائية وتطبيق واحد يعالج التصعيدات الموجهة إلى وكيل بشري، فستحتاج إلى تنفيذ بروتوكول التسليم لتمرير المحادثة من تطبيق إلى آخر. بروتوكول التسليم