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

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

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