# Paginacao, filtros e respostas

Muitos endpoints retornam listas paginadas. O formato pode variar por recurso, mas geralmente a resposta vem com `payload` e `meta`.

## Exemplo

```bash
curl -X GET "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/conversations?page=2" \
  -H "api_access_token: $API_TOKEN"
```

## Filtros comuns

Filtros variam por endpoint. Os mais frequentes sao:

- `page`
- `status`
- `inbox_id`
- `team_id`
- `assignee_id`
- `from`
- `to`
- `q`

## Recomendacao para integracoes

- Sempre leia a resposta antes de assumir formato fixo.
- Trate pagina vazia como fim da sincronizacao.
- Grave IDs externos para evitar duplicidade.
- Nao use consultas grandes em tempo real se puder sincronizar em lote.
- Em retries, evite repetir criacoes sem idempotencia.

## Exemplo de loop conceitual

```text
page = 1
while true:
  buscar page
  se payload vazio: parar
  processar itens
  page += 1
```