> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inceptia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> API para consultar campanhas, casos e chamadas dos seus bots.

## 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.

<Card title="Primeiros passos" icon="rocket" href="/pt-BR/api-reference/quickstart">
  Crie sua primeira campanha em 4 passos
</Card>

## 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.

<Steps>
  <Step title="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.
  </Step>

  <Step title="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).
  </Step>

  <Step title="Integre">
    Com isso, você já pode seguir o guia de [Primeiros passos](/pt-BR/api-reference/quickstart).
  </Step>
</Steps>

## Servidores

| Ambiente | URL                             |
| -------- | ------------------------------- |
| Testes   | `https://admintest.inceptia.ai` |
| Produção | `https://admin.inceptia.ai`     |

## Autenticação

Todos os endpoints (exceto login e refresh) exigem um token JWT no cabeçalho:

```
Authorization: Bearer <access_token>
```

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.