Status de mensagens

Estes eventos notificam mudanças no ciclo de vida de uma mensagem após o envio: quando ela é entregue, lida ou apagada. Todos seguem o envelope comum — o conteúdo específico fica em data. Edição de mensagem não aparece aqui: ela chega como uma mensagem normal em messages.received, com type: "edited_message".

`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.

{
  "event": "message.read",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:00:00.000Z",
  "data": {
    "message_id": "3EB0F61B5D1F94FAFCD306",
    "remote_jid": "5511999999999@s.whatsapp.net",
    "participant": "",
    "timestamp": 1769295600000
  }
}

string

required

ID da mensagem cujo status mudou.

string

required

JID do chat (contato ou grupo) onde a mensagem está.

string

JID do participante que confirmou a entrega/leitura. Só é preenchido em grupos; em conversas individuais vem como string vazia ("").

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).

{
  "event": "message.deleted",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:01:00.000Z",
  "data": {
    "message_id": "3EB0F61B5D1F94FAFCD306",
    "chat_jid": "5511999999999@s.whatsapp.net",
    "sender_jid": "5511999999999@s.whatsapp.net",
    "is_from_me": false,
    "timestamp": 1769295660000
  }
}

string

required

ID da mensagem apagada.

string

required

JID do chat onde a mensagem estava.

string

required

JID de quem enviou a mensagem original.

boolean

required

true quando a mensagem apagada foi enviada pela própria sessão.

number

required

Momento da exclusão em milissegundos (epoch).

`message.update`

Este evento não é disparado. Edições de mensagem chegam pelo evento messages.received com type: "edited_message" — veja o exemplo edited_message naquela página. O formato abaixo permanece documentado apenas para quem já tinha o message.update configurado; ele nunca é enviado.

{
  "event": "message.update",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:02:00.000Z",
  "data": {
    "message_id": "3EB0F61B5D1F94FAFCD306",
    "chat_jid": "5511999999999@s.whatsapp.net",
    "sender_jid": "5511999999999@s.whatsapp.net",
    "is_from_me": false,
    "new_text": "Texto corrigido",
    "timestamp": 1769295720000,
    "edit_timestamp": 1769295725000
  }
}

string

required

ID da mensagem editada.

string

required

JID do chat onde a mensagem está.

string

required

JID de quem enviou a mensagem.

boolean

required

true quando a mensagem editada foi enviada pela própria sessão.

string

required

Novo conteúdo da mensagem após a edição.

number

required

Momento da mensagem original em milissegundos (epoch).

number

required

Momento da edição em milissegundos (epoch).

Introdução

API Oficial (SaaS)

Assistente de Integração

Ligações

Webhooks

Status de mensagens

`message.delivered` e `message.read`

`message.deleted`

`message.update`

​message.delivered e message.read

​message.deleted

​message.update

`message.delivered` e `message.read`

`message.deleted`

`message.update`