Paginação

As listas devolvem uma página por vez:

{
  "data": [ ... ],
  "next_cursor": "WyIyMDI2LTExLTA5VDE0OjMyOjA1LjEyMFoiLCI4ZjBjIl0"
}

limit define quantos itens vêm por página, de 1 a 100. O padrão é 50.
next_cursor vem preenchido quando há mais itens. Passe-o em cursor para buscar a próxima página, com os mesmos filtros.
next_cursor: null é o fim da lista.

curl "https://app.conectaai.io/api/v1/conversations?limit=100&cursor=WyIyMDI2LTEx..." \
  -H "Authorization: Bearer $CONECTAAI_API_KEY"

Por que cursor e não número de página

Conversas novas chegam enquanto você percorre a lista. Com número de página, um item novo empurra os outros e você leria um deles duas vezes, ou pularia outro. O cursor marca o último item entregue, e a próxima página começa logo depois dele.

A ordem de cada lista

Lista	Ordem
Conversas	Da mais recente para a mais antiga, pela data de início
Mensagens de uma conversa	Da primeira para a última
Contatos	Do mais recente para o mais antigo, pela data de criação
Etiquetas	Alfabética, sem paginação

O cursor é opaco: não monte nem altere. Cursor inválido responde 400 com code: "invalid_parameter".

Autenticação e permissões Erros