Paginação

As listas usam um de dois formatos. A referência de cada endpoint mostra qual.

Por página

Usada nas listas de cadastros (pessoas, contatos, oportunidades, tickets etc.).

Parâmetro	Padrão	Máximo
pagina	1	—
porPagina	50	200

curl -s "https://api.botzetta.com/plataforma/v1/pessoas?pagina=2&porPagina=100" \
  -H "Authorization: Bearer <token>"

{
  "dados": [{ "id": 345, "nome": "Maria Exemplo" }],
  "pagina": 2,
  "porPagina": 100,
  "total": 1873
}

Continue enquanto pagina * porPagina < total. Algumas listas pequenas (filas, tags, conexões) respondem só { "dados": [...] }, sem paginação.

Para sincronizar, combine com o filtro atualizadoDesde (quando o endpoint tiver): guarde a data da última sincronização e peça só o que mudou depois dela.

Por cursor

Usada no histórico de mensagens (GET /tickets/{id}/mensagens e GET /contatos/{id}/mensagens), em que mensagens novas chegam enquanto você pagina.

Parâmetro	Padrão	Máximo
limite	50	200
cursor	— (primeira página)	—

{
  "dados": [{ "id": 99812, "texto": "Olá!", "interna": false }],
  "proximoCursor": "eyJjIjoiMjAyNi0xMC0yN1Qx…"
}

• As mais novas vêm primeiro.
• Repasse o proximoCursor como cursor na chamada seguinte. null indica o fim.
• O cursor é opaco: não tente montar nem alterar. Cursor alterado responde 400 ERR_VALIDACAO.
• A paginação é estável: mensagens que chegam durante a leitura não fazem a página seguinte repetir nem pular itens. Não há total.