Messenger 開放平台

message_deliveries Webhook 事件參考資料

在已傳遞粉絲專頁發送的訊息時，將發生此回呼。您可以在設定 Webhook 時選取 message_deliveries 欄位，即可訂閱此回呼。

範例

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
   "delivery":{
      "mids":[
         "mid.1458668856218:ed81099e15d3f4f233"
      ],
      "watermark":1458668856253
   }
}

屬性

sender

屬性型別說明

id

字串

觸發 Webhook 事件的用戶 PSID。

user_ref

字串

觸發 Webhook 事件的用戶 ser_ref，僅適用於洽談外掛程式的 Webhook 事件。

recipient

屬性型別說明

id

字串

您的粉絲專頁編號。

delivery

屬性 類型 說明

mids

陣列

包含已傳遞訊息的訊息編號陣列。欄位不一定存在。

watermark

數字

在這個時間戳記之前，發送的所有訊息已完成傳遞

mids 和 watermark 兩個欄位都是用於判斷已傳遞哪些訊息。watermark 一定存在，mids 不一定存在。mids 會依個別訊息提供送達回條，但不一定存在（因為與舊版 Messenger 用戶端向下相容的原因）。watermark 一定存在並且為時間戳記，表示時間戳記在 watermark 之前的所有訊息皆已傳遞。