Integración de API
En esta sección, aprenderás a crear y gestionar API para interactuar con sistemas externos, obtener datos de las bases de conocimientos e integrar estas API sin problemas en los flujos conversacionales de tu bot mediante el Advanced Builder.
❗️ Esta sección está destinada a usuarios antiguos cuyo caso de uso aún no se ha migrado al Flow Builder. Cada nuevo caso de uso debe crearse en el Flow Builder
Descripción general de las API
Operaciones: Realiza acciones como obtener información o publicar actualizaciones en sistemas externos.
Obtención de datos: Recupera datos de las bases de conocimientos de tu bot para mejorar las interacciones.
Grupos y gestión de API
Las API están organizadas en grupos, que funcionan como carpetas para facilitar la gestión. Puedes añadir, editar o eliminar fácilmente grupos y sus API asociadas.
Acciones
Dentro de una API, puedes utilizar el menú de la esquina superior derecha para duplicarla o eliminarla. La duplicación permite reutilizar la API en otra instancia del bot.
Configuración de la API
Nombre: Elige un nombre descriptivo para tu API que facilite su identificación en las conversaciones.
Acción del bot vinculada: Muestra dónde se utiliza la API dentro del bot.
Grupo de API: Asigna la API a un grupo específico.
Tipo de API: Selecciona entre API externa o base de conocimientos.
URL: Define la URL del servicio, compatible con scripts de Jinja para insertar variables.
Método HTTP: Especifica el método (GET, POST, PUT, PATCH, DELETE).
Formato de datos: Elige entre JSON o XML.
Almacenamiento en caché: Configura intervalos de almacenamiento en caché para optimizar el rendimiento.
Encabezados: Añade encabezados HTTP compatibles con el formato JSON y Jinja para contenido dinámico.
Entradas y extracciones
Entradas: Define y asigna nombres a las variables necesarias para la ejecución de la API.
Extracciones: Aísla y utiliza los datos devueltos por la API mediante JMESPath y scripts de Jinja para una manipulación precisa de los datos.
Solución de problemas comunes de las API
Lista blanca de IP: Asegúrate de que las IP del backend de ViaSay estén incluidas en la lista blanca del proveedor de la API.
Problemas con User-Agent: Modifica el encabezado User-Agent si la API de destino bloquea los agentes basados en Python.
Tiempo de respuesta: Asegúrate de que la API responda dentro de los límites de tiempo aceptables (4 segundos para conectarse y 16 segundos para completar la operación).
Tamaño de la respuesta de la API: Gestiona el tamaño de las respuestas para evitar problemas de rendimiento, aplicando un tratamiento específico según los umbrales de tamaño.