chat.updated

EVENTOchat.updateddesde M9envelope v1

Chat alterado.

Quando é emitido

Um chat foi arquivado/desarquivado, fixado, silenciado, marcado como (não) lido, apagado ou limpo, ou uma mensagem foi favoritada, pela API (source: "api") ou em qualquer aparelho da conta (source: "device"). Sai uma vez por mudança: o eco que o WhatsApp devolve das ações da API não duplica. changed diz o que mudou; os demais campos são o estado do chat depois da mudança.

Campos de data

Campo	Tipo	Descrição
chat	string	JID do chat.
changed	array	archived, pinned, muted, unread, deleted, cleared ou starred.
archived	boolean	Arquivado.
pinned	boolean	Fixado.
muted	boolean	Silenciado.
muted_until	string	Fim do silêncio (opcional; ausente = até reativar).
unread	boolean	Marcado como não lido.
starred	boolean	starred: estado novo da mensagem (opcional).
source	string	api ou device.

O envelope (id, type, version, instance_id, timestamp,data) está em Visão geral. Campos novos podem ser adicionados emdata sem mudar a versão: ignore os que não conhecer.

Exemplos

Corpo do POST

{
  "id": "evt_1b7e5c3a9d2f4086",
  "type": "chat.updated",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-18T10:10:00.000Z",
  "data": {
    "chat": "5511999999999@s.whatsapp.net",
    "changed": [
      "archived"
    ],
    "archived": true,
    "pinned": false,
    "muted": false,
    "unread": false,
    "source": "device",
    "timestamp": "2026-10-18T10:10:00Z"
  }
}

Entrega e ordem

• Por webhook: pelo menos uma vez, com retry por até 24 horas. O mesmo evento pode chegar duas vezes: deduplique porX-LiteZap-Event-Id. Veja Entrega e retentativas.
• A ordem entre eventos não é garantida (retentativas reordenam): use timestamp.
• Por SSE: ao vivo, sem replay. Veja Tempo real com SSE.
• Para assinar só este tipo: "events": ["chat.updated"] no webhook, ou?types=chat.updated no SSE.

Equivalente na Z-API: Webhook de chats.