# Conversa alterada

**Evento:** `chat.updated` · **Transporte:** POST para o seu receptor

Mudou o estado de uma conversa (arquivada, fixada, etiquetas, nome, foto, não lidas, responsável, atendimento aberto...). `chat` traz o estado novo e `changes`, o que mudou. A conversa vem inteira, como em `GET /chats/{chat_id}`, com o `lead` (raro: sem ele quando a api não conseguiu ler a conversa; mantenha o que tem) e o `reply_window_until`, mas só com o que a api tem gravado: sem `automation`, sem `group.parent_community`, sem o `name` de `last_message_author` em grupo e sem o que o detalhe busca no WhatsApp (foto nova, grupos em comum, perfil comercial). Mudanças do lead (etapa, tags, campos) chegam em `lead.updated`. Assine `chat.updated` num webhook (`POST /webhooks`).

## Mensagem nova

Na mensagem nova, as não lidas (`unread_count`), a vez de responder (`awaiting_reply`) e a prévia (`last_message_*`) vêm em `data.chat` do `message.received` e do `message.sent`, que trazem a conversa como fica depois da mensagem. Por isso, quando a mensagem só mudou as não lidas, a vez e a prévia, este evento não vai para quem recebe o `message.received` ou o `message.sent` dela (assina o evento e o `exclude` não o corta). Quem não recebe (não assina, ou exclui `in`, `out`, `groups`...) continua recebendo o `chat.updated`. Se a mensagem mudou outra coisa (o nome do contato, por exemplo), o `chat.updated` sai para todos, com `changes` listando tudo o que mudou. Fora de mensagem (a conversa lida no celular ou por `PATCH /chats`, arquivada...), as não lidas e a vez continuam saindo aqui. Edição, reação, voto e ligação também não são mensagem nova: o que mudarem na conversa sai aqui (a prévia nova, em `changes`, como `last_message`).

A conversa nova continua gerando `chat.updated` (com `changes` vazio) uma vez, na primeira mensagem.

**Estado:** Disponível

## Compatibilidade de canais

| Canal | Compatível | Observação |
|---|---|---|
| WhatsApp (Web) | Sim |  |
| WhatsApp (API oficial) | Sim |  |
| Instagram | Sim |  |
| Messenger | Sim |  |
| Telegram | Sim |  |

### Conversa alterada

```json
{
  "id": "evt_01JAB3K9ZQ7V0M4T8R2X6WYD5H",
  "type": "chat.updated",
  "created_at": "2026-10-17T12:00:00.000Z",
  "inbox": {
    "id": "r0269625d29bfbd",
    "name": "loja",
    "phone": "5511888888888",
    "channel": "whatsapp_web"
  },
  "data": {
    "chat": {
      "id": "5511999999999@s.whatsapp.net",
      "type": "direct",
      "name": "Maria",
      "archived": true,
      "unread_count": 0
    },
    "changes": [
      "archived"
    ]
  }
}
```

## Referências

- [Eventos e webhooks](/docs/webhook)
- [Contrato OpenAPI completo](/openapi-bundled.json)