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

# Introducción

> API para consultar campañas, casos y llamadas de tus bots.

## Bienvenido

La API de Inceptia te permite integrar y automatizar la gestión de campañas conversacionales: crear campañas, cargar casos, consultar resultados y descargar grabaciones.

<Card title="Primeros pasos" icon="rocket" href="/api-reference/quickstart">
  Creá tu primera campaña en 4 pasos
</Card>

## Antes de empezar

Para usar la API necesitás una cuenta de usuario con al menos un bot asignado. El acceso lo gestiona tu administrador de Inceptia.

<Steps>
  <Step title="Solicitá tu acceso">
    Contactá a tu administrador y pedí que te creen un usuario con acceso al bot que vas a integrar. Sin esa asignación, la API devuelve una lista de bots vacía.
  </Step>

  <Step title="Recibí tus credenciales">
    Tu administrador te va a compartir el email y contraseña para autenticarte, y confirmará en qué ambiente podés operar (pruebas o producción).
  </Step>

  <Step title="Integrá">
    Con eso ya podés seguir la guía de [Primeros pasos](/api-reference/quickstart).
  </Step>
</Steps>

## Servidores

| Ambiente   | URL                             |
| ---------- | ------------------------------- |
| Pruebas    | `https://admintest.inceptia.ai` |
| Producción | `https://admin.inceptia.ai`     |

## Autenticación

Todos los endpoints (excepto login y refresh) requieren un token JWT en el header:

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

Obtenés el token llamando a `POST /auth/login/` con tu email y contraseña. El token expira — usá `POST /auth/token/refresh/` para renovarlo sin volver a autenticarte.

## Paginación

Los endpoints de listado usan dos estrategias:

* **Cursor-based** (`next` / `previous` como URLs): campañas.
* **Offset** (`count` + `next` / `previous`): casos, llamadas e inbound.

Seguí el campo `next` de la respuesta para obtener la página siguiente.