message_deliveries
Webhook Event ReferenceEffective 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.
{ "sender":{ "id":"<PSID>" }, "recipient":{ "id":"<PAGE_ID>" }, "delivery":{ "mids":[ "mid.1458668856218:ed81099e15d3f4f233" ], "watermark":1458668856253 } }
sender
Property | Type | Description |
---|---|---|
| String | The PSID of the user that triggered the webhook event. |
| 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 |
---|---|---|
| String | Your Page ID. |
delivery
Property | Type | Description |
---|---|---|
| Array | Array containing message IDs of messages that were delivered. Field may not be present. |
| Number | All messages that were sent before this timestamp were delivered |
| 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.