Integración con OpenAPI en SmartFlow
Introducción
SmartFlow permite la integración de APIs externas a través del estándar OpenAPI. Esta característica te ofrece una inmensa flexibilidad para conectar tus flujos de trabajo a servicios de terceros, automatizar tareas complejas y enriquecer tus procesos de negocio.
¿Por qué usar OpenAPI en SmartFlow?
- Interoperabilidad: Conecta SmartFlow a cualquier sistema compatible con OpenAPI.
- Automatización avanzada: Realiza llamadas a la API para enviar o recuperar datos en tiempo real.
- Ahorro de tiempo: Importa colecciones de OpenAPI para usar puntos finales predefinidos sin configuración compleja.
Captura de pantalla: [Incluye una captura de pantalla que muestre la interfaz para importar una colección de OpenAPI desde la página de Configuración del chatbot.]
Agregar una Integración de OpenAPI
1. Importar una Colección de OpenAPI
- Accede a la página de Configuración del Chatbot: Navega a la pestaña "Configuración" del chatbot relevante.
- Importar un archivo o configurar desde la interfaz: Haz clic en "Agregar una colección de OpenAPI" y selecciona un archivo JSON o YAML, o configura los puntos finales directamente desde la interfaz.
- Validación: Los puntos finales se ordenan automáticamente por colección y se validan.
- Guardar: Una vez validados, los puntos finales se vuelven disponibles como acciones de tipo "API" en SmartFlow.
Captura de pantalla: [Muestra la interfaz de configuración en la página de Configuración del Chatbot.]
2. Usar Acciones de API en SmartFlow
- Agregar una acción: En tu flujo de trabajo de SmartFlow, ve a la pestaña de Acciones y selecciona "API".
- Elegir un punto final: Los puntos finales se ordenan por colección y están disponibles para todos los tipos de SmartFlows.
- Definir parámetros: Configura los campos requeridos para la llamada (encabezados, cuerpo, etc.).
- Observación por defecto: Por defecto, cada acción de API devuelve el resultado de la llamada como una observación en modo "Herramienta de Conversación", permitiendo que la IA tome automáticamente la siguiente decisión.
Captura de pantalla: [Inserta una captura de pantalla que muestre un punto final utilizado como una acción de API en SmartFlow.]
Ejemplo de Uso
Escenario: Sincronización con un CRM externo
- Objetivo: Actualizar la información del cliente en tu CRM cuando se envía un formulario.
- Flujo de trabajo:
- Disparador: Un usuario completa un formulario a través de SmartForm.
- Acción de API: Envía los datos del formulario a la API de tu CRM.
- Observación: El resultado de la llamada se devuelve automáticamente como una observación en modo "Herramienta de Conversación".
- Beneficios: Ahorro de tiempo y reducción de errores manuales.
Captura de pantalla: [Muestra un flujo de trabajo completo con una llamada a la API vinculada a un CRM.]
Escenario: Recuperación de datos de usuario
- Objetivo: Personalizar la respuesta del chatbot en función de los datos del usuario.
- Flujo de trabajo:
- Disparador: Una solicitud de usuario en el chatbot.
- Acción de API: Consultar una API externa para obtener información del usuario.
- Observación: Utiliza los datos devueltos como una observación para decidir la próxima respuesta del chatbot.
Captura de pantalla: [Ilustra una interacción entre un chatbot y una API externa.]
Mejores Prácticas
- Importar colecciones verificadas: Asegúrate de que tus archivos de OpenAPI cumplan con los estándares para evitar errores de importación.
- Probar regularmente: Valida tus llamadas a la API para asegurarte de que funcionen como se espera.
- Documentar tus integraciones: Agrega descripciones claras para cada punto final para facilitar su gestión.
Con esta integración, SmartFlow se convierte en una plataforma aún más poderosa para conectar tus herramientas y automatizar tus procesos. ¡Pasa a la siguiente sección para descubrir la Tienda de Plantillas y compartir tus flujos de trabajo!