Skip to main content
Estes eventos notificam mudanças no ciclo de vida de uma mensagem após o envio: quando ela é entregue, lida, apagada ou editada. Todos seguem o envelope comum — o conteúdo específico fica em data.

message.delivered e message.read

message.delivered é disparado quando uma mensagem é entregue ao destinatário; message.read quando ela é lida. Os dois eventos têm exatamente o mesmo formato de data.
message_id
string
required
ID da mensagem cujo status mudou.
remote_jid
string
required
JID do chat (contato ou grupo) onde a mensagem está.
participant
string
JID do participante que confirmou a entrega/leitura. Só é preenchido em grupos; em conversas individuais vem como string vazia ("").
timestamp
number
required
Momento do evento em milissegundos (epoch).
message.delivered e message.read passam por deduplicação de 30 segundos por message_id: confirmações repetidas do mesmo status dentro dessa janela não geram webhooks duplicados.

message.deleted

Disparado quando uma mensagem é apagada (revogada).
message_id
string
required
ID da mensagem apagada.
chat_jid
string
required
JID do chat onde a mensagem estava.
sender_jid
string
required
JID de quem enviou a mensagem original.
is_from_me
boolean
required
true quando a mensagem apagada foi enviada pela própria sessão.
timestamp
number
required
Momento da exclusão em milissegundos (epoch).

message.update

Disparado quando uma mensagem é editada. Traz o novo texto e o momento da edição.
message_id
string
required
ID da mensagem editada.
chat_jid
string
required
JID do chat onde a mensagem está.
sender_jid
string
required
JID de quem enviou a mensagem.
is_from_me
boolean
required
true quando a mensagem editada foi enviada pela própria sessão.
new_text
string
required
Novo conteúdo da mensagem após a edição.
timestamp
number
required
Momento da mensagem original em milissegundos (epoch).
edit_timestamp
number
required
Momento da edição em milissegundos (epoch).