# Lote do histórico

**Evento:** `history.batch` · **Transporte:** POST para o seu receptor

Parte da sincronização de histórico (ao parear ou pedida em `POST /chats/history-sync`). Cada lote traz mensagens (ligações vêm como mensagens com `type: call`) ou conversas, até 200 por evento. O fim chega em `history.completed`. Assine `history.batch` num webhook (`POST /webhooks`) ou, pelo nome, no `GET /events` (o histórico do pareamento são milhares de mensagens: sem `events`, não vem). Etiquetas não vêm aqui: use `POST /labels/sync`.

**Estado:** Disponível

## Compatibilidade de canais

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

### Lote do histórico

```json
{
  "id": "evt_01JAB3K9ZQ7V0M4T8R2X6WYD5H",
  "type": "history.batch",
  "created_at": "2026-10-17T12:00:00.000Z",
  "inbox": {
    "id": "r0269625d29bfbd",
    "name": "loja",
    "phone": "5511888888888",
    "channel": "whatsapp_web"
  },
  "data": {
    "chunk": {
      "index": 0,
      "has_more": true
    },
    "messages": [
      {
        "id": "3EB05DCE1D4036FCE241C6",
        "chat_id": "5511999999999@s.whatsapp.net",
        "author": {
          "id": "5511888888888@s.whatsapp.net",
          "name": "Loja"
        },
        "direction": "out",
        "sent_by": "api",
        "sent_at": "2026-10-17T12:00:00.000Z",
        "category": "conversation",
        "type": "text",
        "text": "Seu pedido saiu para entrega.",
        "track_source": "crm",
        "track_id": "42"
      }
    ]
  }
}
```

## Referências

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