مرجع حدث Webhook لـ messages

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

أنواع المرفقات image، audio، video، file، reel وig_reel هي الأنواع المدعومة الرئيسية. قد تستلم أيضًا مرفقات fallback. وكمثال شائع على "الاستدعاء"، عندما يشارك المستخدم عنوان URL مع صفحة ويتم إنشاء مرفق بناءً على مشاركة الرابط. بالنسبة للمشاركات غير المدعومة التي تم إجراؤها بواسطة المستخدمين على صفحتك، قد يتم إرسال fallback بدون حمولة بيانات.

يمكنك الاشتراك في هذا الاستدعاء بتحديد message عند إعداد حدث webhook.

أمثلة

الرسالة النصية

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "message":{
    "mid":"mid.1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!",
    "quick_reply": {
      "payload": "<DEVELOPER_DEFINED_PAYLOAD>"
    }
  }
}    

رسالة الرد

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "message":{
    "mid":"m_1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!",
    "reply_to": {
      "mid":"m_1fTq8oLumEyIp3Q2MR-aY7IfLZDamVrALniheU"
    }
  }
}    

رسالة تتضمن مرفقًا

{
  "id": "682498302938465",
  "time": 1518479195594,
  "messaging": [
    {
      "sender": {
        "id": "

رسالة تتضمن قالب منتج

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

{
  "id": "682498302938465",
  "time": 1518479195594,
  "messaging": [
    {
      "sender": {
        "id": "

رسالة تتضمن مرفقًا احتياطيًا

ينطبق المثال على messages في الإصدار 6.0 والإصدارات الأحدث

{
    "object": "page",
    "entry": [
        {
            "id": "<PAGE_ID>",
            "time": 1583173667623,
            "messaging": [
                {
                    "sender": {
                        "id": "<PSID>"
                    },
                    "recipient": {
                        "id": "<PAGE_ID>"
                    },
                    "timestamp": 1583173666767,
                    "message": {
                        "mid": "m_toDnmD...",
                        "text": "This is where I want to go: https:\/\/youtu.be\/bbo_fZAjIhg",
                        "attachments": [
                            {
                                "type": "fallback",
                                "payload": {
                                    "url": "<ATTACHMENT_URL >",
                                    "title": "TAHITI - Heaven on Earth"
                                }
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

رسالة من صفحة تفاصيل المنتج في المتاجر

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "message":{
    "mid":"mid.1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!",
    "referral": {
      "product": {
        "id":"<PRODUCT_ID>"
      }
    }
  }
}    

رسالة تحتوي على معلومات إحالة الإعلانات

ينطبق حدث webhook هذا على السيناريو عندما ينقر المستخدم على إعلان CTM (النقر لفتح محادثة في Messenger) ويرسل رسالة إلى صفحة فيسبوك. بالإضافة إلى تفاصيل الرسالة المضمنة، سيتلقى التطبيق معلومات إحالة الإعلانات.

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "message":{
    "mid":"mid.1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!",
    "referral": {
      "ref": "<REF_DATA_IF_SPECIFIED_IN_THE_AD>",
      "ad_id": "<ID_OF_THE_AD>",
      "source": "ADS",
      "type": "OPEN_THREAD",
      "ads_context_data": {
        "ad_title": "<TITLE_OF_THE_AD>",
        "photo_url": "<URL_OF_THE_IMAGE_FROM_AD_THE_USER_IS_INTERESTED_IN>",
        "video_url": "<THUMBNAIL_URL_OF_THE_VIDEO_FROM_THE_AD>",
        "post_id": "<ID_OF_THE_POST>",
        "product_id": "<PRODUCT_ID>"
      }
    }
  }
}

رسالة تحتوي على أوامر

{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1697643211842,
      "messaging": [
        {
          "sender": {
            "id": "<PSID>"
          },
          "recipient": {
            "id": "<PAGE_ID>"
          },
          "timestamp": 1697643027400,
          "message": {
            "mid": "m_3vs...",
            "text": "find flights from SFO to LAX next Thursday",
            "commands": [
              {
                "name": "flights"
              }
            ]
          }
        }
      ]
    }
  ]
}

الخصائص

sender

recipient

message

message.quick_reply

لا يتم توفير حمولة البيانات quick_reply إلا مع رسالة نصية عندما يضغط المستخدم على الزر الردود السريعة.

message.reply_to

message.attachments

message.attachments.payload

message.attachments.payload.product.elements

message.referral

لا يتم توفير حمولة بيانات referral إلا عندما يرسل المستخدم رسالة من صفحة تفاصيل المنتج في المتاجر.

message.referral.product

message.referral.ads_context_data

message.commands