‏منصة Messenger‏

مرجع أحداث Webhooks لـ messaging_postbacks

يشرح هذا المستند حمولة بيانات JSON التي سيتلقاها خادم أحداث webhooks عند تشغيل حدث webhook للرد الجاهز في المراسلة. يتم تشغيل حدث webhook للرد الجاهز عندما ينقر الشخص على زر الرد أو زر بدء الاستخدام أو عنصر القائمة الثابتة.

مثال على الإشعار

فيما يلي مثال على حمولة بيانات JSON التي سيتم إرسالها إلى خادم أحداث webhooks.

{
  "field": "messaging_postbacks",
  "value": {
    "sender": {
      "user_ref": "USER-REF-ID"
    },
    "recipient": {
      "id": "PAGE-ID"
    },
    "timestamp": "1527459824",
    "postback": {
      "mid": "m_MESSAGE-ID",
      "title": "TITLE-FOR-THE-CTA",
      "payload": "USER-DEFINED-PAYLOAD",
      "referral": {
        "ref": "USER-DEFINED-REFERRAL-PARAM",
        "source": "SHORT-URL",
        "type": "OPEN_THREAD"
      }
    }
  }
}

خصائص JSON

تكون كل خصائص JSON في إشعار حدث webhook عبارة عن سلاسل.

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

postback.mid

معرف الرسالة

postback.payload

المعلومات المحددة في معلمة payload لزر الدعوة لاتخاذ إجراء (CTA). يتم تضمين ذلك فقط في إشعار webhook الذي يتم إرساله إلى التطبيق الذي أرسل الرسالة إلى الشخص.

postback.referral

معلومات حول الإجراء الذي اتخذه الشخص للدخول في المحادثة.

يتم تضمين معلومات الخاصية referral في إشعار webhook فقط عندما يبدأ الشخص محادثة باستخدام وسيلة واحدة مما يلي ثم ينقر على زر دعوة لاتخاذ إجراء مثل زر بدء الاستخدام:

  • المكون الإضافي "دردشة"
  • رابط m.me
  • إعلان النقر لفتح محادثة في Messenger
  • رمز QR في Messenger
  • شاشة ترحيبية

postback.referral.ref

تمثل البيانات العشوائية التي تم إدخالها في الأصل ضمن المعلمة ref التي تمت إضافتها إلى رابط m.me. يتم دعم الأحرف الأبجدية الرقمية فقط بالإضافة إلى -،_، =

postback.referral.source

عنوان URL لهذه الإحالة. بالنسبة لروابط m.me، تكون قيمة المصدر “SHORTLINK”. بالنسبة للإحالات من إعلانات المحادثات على Messenger، تكون قيمة المصدر هي "ADS"

postback.referral.type

معرف الإحالة. بالنسبة للإحالات التي تنشأ عن روابط m.me، دائمًا ما تكون القيمة "OPEN_THREAD".

postback.title

عنوان زر الدعوة لاتخاذ إجراء (CTA) الذي نقر عليه الشخص

recipient.id

معرف صفحة فيسبوك

sender.user_ref

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

timestamp

طابع زمني بتنسيق Unix للتاريخ الذي تم إرسال إشعار webhook فيه إلى الخادم

راجع أيضًا

وثائق إضافية للمطوّرين لتوسيع معرفتك بالمفاهيم المذكورة في دليل أحداث Webhooks هذا.