Saltar al contenido principal
La API de IA conversacional te da control programático sobre tus agentes de IA, sus acciones y las respuestas que generan. Es útil cuando quieres crear o ajustar agentes desde tus propios sistemas, mantener la misma configuración en varios bots o exportar el detalle de las respuestas para análisis y auditoría. Expone las mismas capacidades que ves en IA → IA conversacional: crear y administrar agentes, conectarles acciones y consultar el detalle de cada respuesta generada.

​
Qué puedes hacer con la API

  • Crear, buscar, actualizar y eliminar agentes de IA conversacional.
  • Conectar acciones a un agente, editarlas o quitarlas.
  • Ajustar la configuración de seguimiento automático de un agente.
  • Consultar el detalle de cada respuesta generada por la IA (generaciones).
  • Integrar la IA conversacional con tus aplicaciones internas y construir informes o registros de cumplimiento propios.

​
Para qué le sirve a tu negocio

​
Autenticación

Puedes autenticarte de dos formas:

​
Crear un token de integración privada

1

Abre las integraciones privadas

En tu cuenta de Chateea, ve a Configuración → Integraciones privadas.
2

Crea una nueva integración

Dale un nombre y una descripción que te permitan reconocer para qué se usa.
3

Elige los alcances de IA conversacional

Marca solo los permisos que necesitas. Si tu integración solo va a leer datos, elige los alcances de lectura.
4

Genera y copia el token

Guárdalo en un lugar seguro, como el gestor de secretos de tu servidor.
Trata el token como una contraseña. No lo publiques en código del lado del navegador ni en repositorios, y revócalo si crees que se expuso.
Para obtener la URL base y la documentación completa de los endpoints de la API de Chateea, escribe a soporte en [email protected].

​
Endpoints disponibles

​
Agentes

  • Crear un agente
  • Buscar agentes
  • Obtener un agente
  • Actualizar un agente
  • Eliminar un agente

​
Acciones

  • Conectar una acción a un agente
  • Listar las acciones de un agente
  • Obtener una acción por su ID
  • Actualizar una acción
  • Quitar una acción de un agente
  • Actualizar la configuración de seguimiento

​
Generaciones

  • Obtener el detalle de una generación (la respuesta de la IA a nivel de mensaje)

​
Preguntas frecuentes

Usa un token generado desde tu propia cuenta de Chateea, para que las llamadas actúen dentro de ella.
Sí. Puedes crear, actualizar, consultar y eliminar agentes de IA conversacional sin entrar a la interfaz.
Sí. Elige el token de integración privada para integraciones de servidor a servidor y JWT para aplicaciones con flujo OAuth.
Crea o busca agentes con los endpoints de Agentes y usa el campo id que devuelve la respuesta en las llamadas siguientes.
Usa el endpoint de Generaciones para obtener el detalle de cada respuesta y guárdalo en tu sistema de análisis o cumplimiento.
Normalmente se debe a que faltan alcances en el token, a permisos incorrectos o a que intentas acceder a recursos de otra cuenta.

​
Artículos relacionados

El agente conversacional

Cómo funciona la IA conversacional en tu cuenta.

Detalles del mensaje de IA

Revisa y edita las respuestas de la IA desde la bandeja.
Última modificación el 29 de septiembre de 2026