`message_reads` 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 event will be sent to your webhook when a message a Page has sent has been read by the user.
You can subscribe to this callback by selecting the message_reads field when setting up your webhook.

The message_reads webhook event is not supported for messages sent via the Broadcast API.

Example

{
   "sender":{
      "id":"<PSID>"
   },
   "recipient":{
      "id":"<PAGE_ID>"
   },
   "timestamp":1458668856463,
   "read":{
      "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.

`read`

Property	Type	Description
`watermark`	Number	All messages that were sent before or at this timestamp were read
`seq`	Number 0, until removed on Jul 31, 2019	Deprecated

The watermark field is used to determine which messages were read. It represents a timestamp indicating that all messages with a timestamp before watermark were read by the recipient.

message_reads Webhook Event Reference