`message_deliveries` Webhook Event Reference

Breaking Change Notice

Effective May 8, 2019, the parameter seq will always be 0 for all Messenger webhook events. This deprecation was announced on November 8, 2016. After Jul 31, 2019 the seq parameter will no longer be included in the webhook events. To de-duplicate messages use the mid parameter.

This callback will occur when a message a Page has sent has been delivered. You can subscribe to this callback by selecting the message_deliveries field when setting up your webhook.

Example

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

Properties

`sender`

Property	Type	Description
`id`	String	The PSID of the user that triggered the webhook event.
`user_ref`	String	The user_ref of the user that triggered the webhook event. This is only available for webhook event from the chat plugin.

`recipient`

Property	Type	Description
`id`	String	Your Page ID.

`delivery`

Property	Type	Description
`mids`	Array	Array containing message IDs of messages that were delivered. Field may not be present.
`watermark`	Number	All messages that were sent before this timestamp were delivered
`seq`	Number 0, until removed on Jul 31, 2019	Deprecated

Both mids and watermark fields are used to determine which messages were delivered. watermark is always present and mids is sometimes present. mids provides delivery receipts on a per-message basis but may not be present (due to backward compatibility reasons with older Messenger clients). watermark is always present and is a timestamp indicating that all messages with a timestamp before watermark were delivered.

message_deliveries Webhook Event Reference