Skip to main content

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

Primeros pasos

Crea tu primera campaña en 4 pasos

​
Antes de empezar

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

Solicita tu acceso

Contacta a tu administrador y pide que te creen un usuario con acceso al bot que necesitas integrar. Sin esa asignación, la API devuelve una lista de bots vacía.
2

Recibe tus credenciales

Tu administrador te comparte el email y contraseña para autenticarte, y confirma en qué ambiente puedes operar (pruebas o producción).
3

Integra

Con eso ya puedes seguir la guía de Primeros pasos.

​
Servidores

​
Autenticación

Todos los endpoints (excepto login y refresh) requieren un token JWT en el header:
Obtienes el token llamando a POST /auth/login/ con tu email y contraseña. El token expira — usa 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.
Sigue el campo next de la respuesta para obtener la página siguiente.