La API de Conversación con IA de Leadway ofrece a los desarrolladores control programático sobre agentes de IA, acciones y generación de conversaciones.
Con ella puedes utilizar tokens seguros y permisos granulares para:
-
Automatizar la configuración de agentes
-
Integrarte con aplicaciones externas
-
Exportar datos de conversación para análisis o cumplimiento normativo
Esta guía explica qué es la API, sus beneficios, las opciones de autenticación (PIT y JWT), las familias de endpoints disponibles y los pasos para configurarla, incluyendo capturas de pantalla.
¿Qué es la API de Conversación con IA?
La API de Conversación con IA expone las mismas capacidades principales que encuentras en la interfaz de Conversación con IA: crear y administrar agentes, asignar acciones y obtener detalles de las respuestas generadas por la IA.
Esto permite que tu equipo automatice configuraciones y conecte Conversación con IA directamente con tus propios sistemas.
Con esta API puedes:
-
Crear y configurar agentes a gran escala
-
Actualizar acciones mediante scripts
-
Obtener datos detallados por mensaje para reportes, métricas y auditorías
En pocas palabras, te permite integrar y operar Conversación con IA de forma automatizada y totalmente personalizada.
Autenticación (PIT y JWT)
Elegir el método de autenticación adecuado garantiza un acceso seguro y confiable.
Los Tokens de Integración Privada (PIT) son rápidos de generar y permiten definir permisos específicos.
Los JSON Web Tokens (JWT) permiten flujos basados en OAuth para aplicaciones más complejas.
Ambos métodos funcionan para acceder a la API de Conversación con IA.
Para generar tus credenciales:
-
Ve a Configuración → Integraciones privadas dentro de tu cuenta en Leadway.
-
Proporciona la información básica (nombre y descripción).
-
Selecciona los scopes de Conversación con IA.
-
Crea el token y guarda una copia en un lugar seguro.
Acciones
-
Adjuntar una acción a un agente
-
Listar acciones de un agente
-
Obtener una acción por ID
-
Actualizar una acción
-
Remover una acción de un agente
-
Actualizar la configuración de seguimiento (follow-up)
-
Crear un agente
-
Buscar agentes
-
Actualizar un agente
-
Obtener un agente
-
Eliminar un agente