En esta nueva funcionalidad, puedes definir un contexto para enviar o solicitar información disponible en sistemas externos, así como solicitar servicios de ellos utilizando llamadas de API.

Algunos ejemplos de estas acciones son consultar información de usuarios, verificar el estado de pedidos o generar documentos como facturas. Al configurar una integración, puedes personalizar cómo y cuándo el chatbot realiza estas solicitudes, además de cómo debe manejar las respuestas recibidas, mejorando la experiencia de atención al cliente.

Ejemplo de uso

Imagina que tu cliente necesita consultar si hay un pedido pendiente. Utilizando esta nueva funcionalidad, puedes configurar el chatbot para conectarse al sistema de gestión de pedidos vía API. El chatbot solicita el número de identificación del cliente, realiza la llamada para verificar los pedidos pendientes y devuelve la información de forma automática.

Tutorial de ejemplo práctico

1. Accede a la pantalla de Habilidades del chatbot.

2. Haz clic en Agregar habilidad

3. 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.

1. 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.
2. 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 e ingresa la información para configurar el encabezado de la solicitud:

• 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 e ingresa la información para configurar el cuerpo de la solicitud:

• 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   qué atributos desea utilizar para tratar la respuesta (etapa 4 a continuación). 

🔴 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   al lado de la habilidad y tendrás esta opción.