Início rápido

Crie a chave

No conecta/ai, abra Configurações › Integrações › Chaves de API e clique em Nova chave. Dê um nome que diga para que ela serve, como “BI da equipe de TI”, e marque Leitura de conversas. A chave começa com ck_ e aparece uma única vez: copie na hora.

Criar chave exige a permissão de editar integrações no conecta/ai.

Liste as conversas

Guarde a chave numa variável de ambiente e chame a lista de conversas:

export CONECTAAI_API_KEY="ck_..."
 
curl "https://app.conectaai.io/api/v1/conversations?status=resolved&created_after=2026-11-09T03:00:00Z" \
  -H "Authorization: Bearer $CONECTAAI_API_KEY"

A resposta traz até 50 conversas em data, da mais recente para a mais antiga, e um next_cursor quando há mais. Datas são sempre em UTC: meia-noite em Brasília é 03:00:00Z.

Leia as mensagens

Pegue o id de uma conversa e peça as mensagens dela, na ordem em que aconteceram:

curl "https://app.conectaai.io/api/v1/conversations/<id>/messages" \
  -H "Authorization: Bearer $CONECTAAI_API_KEY"

Cada mensagem diz quem escreveu em author_type: customer, ai, human_agent, system ou event.