Referência/Webhooks/messages.undecryptable
Evento por instância

messages.undecryptable

Mensagem recebida sem possibilidade de descriptografia.

flag: messagesUndecryptable

Requisição

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

Payload

json
{
"data": {
"chatJid": "[email protected]",
"dateTime": "2026-07-04T18:00:00Z",
"decryptFailMode": "hide",
"isUnavailable": true,
"keyFromMe": false,
"keyId": "ABC123",
"senderJid": "[email protected]",
"unavailableType": "view_once"
},
"event": "messages.undecryptable",
"instance": {
"connectionStatus": "online",
"externalAttributes": {},
"id": 1,
"name": "codechat",
"ownerJid": "[email protected]"
},
"timestamp": "2026-07-04T18:00:00Z"
}
keyIdstring

obrigatório, não aceita `null`. ID da chave/mensagem que falhou.

chatJidstring

obrigatório, não aceita `null`. JID da conversa.

senderJidstring

opcional, não aceita `null`. JID do remetente quando disponivel; omitido quando ausente.

keyFromMeboolean

obrigatório, não aceita `null`. Indica se a mensagem e da propria instancia.

isUnavailableboolean

obrigatório, não aceita `null`. Indica se o conteudo foi marcado como indisponivel.

unavailableTypestring

opcional, não aceita `null`. Tipo de indisponibilidade. Valores possíveis: `view_once`.

decryptFailModestring

opcional, não aceita `null`. Modo de falha reportado. Valores possíveis: `hide`.

dateTimestring

obrigatório, não aceita `null`. Timestamp RFC3339 UTC do evento ou do processamento.

Observações de entrega

  • Campos vazios sao omitidos por omitempty.
  • Implemente idempotência por chave de negócio e aceite a possibilidade de duplicidades e reordenação.