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:

1. Ve a **Configuración → Integraciones privadas** dentro de tu cuenta en **Leadway**.

   ![](https://storage.googleapis.com/chatwoot-leadway-data/w9tc48e2o0vh86xhmz9wx1jg9hma)

   Proporciona la información básica (nombre y descripción).

   

2. Selecciona los **scopes de Conversación con IA**.

   \
   ![](https://storage.googleapis.com/chatwoot-leadway-data/orr94p4syflp17sxh63xfihatcpi)

3. Crea el token y guarda una copia en un lugar seguro.

   ![](https://storage.googleapis.com/chatwoot-leadway-data/on1n3xxeq8ahjzplohwran60695f)

   

# 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