Esta habilidad permite que el chatbot realice integraciones con un sistema externo para ejecutar una acción específica.
Algunos ejemplos de estas acciones son consultar información de usuarios, verificar el estado de pedidos o generar documentos como facturas.
Ejemplo de uso
Imagina que tu cliente necesita consultar si hay un pedido pendiente. Puedes configurar el chatbot para conectarse al sistema de gestión de pedidos a través de una API.
El chatbot solicita el número de identificación (CPF) del cliente, realiza la consulta para verificar los pedidos pendientes y devuelve la información automáticamente.
En este artículo:
- Agregar la habilidad de integración manualmente
- Agregar la habilidad de integración utilizando un proveedor externo
Tutorial de ejemplo práctico
En esta habilidad, encontrarás dos maneras de realizar la nueva integración: manualmente o utilizando un proveedor.
A continuación, consulta cómo realizar las configuraciones en ambos casos.
Nueva integración con configuración manual
Accede a la pantalla de Habilidades del chatbot.
Haz clic en Agregar habilidad
Selecciona la opción Integración y haz clic en Siguiente.
Paso 2: Parametrizando la llamada a la API
Ahora, vas a configurar la llamada a la API que realizará el chatbot.
- Método: Elige el método apropiado (GET, POST, PUT o DELETE), dependiendo de la solicitud que se va a realizar. Por ejemplo, para buscar información, generalmente se usa el método GET.
- URL: Ingresa la URL del endpoint del sistema externo que será llamado. Ejemplo: https://api.sistemaejemplo.com/pedidos.
También puedes incluir parámetros dentro de la URL. Para ello, utiliza el formato {{nombreDelParametro}}. Esto significa que puedes definir valores específicos para esos parámetros justo debajo, en la sección Parámetros de la URL.
Esta funcionalidad es útil cuando necesitas personalizar la URL para hacerla más detallada. Por ejemplo, si necesitas pasar información específica, como un ID de pedido, puedes configurarlo y luego insertar esos valores en la URL exactamente donde sea necesario. Tu URL se vería algo así como https://api.sistemaejemplo.com/pedidos/{{idPedido}}.
3. Encabezado: Haz clic en Agregar campo 
- Campo : Añade los campos necesarios en el encabezado de la solicitud, como el CPF o el Token de autenticación.
- Valor : Define si el valor será fijo o variable . Si es variable, crea una instrucción para el chatbot. Ejemplo: Si el campo es CPF, la instrucción sería algo como "Pregúntale al usuario su CPF".
4. Cuerpo : Haz clic en Agregar campo 
- Campo: Añade los campos necesarios en el cuerpo de la solicitud, como el Número de Pedido.
- Valor: Defina nuevamente si el valor será fijo o variable, según la lógica utilizada en el encabezado.
5. Haga clic en Siguiente para ir a la siguiente etapa.
Etapa 3: Probar la llamada de API
En esta etapa, podrá probar si la integración está funcionando correctamente.
Haga clic en Realizar prueba para que el sistema haga la llamada de API y muestre la respuesta, que puede ser:
🟢 200 OK : Significa que la prueba fue exitosa y el sistema mostrará los atributos devueltos, como Nombre, CPF, Dirección. Habilite o deshabilite 
🔴 403 – Error de autenticación ": Significa que la prueba no fue exitosa. El sistema mostrará el error si existe para su corrección.
Paso 4: Manejar respuesta
Finalmente, defines qué se hará con los datos en el recorrido del chatbot de IA, eligiendo cómo debe manejar los atributos seleccionados en la etapa anterior.
Tienes tres opciones:
Confirmar el resultado de la llamada: El chatbot puede simplemente confirmar la respuesta. Ejemplo: Si el cliente tiene un pedido pendiente, el chatbot puede responder con un mensaje confirmando que hay un pedido pendiente.
Enviar como archivo: Si la respuesta contiene un enlace a un archivo (como una factura), el chatbot puede proporcionar ese archivo al usuario.
Enviar como mensaje de texto: El chatbot puede generar un mensaje con los atributos devueltos. Ejemplo: El chatbot puede proporcionar el número y el estado del pedido, como "Tu pedido #12345 está en proceso".
Finalmente, concluye en Crear habilidad .
¡Listo! Tu habilidad ya está añadida al chatbot.
Si desea editarla, haga clic en el ícono 
Nueva integración utilizando un proveedor
En esta opción, configuras el chatbot para realizar acciones a través de la integración con aplicaciones externas que ya están configuradas en sus propios sistemas.
Actualmente, es posible integrarse con el ERP Omie. Entonces, si lo utilizas, puedes conectar un chatbot de IA Generativa a la información disponible en Omie para resolver posibles problemas de los clientes.
Sigue las instrucciones:
- Accede a la pantalla de Habilidades del chatbot.
- Haz clic en Agregar habilidad.
- Selecciona la opción Integración y haz clic en Siguiente.
- Elige la opción Usando un proveedor y sigue los pasos siguientes para crear la nueva integración.
Etapa 1: Datos básicos
Rellena los campos solicitados:
- Nombre: Asigna un nombre a esta integración, como "Verificar pedido".
- Comando: Define el comando que se ejecutará, como "Verificar estado del pedido".
Haz clic en Siguiente para avanzar a la siguiente etapa.
Etapa 2: Selecciona el proveedor
Elige el sistema donde se creó la aplicación para realizar la acción. Con la integración, el chatbot podrá ejecutar la acción según se configuró en el proveedor.
Por ahora, solo está disponible Omie, pero próximamente estarán disponibles otros proveedores, como Sensedia.
Haz clic en Siguiente para continuar a la siguiente etapa.
Etapa 3: Selecciona la acción que debe ejecutarse
Selecciona una de las opciones disponibles para definir la acción que realizará el chatbot cada vez que se active esta habilidad. Es posible:
- Consultar el estado de un pedido
- Consultar el inventario
- Enviar una factura
- Listar facturas recientes
- Verificar el registro
Finalmente, haz clic en Crear habilidad para completar.
¡Listo! Tu habilidad ya está agregada al chatbot.
Si deseas editarla, haz clic en el ícono junto a la habilidad y tendrás esta opción.
Información útil sobre la integración con proveedores externos:
- Para que el chatbot acceda a la información del ERP, es necesario que tu cuenta de Customer Cloud esté previamente integrada con el proveedor. Para más información, consulta Integrar Omie con Zenvia Customer Cloud.
- El chatbot podrá acceder a información como inventario, precios y estado de los pedidos de compra/venta.
- Cada habilidad debe contener solo una acción de la integración con Omie.