Webhook 事件參考資料

Messenger 開放平台會在各種互動或事件發生時（包括用戶傳送訊息時），透過 Webhook 事件通知您的 Bot。Messenger 開放平台會以 POST 要求的方式，將 Webhook 事件傳送至 Webhook。

附註：您需要為商家的所有訊息應用程式訂閱訊息 Webhooks。

Webhook 事件清單

可從 Messenger 開放平台傳送至 Webhook 的事件清單如下。

附註：建議使用最新的 API 版本來接收每個 Webhook 的所有可用資訊。

Webhook 事件	說明
`messages`	訂閱已收到訊息事件
`messaging_account_linking`	訂閱帳號連結事件
`messaging_checkout_updates`（試用版）	訂閱結帳更新事件
`message_deliveries`	訂閱已傳遞訊息事件
`message_echoes`	訂閱已回送訊息事件
`messaging_game_plays`	訂閱即時遊戲事件
`messaging_handovers`（試用版）	訂閱交接通訊協定事件
`messaging_optins`	訂閱外掛程式選擇加入事件
`messaging_payments`（試用版）	訂閱付款事件
`messaging_policy_enforcement`	訂閱政策執行事件
`messaging_postbacks`	訂閱已收到回傳事件
`messaging_pre_checkouts`（試用版）	訂閱付款結帳前事件
`message_reads`	訂閱已讀取訊息事件
`messaging_referrals`	訂閱轉介事件
`standby`（試用版）	訂閱交接通訊協定待命管道事件

事件格式

Messenger 開放平台的所有回呼都有一組常見的屬性，提供您需要的資訊來處理及回應用戶使用 Bot 輸入的內容。除了以下屬性之外，每個事件也都有一組特定的屬性可提供事件的詳細資訊。

{
  "object":"page",
  "entry":[
    {
      "id":"<PAGE_ID>",
      "time":1458692752478,
      "messaging":[
        {
          "sender":{
            "id":"<PSID>"
          },
          "recipient":{
            "id":"<PAGE_ID>"
          },

          ...
        }
      ]
    }
  ]
}

屬性

屬性	類型	說明
`object`	字串	值會是 `page`
`entry`	`entry` 陣列	包含事件資料的陣列

`entry`

屬性	類型	說明
`id`	字串	粉絲專頁的粉絲專頁編號
`time`	數字	更新時間（以毫秒為單位的紀元時間）
`messaging`	陣列<`messaging`>	包含一個 `messaging` 物件的陣列。請注意，雖然這是陣列，但只能含有一個 `messaging` 物件。

`entry.messaging`

屬性	類型	說明
`sender.id`	字串	傳送者用戶編號
`recipient.id`	字串	接收者用戶編號

瞭解詳情

如果您有多個處理訊息的應用程式（例如，一個應用程式處理自動回覆，一個應用程式處理呈報至真人服務人員），則需要實作交接通訊協定，將對話從一個應用程式傳遞到另一個應用程式。交接通訊協定