Messenger 平台

message_echoes Webhook 事件參考資料

當專頁傳送出訊息時，此回呼便會出現。您可能會收到 text 訊息或包含附件（image、video、audio、template 或 fallback）的訊息。裝載還會包含傳送者傳送的可選自訂 metadata 和相應的 app_id。
您可在設定 Webhook 時選擇 message_echoes 欄位來訂閱此回呼。

系統支援多種類型的訊息：

常見格式

範例 1

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<USER_ID>"
  },
  "timestamp":1457764197627,
  "message":{
    "is_echo":true,
    "app_id":1517776481860111,
    "metadata": "<DEVELOPER_DEFINED_METADATA_STRING>",
    "mid":"mid.1457764197618:41d102a3e1ae206a38",
    ...
  }
}

範例 2

{
    "object": "page",
    "entry": [
        {
            "id": "<PAGEID>",
            "time": 1570053170926,
            "standby": [
                {
                    "sender": {
                        "id": "<PAGEID>"
                    },
                    "recipient": {
                        "id": "<PSID>"
                    },
                    "timestamp": 1570053170673,
                    "message": {
                        "mid": "qT7ywaKpO9kkQR7Gv-nM8LIfLZDamVrALniheUYEDdHJXjDXEAyaS1xxONzb2Iv-DFzmTihfWJV012P5pK0AhQ",
                        "is_echo": true,
                        "app_id": <APPID>,
                        "attachments": [
                            {
                                "title": "",
                                "url": "https:\/\/www.facebook.com\/commerce\/update\/",
                                "type": "template",
                                "payload": {
                                    "template_type": "media",
                                    "elements": [
                                        {
                                            "media_type": "image",
                                            "attachment_id": 2457235337685388
                                        }
                                    ]
                                }
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

屬性

sender

屬性類型描述

id

字串

觸發 Webhook 事件的用戶 PSID。

user_ref

字串

觸發 Webhook 事件的用戶 user_ref。此屬性僅適用於聊天附加程式的 Webhook 事件。

recipient

屬性類型描述

id

字串

您的專頁編號。

message

欄位名稱 類型 說明

is_echo

布林值

表示該訊息由專頁傳送

app_id

字串

傳送訊息的應用程式編號。由 Graph API v12.0 及以上版本開始，每當透過 Facebook 專頁收件匣傳送訊息時，app_id 欄位都將傳回專頁收件匣應用程式編號 (26390203743090)。

metadata

字串

以 metadata 欄位傳遞到 Send API 的自訂字串。僅在原始訊息中設定了 metadata 屬性時出現。

mid

字串

訊息編號

文字訊息

範例

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<USER_ID>"
  },
  "timestamp":1457764197627,
  "message":{
    "is_echo":true,
    "app_id":1517776481860111,
    "metadata": "<DEVELOPER_DEFINED_METADATA_STRING>",
    "mid":"mid.1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!"
  }
}

屬性

message

屬性 類型 說明

text

字串

訊息文字

包含圖像、音訊、影片或檔案附件的訊息

範例

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<USER_ID>"
  },
  "timestamp":1458696618268,
  "message":{
    "is_echo":true,
    "app_id":1517776481860111,
    "metadata": "<DEVELOPER_DEFINED_METADATA_STRING>",
    "mid":"mid.1458696618141:b4ef9d19ec21086067",
    "attachments":[
      {
        "type":"image",
        "payload":{
          "url":"<IMAGE_URL>"
        }
      }
    ]
  }
}

屬性

message.attachments

屬性 類型 說明

type

字串

附件類型：image、audio、video 或 file

payload.url

字串

附件網址

包含範本附件的訊息

範例

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<USER_ID>"
  },
  "timestamp":1458696618268,
  "message":{
    "is_echo":true,
    "app_id":1517776481860111,
    "metadata": "<DEVELOPER_DEFINED_METADATA_STRING>",
    "mid":"mid.1458696618141:b4ef9d19ec21086067",
    "attachments":[
      {
        "type":"template",
        "payload":{
          "template_type":"button",
          "buttons":[
            {
              "type":"web_url",
              "url":"https:\/\/www.messenger.com\/",
              "title":"Visit Messenger"
            }
          ]
        }
      }
    ]
  }
}

屬性

message.attachments

屬性 類型 說明

type

字串

template

payload

字串

Send API 參考資料中所述的範本裝載

請注意，如果 payload 包含附件，所傳送的附件編號會是數字而非字串。請參閱範例 2

這與 Send API 要求的格式不同，後者需要以字串形式傳送附件編號。

包含遞補附件的訊息

遞補附件是指訊息回應功能目前無法識別或不支援的附件。

範例

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<USER_ID>"
  },
  "timestamp":1458696618268,
  "message":{
    "is_echo":true,
    "app_id":1517776481860111,
    "metadata": "<DEVELOPER_DEFINED_METADATA_STRING>",
    "mid":"mid.1458696618141:b4ef9d19ec21086067",
    "attachments":[
      {
        "title":"Legacy Attachment",
        "url":"https:\/\/www.messenger.com\/",
        "type":"fallback",
        "payload":null
      }
    ]
  }
}

屬性

message.attachments

屬性 類型 說明

type

字串

fallback

title

字串

附件標題（選用）

url

字串

附件網址（選用）

payload

字串

附件裝載（選用）

包含商品的訊息

包含商品回應 Webhook 的訊息只適用於 Graph API v8.0 版或以上版本

應用程式將需要獲批 catalog_management 權限才能接收 Webhooks 中的商品詳情。

範例

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<USER_ID>"
  },
  "timestamp":1458696618268,
  "message":{
    "is_echo":true,
    "app_id":1517776481860111,
    "metadata": "<DEVELOPER_DEFINED_METADATA_STRING>",
    "mid":"mid.1458696618141:b4ef9d19ec21086067",
    "attachments":[
      {
        "type":"template",
        "payload":{
          "product":{
             "elements":[ // multiple elements for Hscroll
               {
                 "id":"<PRODUCT_ID>",
                 "retailer_id":"<EXTERNAL_ID>",
                 "image_url":"https://fb.cdn.com/sdsd",
                 "title":"Some product title",
                 "subtitle": "40",
               },
               {...},
             ]
            }

          ]
        }
      }
    ]
  }
}

屬性

product.elements

屬性 類型 說明

id

字串

來自商品目錄的商品編號

retailer_id

字串

與商品關聯的外部編號。（例如 SKU 或內容編號）

image_url

字串

商品圖像網址

title

字串

商品標題

subtitle

字串

商品副標題