Skip to main content
These events notify you of changes in a message’s lifecycle after it is sent: when it is delivered, read, or deleted. All of them follow the common envelope — the event-specific content lives in data. Message edits do not show up here: they arrive as a regular message in messages.received, with type: "edited_message".

message.delivered and message.read

message.delivered fires when a message is delivered to the recipient; message.read fires when it is read. Both events have exactly the same data format.
string
required
ID of the message whose status changed.
string
required
JID of the chat (contact or group) the message belongs to.
string
JID of the participant who confirmed delivery/read. Only filled in for groups; in one-on-one chats it comes as an empty string ("").
number
required
Time of the event in milliseconds (epoch).
message.delivered and message.read go through a 30-second deduplication per message_id: repeated confirmations of the same status within that window do not trigger duplicate webhooks.

message.deleted

Fires when a message is deleted (revoked).
string
required
ID of the deleted message.
string
required
JID of the chat the message was in.
string
required
JID of the sender of the original message.
boolean
required
true when the deleted message was sent by the session itself.
number
required
Time of the deletion in milliseconds (epoch).

message.update

This event is not fired. Message edits arrive through the messages.received event with type: "edited_message" — see the edited_message example on that page. The format below stays documented only for those who already had message.update configured; it is never sent.
string
required
ID of the edited message.
string
required
JID of the chat the message is in.
string
required
JID of the message sender.
boolean
required
true when the edited message was sent by the session itself.
string
required
New message content after the edit.
number
required
Time of the original message in milliseconds (epoch).
number
required
Time of the edit in milliseconds (epoch).