En este tutorial conocerás la API Pública de IA Conversacional de CRMHUB, que permite a los equipos de desarrollo controlar programáticamente los agentes de IA, sus acciones y los datos de conversación.
📋 Contenido de este Tutorial
🔌 Introducción
⚙️ Capacidades principales
✅ Beneficios clave
🔐 Métodos de autenticación
🛠️ Proceso de configuración
⚠️ Requisitos importantes
🔌 Introducción
La API de IA Conversacional da a los equipos de desarrollo control programático sobre los agentes de IA, sus acciones y los datos de generación de conversaciones. Permite automatizar lo que ya está disponible en la interfaz, incluyendo la creación de agentes, la configuración de acciones y el análisis de respuestas; ideal para agencias y plataformas que gestionan IA a gran escala.
⚙️ Capacidades principales
Gestión de agentes:
Crear, buscar, actualizar, consultar y eliminar Agentes de IA.
Gestionar configuraciones de agentes de forma programática.
Configuración de acciones:
Adjuntar acciones a los agentes.
Listar, consultar y actualizar acciones.
Eliminar acciones de un agente.
Configurar ajustes de seguimiento (followup).
Consulta de datos:
Acceder al detalle de las generaciones (información de la respuesta de IA a nivel de mensaje).
Exportar datos de conversación para análisis y cumplimiento.
✅ Beneficios clave
Configuración más rápida: automatiza la creación de agentes y la asignación de acciones para nuevas subcuentas.
Operación a escala: aplica configuraciones consistentes entre subcuentas mediante scripts.
Acceso a analítica: obtén datos detallados de generación para auditorías y control de calidad.
Integración flexible: conecta CRMHUB con herramientas externas.
Control de seguridad: usa alcances (scopes) granulares para limitar el acceso solo a lo necesario.
🔐 Métodos de autenticación
Tokens de Integración Personal (PIT): configuración rápida para integraciones servidor a servidor.
JSON Web Tokens (JWT): compatible con flujos de aplicaciones basados en OAuth.
Ambos métodos requieren seleccionar los alcances de IA Conversacional correspondientes al crear el token en la configuración de Integraciones Privadas.
🛠️ Proceso de configuración
Abre Configuración → Integraciones Privadas en tu subcuenta.
Crea un nuevo token con la información básica (nombre, descripción).
Selecciona los alcances relevantes de IA Conversacional.
Genera el token y guárdalo de forma segura.
⚠️ Requisitos importantes
Usa tokens de subcuenta (no de agencia) para mantener el contexto de ubicación correcto.
Los alcances y permisos deben coincidir con las operaciones de API que planeas realizar.
Los errores 403 normalmente indican alcances faltantes o intentos de acceso no autorizados.
❓ Preguntas Frecuentes
¿Debo usar un token de agencia o de subcuenta? Usa siempre un token de subcuenta para mantener el contexto de ubicación correcto.
¿Qué significa un error 403? Generalmente indica que faltan alcances (scopes) o que se está intentando un acceso no autorizado.
¿Puedo exportar los datos de conversación para auditoría? Sí, la API permite acceder al detalle de generación y exportar datos de conversación para análisis y cumplimiento.
🚀 ¡Automatiza y escala tu operación de IA Conversacional con control total desde tu propio código!