Histórico e sincronização

Ao conectar, a sessão realiza uma sincronização de histórico (backfill), trazendo conversas, contatos e mensagens anteriores. Estes eventos refletem esse processo.

A entrega no webhook difere bastante da entrega no RabbitMQ para estes eventos. Alguns eventos de histórico são suprimidos no webhook para evitar uma enxurrada de chamadas durante o backfill, e um deles é convertido para outro evento. Leia os detalhes abaixo com atenção.

Resumo de entrega

Evento	Entregue no webhook?	Entregue no RabbitMQ?
`history.message.upsert`	Não (suprimido)	Sim (quando configurado)
`history.message.received`	Não (suprimido)	Sim (quando configurado)
`history.messages.sent`	Convertido para `messages.received` com `fromMe: true` (apenas recentes < 5 min)	Sim (mantém o nome original)
`history_sync`	Sim	Sim
`appstate.agent.update`	Sim	Sim

`history.message.upsert` e `history.message.received`

São os eventos das mensagens trazidas pelo backfill.

Estes eventos não são entregues no webhook — eles são suprimidos para evitar uma enxurrada de chamadas durante o backfill. Ficam disponíveis apenas via RabbitMQ (quando configurado).

Os dados da mensagem seguem o mesmo formato de messages.received (id, from, to, type, timestamp, etc.), porém:

sem mídia — a mídia é filtrada durante a sincronização;
com os JIDs normalizados.

`history.messages.sent`

São as mensagens enviadas de outro dispositivo identificadas durante o histórico.

No webhook, este evento não chega com o nome history.messages.sent. As mensagens enviadas de outro dispositivo só são entregues se forem recentes (menos de 5 minutos) e são convertidas para o evento messages.received com fromMe: true.Via RabbitMQ, o evento mantém o nome original history.messages.sent.

`history_sync`

Entregue normalmente no webhook. É o sinal de conclusão/resumo do backfill, com os agregados sincronizados.

{
  "event": "history_sync",
  "sessionId": "minha-sessao",
  "data": {
    "chats": [],
    "contacts": [],
    "messages": []
  },
  "timestamp": "2026-01-24T22:00:40.000Z"
}

chats

array

required

Conversas sincronizadas. Cada item segue o formato de chats.update.

contacts

array

required

Contatos sincronizados. Cada item segue o formato de contacts.update.

messages

array

required

Mensagens sincronizadas. Cada item segue o formato de mensagem do histórico.

`appstate.agent.update`

Entregue no webhook. Representa mudanças de dispositivos/agentes vinculados (multi-device) durante a sincronização do AppState.

{
  "event": "appstate.agent.update",
  "sessionId": "minha-sessao",
  "data": {
    "index": 0,
    "name": "Dispositivo Web",
    "device_id": "...",
    "is_deleted": false
  },
  "timestamp": "2026-01-24T22:00:41.000Z"
}

index

number

Índice do dispositivo/agente. Opcional.

name

string

Nome do dispositivo/agente. Opcional.

device_id

string

Identificador do dispositivo. Opcional.

is_deleted

boolean

true quando o dispositivo/agente foi removido. Opcional.

Introdução

Assistente de Integração

Ligações

Webhooks

Histórico e sincronização

Resumo de entrega

`history.message.upsert` e `history.message.received`

`history.messages.sent`

`history_sync`

`appstate.agent.update`

​Resumo de entrega

​history.message.upsert e history.message.received

​history.messages.sent

​history_sync

​appstate.agent.update

Resumo de entrega

`history.message.upsert` e `history.message.received`

`history.messages.sent`

`history_sync`

`appstate.agent.update`