Referensi Peristiwa Webhooks messages

Panggilan balik ini akan terjadi ketika pesan telah dikirim ke Halaman Anda. Pesan selalu dikirim berurutan. Anda mungkin menerima pesan teks atau pesan dengan lampiran.

Jenis lampiran image, audio, video, file, reel, dan ig_reel adalah jenis utama yang didukung. Anda juga dapat menerima lampiran fallback. Contoh umum dari 'fallback' adalah ketika pengguna membagikan URL dengan Halaman, lampiran dibuat berdasarkan pembagian tautan. Untuk pembagian yang tidak didukung yang dilakukan oleh pengguna ke Halaman Anda, fallback tanpa muatan dapat dikirimkan.

Anda dapat berlangganan panggilan balik ini dengan memilih message saat menyiapkan Webhooks Anda.

Contoh

Pesan Teks

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

Pesan Balasan

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

Pesan dengan lampiran

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

Pesan dengan template produk

Webhooks ini berlaku untuk skenario ketika pengguna membagikan produk dari utas atau alur bagikan lain ke halaman. Webhooks ini terbatas hanya pada produk yang dimiliki oleh halaman. Aplikasi harus memiliki persetujuan izin catalog_management untuk menerima detail produk di Webhooks.

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

Pesan dengan lampiran fallback

Contoh berlaku untuk messages di versi +v6.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"
                                }
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

Pesan dari Halaman Detail Produk di Toko

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

Pesan dengan Informasi Rujukan Iklan

Webhooks ini berlaku untuk skenario ketika pengguna mengeklik iklan CTM (Klik ke Messenger) dan mengirim pesan ke halaman Facebook. Selain detail pesan yang disertakan, aplikasi akan menerima informasi rujukan iklan.

{
  "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>"
      }
    }
  }
}

Pesan dengan perintah

{
  "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"
              }
            ]
          }
        }
      ]
    }
  ]
}

Properti

sender

recipient

message

message.quick_reply

Muatan quick_reply hanya disediakan dengan pesan teks ketika pengguna mengetuk tombol Balasan Cepat.

message.reply_to

message.attachments

message.attachments.payload

message.attachments.payload.product.elements

message.referral

Muatan referral hanya disediakan ketika pengguna mengirim pesan dari halaman detail produk di Toko.

message.referral.product

message.referral.ads_context_data

message.commands