Skip to main content

​
Bienvenido a la API de Inagent

La API de Inagent permite crear, administrar y supervisar agentes virtuales, así como integrar herramientas externas y automatizar procesos en tiempo real. Está diseñada para que desarrolladores y equipos técnicos puedan orquestar sesiones, consultar información de reportes, integrar canales y manipular la experiencia del cliente desde sus propias aplicaciones.
Toda la API es RESTful y trabaja con datos en formato JSON.
Los endpoints están agrupados en categorías como Gestión de agentes y equipos, Supervisión y administración de sesiones, Reportes, Herramientas y Webhooks.

​
Autenticación

Todos los endpoints requieren autenticación mediante Bearer Token.
Debes incluir el header: Authorization: Bearer <tu_token_de_api> Puedes generar y administrar tus tokens en el panel de Inagent.
Protege siempre tus tokens.
Recomendamos almacenarlos en variables de entorno y no incluirlos en repositorios.

​
Estructura de la API

La API está organizada en grupos de endpoints:
  • Equipos y Agentes
    Creación y gestión de equipos de agentes virtuales, incluyendo canales, configuraciones y publicación.
  • Sesiones y Administración
    Control en tiempo real de conversaciones: pausar, reanudar, agregar contexto, transferir a otro agente, enviar mensajes en nombre del asistente o inyectar herramientas.
  • Reportes y Métricas
    Consulta de reportes del sistema, KPIs personalizados y exportación de datos de conversación.
  • Herramientas y Webhooks
    Integración de herramientas externas, notificaciones en tiempo real y automatizaciones basadas en eventos.

​
Formato de respuesta

Todas las respuestas siguen una estructura estándar: 
{
  "data": { /* datos solicitados */ },
  "meta": { /* información de paginación u otros metadatos */ }
}
En caso de error, se devuelve un código HTTP adecuado (4xx o 5xx) y un objeto con detalles del fallo: 
{
  "error": "Descripción del error",
  "code": "código_interno"
}
Próximos pasos

Referencia de endpoints

Explora la lista completa de endpoints para equipos, agentes, sesiones, reportes y herramientas.

Webhooks

Aprende a recibir notificaciones en tiempo real de los eventos más importantes.

API de administración de sesiones

Controla y modifica conversaciones en vivo: agrega contexto, transfiere, pausa o finaliza sesiones.
 ✅ Este texto:
  • Da contexto de uso real (gestión de agentes, sesiones, reportes y herramientas).
  • Incluye estructura de autenticación y de respuesta JSON.
  • Añade cards con los principales puntos de entrada (endpoints, webhooks, administración de sesiones) para una navegación rápida.