Evento por instância

messages.update

Atualizacao de recibo/status de uma mensagem ja conhecida.

flag: messagesUpdated

Requisição

http

POST /webhooks/codechat HTTP/1.1
Content-Type: application/json
x-webhook-event: messages.update

Payload

json

{
  "data": {
    "dateTime": "2026-07-04T18:05:00Z",
    "messageId": 1024,
    "status": "read"
  },
  "event": "messages.update",
  "instance": {
    "connectionStatus": "online",
    "externalAttributes": {},
    "id": 1,
    "name": "codechat",
    "ownerJid": "[email protected]"
  },
  "timestamp": "2026-07-04T18:00:00Z"
}

messageIdnumber

obrigatório, não aceita `null`. ID interno da mensagem persistida.

statusstring

obrigatório, não aceita `null`. Status normalizado do recibo. Valores possíveis: `delivered`, `sent`, `read`, `played`, `server_error`, `retry`, `unknown`.

dateTimestring

obrigatório, não aceita `null`. Timestamp RFC3339 UTC do recibo; usa o timestamp do evento ou o horario do processamento.

Observações de entrega

Quando a mensagem referenciada nao e encontrada, o evento e descartado apos as tentativas configuradas no handler.
Implemente idempotência por chave de negócio e aceite a possibilidade de duplicidades e reordenação.