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

CanalCompatívelObservação
WhatsApp (Web)Sim
WhatsApp (API oficial)Sim
InstagramSim
MessengerSim
TelegramSim

Conversa alterada

{
  "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