history.synced

EVENTOhistory.synceddesde M3envelope v1

Histórico sincronizado.

Quando é emitido

Depois do pareamento, o WhatsApp envia o histórico de conversas em blocos. O LiteZap grava tudo no log sem gerar um evento por mensagem e emite um único history.synced por sync, 15 segundos depois do último bloco. Bom momento para recarregar GET /chats.

Campos de data

Campo	Tipo	Descrição
chats	integer	Blocos de histórico ingeridos (cerca de um por chat).
messages	integer	Mensagens nesses blocos.
new_messages	integer	Mensagens que ainda não estavam no log.

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_5c1e8a4d0b7f2396",
  "type": "history.synced",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-17T13:41:30.902Z",
  "data": {
    "chats": 48,
    "messages": 3120,
    "new_messages": 3120
  }
}

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": ["history.synced"] no webhook, ou?types=history.synced no SSE.

Relacionados: instance.status

Equivalente na Z-API: (sem equivalente).