Saltar al contenido principal

AI Action (Constructor de Flujos)

Las AI Action permiten integrar APIs externas con tu chatbot Neoagent, habilitando funcionalidades avanzadas y personalizadas a través del Constructor de Flujos.

Requisito de Cuenta

Se necesita una cuenta Profesional para utilizar las AI Action. Verifica tu plan de suscripción antes de proceder.

Visión General​

Las AI Action permiten que tu chatbot:

  • Conecte APIs externas para extender sus funcionalidades
  • Procese datos complejos a través de servicios externos
  • Integre sistemas CRM y bases de datos
  • Automatice flujos de trabajo críticos para el negocio

Configuración​

1. Acceso a la Cuenta Profesional​

Inicia sesión en tu cuenta Profesional para acceder a las funcionalidades avanzadas de AI Action.

Cuenta Profesional Requerida

Las AI Action solo están disponibles para cuentas Profesionales. Verifica tu plan de suscripción antes de proceder.

2. Completa la Información de la API​

Ingresa la información necesaria para la solicitud de API:

Configuración de API

Elementos a Configurar:

  • URL de la API: Endpoint de tu API externa
  • Parámetros: Datos a enviar con la solicitud
  • Autenticación: Credenciales o token de acceso
  • Método HTTP: GET, POST, PUT, DELETE, etc.

Formato de Respuesta de la API​

Estructura de Solicitud​

La respuesta de tu API debe seguir esta estructura específica para ser procesada correctamente:

{
  "Success": true,
  "Code": 200,
  "Message": "Este es un mensaje",
  "Data": {
    // El campo 'Data' se utiliza para almacenar los datos.
  } 
}

Explicación de los Campos:

  • Success: Booleano que indica si la solicitud se ha procesado con éxito
  • Code: Código de estado HTTP de la respuesta
  • Message: Mensaje descriptivo del resultado
  • Data: Objeto que contiene los datos reales de la respuesta
Importante

La respuesta de la interfaz debe seguir estrictamente la estructura anterior para funcionar correctamente.

Verificación y Prueba​

3. Verifica la API​

Haz clic en el botón "Verify API" para probar la configuración. Si la interfaz funciona correctamente y devuelve la respuesta esperada, la validación será superada.

✅ Validación Automática: El sistema verificará automáticamente que tu API responda en el formato correcto y que todos los parámetros estén configurados correctamente.

4. Prueba de Llamada a la API GPT​

Prueba la llamada a la API GPT para verificar que funcione correctamente:

Prueba de API GPT

Prueba Completa: La prueba verificará la integración completa entre el chatbot de IA y tu API externa, asegurando que los datos se intercambien correctamente.

Casos de Uso de las AI Action​

Integración CRM​

Conecta el chatbot a tu CRM para crear, actualizar y recuperar información de clientes

API de Pago​

Integra servicios de pago para procesar transacciones directamente en el chat

Servicios Externos​

Conecta servicios de terceros como calendarios, sistemas de reservas o bases de datos

Procesamiento de Datos​

Procesa y analiza datos complejos a través de APIs de machine learning

Mejores Prácticas​

Seguridad y Autenticación​

  • ✅ Utiliza siempre HTTPS para las llamadas a la API
  • ✅ Implementa autenticación robusta (claves API, OAuth, JWT)
  • ✅ No expongas credenciales sensibles en los parámetros de la URL
  • ✅ Valida siempre los datos de entrada y salida

Rendimiento y Fiabilidad​

  • ✅ Implementa timeouts apropiados para las llamadas a la API
  • ✅ Maneja los errores y proporciona mensajes de respaldo
  • ✅ Optimiza las respuestas para reducir la latencia
  • ✅ Prueba la API bajo carga para verificar la escalabilidad

Ejemplos de Integración​

Integración CRM Básica​

{
  "Success": true,
  "Code": 200,
  "Message": "Cliente encontrado",
  "Data": {
    "customerId": "12345",
    "name": "Mario Rossi",
    "email": "mario@example.com",
    "phone": "+39123456789",
    "status": "activo"
  }
}

Respuesta del Sistema de Reservas​

{
  "Success": true,
  "Code": 200,
  "Message": "Cita reservada",
  "Data": {
    "appointmentId": "apt_789",
    "date": "2024-01-15",
    "time": "14:30",
    "duration": 60,
    "status": "confirmado"
  }
}
Éxito

Una vez configurada correctamente, tu AI Action permitirá al chatbot interactuar con APIs externas, ofreciendo una experiencia de usuario más rica e integrada con tus sistemas de negocio.