messages Webhook 事件參考資料

當訊息傳送到您的粉絲專頁時，將發生此回呼。訊息一律按順序傳送。您可能會收到文字訊息或含附件的訊息。

附件類型 image、audio、video、file、reel 和 ig_reel 為主要支援的類型。您也可能會收到 fallback 附件。「遞補」的一個常見範例是，當用戶與粉絲專頁分享網址時，會依據連結分享建立附件。對於用戶在您的粉絲專頁上進行不支援的分享，可能會傳送沒有 fallback 的裝載。

您可以在設定 Webhook 時透過選擇 message 訂閱此回呼。

範例

文字訊息

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

含遞補附件的訊息

適用於 +v6.0 版本 messages 的範例

{
    "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（發訊廣告）廣告並向 Facebook 粉絲專頁傳送訊息的場景。除了包含的訊息詳細資訊外，應用程式還將收到廣告轉介資訊。

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