¿Cómo usar el nuevo nodo de integración con API de la plataforma de chatbots de Hibot?

Aprende cómo hacer tus integraciones de forma más fácil y rápida con los chatbots de Hibot. Te enseñamos cómo usar el nuevo nodo de integración con API de la plataforma de chatbots de Hibot.

Durante la creación de tu chatbot, puedes necesitar que tu bot se conecte con un servicio de terceros o con diferentes softwares. Lo anterior lo puedes lograr a través de un API que te permite intercambiar información, por ejemplo para extraer datos o almacenarlos en alguna base de datos. Para ello, puedes contar con el nodo de integración con API, que te permite realizar integraciones a través del uso de los siguientes métodos HTTP:

• GET
• POST
• PUT
• PATCH
• DELETE

Paso a paso sobre cómo usar el nuevo nodo de integración con API de la plataforma de chatbots de Hibot

1. Ingresa a Hibot con usuario y contraseña
2. Dirigete al menú lateral izquierdo de la pantalla y haz clic en "Chatbots"
3. Luego haz clic en "Crear". Se abrirá una ventana emergente. Llena los campos como si estuvieras creando un chatbot.
4. Verás que se abrirá el panel de creación de bots. 
5. Crea un primer mensaje con un mensaje genérico de saludo y luego agrega el nodo y escoge la opcón "Integración con API". 
6. Aparecerá una ventana emergente. Llena los campos que te aparecen: 
   
   1. Ingresa el nombre del nodo: Diligencia el nombre que deseas asignar al nodo y el cual será visible en la mesa de diseño del bot.

   Este nombre es opcional.

   

   b. Selecciona el método e ingresa la URL:
   Ten en cuenta que la URL que ingreses debe ser HTTP:// o HTTPS:// de lo contrario no se le permitirá guardar los cambios.
   
   c. Estos valores pueden ser elegidos en la opción de “agregar variables” según las variables guardadas o campos dinámicos disponibles o simplemente se puede diligenciar el valor que se desee otorgar a la llave.
   
   

   

   Personaliza valores en los parámetros, encabezado y cuerpo de la URL.
   Por defecto esta personalización está desactivada, en el caso de que se desee personalizar alguna de estas opciones dentro de la URL, se debe activar el suiche y configurar la llave y el valor que va a tener el parámetro, encabezado o cuerpo.
   
   d. Prueba la comunicación de tu Api:
   Con la información anterior diligenciada y usando el botón verde, puedes probar si una solicitud puede funcionar correctamente.
   
   • Hacer clic en “Prueba de comunicación”
   • Establecer manualmente los valores de las variables de prueba

   En caso de tener personalizaciones en parámetros, encabezado y cuerpo con variables, será necesario diligenciar un valor para poder efectuar la prueba.
   

   • Se realiza la prueba del Api deseada
   • Visualizar el cuerpo de la respuesta, debajo del botón de prueba.

   
   En caso de que la prueba sea exitosa se observa así:

   

   
   En caso de que la prueba falle, se presenta el siguiente error:

   

   e.  Gruardar respuestas: En esta sección podemos almacenar algunos de los campos que nos da la respuesta del api para el bot

   Para ello:

   • Activar el suiche de “Guardar respuesta”
   • Seleccionar el campo a almacenar: En esta opción solo se presentarán los campos primarios disponibles.
   • Definir si se quiere almacenar como campo dinámico o como variable de conversación.y seleccionar según los disponibles.
     
   f.  Enrutar el flujo del chatbot: Según el código de respuesta del Api, si es 200 o 400, se debe seleccionar la acción que se desea que siga el bot.

   

   Una vez que haya especificado todas las acciones a seguir, puede regresar a la mesa de diseño para continuar configurando el bot.