Pular para o conteúdo principal

​
Bem-vindo

A API da Inceptia permite integrar e automatizar a gestão de campanhas conversacionais: criar campanhas, carregar casos, consultar resultados e baixar gravações.

Primeiros passos

Crie sua primeira campanha em 4 passos

​
Antes de começar

Para usar a API você precisa de uma conta de usuário com pelo menos um bot atribuído. O acesso é gerenciado pelo seu administrador da Inceptia.
1

Solicite seu acesso

Entre em contato com seu administrador e peça que criem um usuário com acesso ao bot que você vai integrar. Sem essa atribuição, a API retorna uma lista de bots vazia.
2

Receba suas credenciais

Seu administrador vai compartilhar o e-mail e a senha para você se autenticar, e vai confirmar em qual ambiente você pode operar (testes ou produção).
3

Integre

Com isso, você já pode seguir o guia de Primeiros passos.

​
Servidores

​
Autenticação

Todos os endpoints (exceto login e refresh) exigem um token JWT no cabeçalho:
Você obtém o token chamando POST /auth/login/ com seu e-mail e senha. O token expira — use POST /auth/token/refresh/ para renová-lo sem se autenticar novamente.

​
Paginação

Os endpoints de listagem usam duas estratégias:
  • Baseada em cursor (next / previous como URLs): campanhas.
  • Offset (count + next / previous): casos, chamadas e inbound.
Siga o campo next da resposta para obter a próxima página.