Caso de uso:
Una empresa utiliza un sistema interno que registra a sus clientes mediante un campo llamado ID o identificador. Este ID es único para cada cliente y permite realizar solicitudes específicas de información. Para esto el cliente deberá loguearse con su usuario y clave que será proporcionada por correo electrónico. Contando con este ID, y a través del componente "Petición HTTP" de Atom, se conectarán ambos sistemas para solicitar los datos adicionales necesarios del cliente, como por ejemplo, cuando éste desea saber su saldo pendiente o la fecha de su próxima factura.
Cuando el cliente interactúa con un bot y solicita esta información, luego del logueo correspondiente por parte del cliente, Atom envía una consulta al sistema interno usando el componente Petición HTTP utilizando este campo ID. Estos datos son devueltos por el sistema interno a Atom y, estos campos son almacenados en el apartado de Guardar Respuesta del componente HTTP de la plataforma. De esta forma, la información solicitada queda automáticamente disponible y actualizada para que, si la conversación escala a un agente, este pueda ver los detalles completos del cliente sin necesidad de hacer una nueva solicitud.
Es importante destacar que, para que esta integración funcione correctamente, primero es necesario comprobar que la autenticación a la API del sistema interno esté configurada y funcionando adecuadamente. Para ello, se utiliza POSTMAN, donde se puede validar el acceso y probar las peticiones a la API. Una vez verificado que la autenticación es exitosa, se configura la misma autenticación en el componente "Petición HTTP" de Atom, permitiendo que el flujo de información sea continuo y sin interrupciones.
Prueba de conexión con Postman
Previamente a configurar la petición HTTP, podemos realizar una prueba para verificar si la autenticación con nuestra API es correcta.
Para esto realizaremos en Postman una prueba de Basic Authentication. Para esto necesitas contar con el nombre de usuario y contraseña de acceso de la API.
Si deseas saber más sobre distintos tipos de autenticación en POSTMAN, lee el siguiente artículo: Tipos de autorización en Postman.
Para hacer la prueba de autenticación, entonces nos dirigimos a POSTMAN
Allí en New Request, utilizaremos el Método GET, escribiremos la URL de nuestra API, y en la sección Authorization, seleccionamos en este caso Basic Auth y colocamos el acceso con usuario y contraseña correspondiente. Hacemos clic en Send para probar:
Una vez que recibas el código 200 OK (indicado en verde en la parte inferior), dirígete a la pestaña Body de la respuesta, justo en esa misma sección inferior. Allí verás los datos que nos devuelve la API; busca la línea con la clave "Authorization" y simplemente copia el token generado que aparece entre comillas (en este ejemplo, Basic YXRvbWNoYXQ6cGFzc3dvcmQxMjM=). Este dato te servirá más adelante para configurar los encabezados de nuestro componente de petición HTTP.
Configuración en Petición HTTP
Llenamos los campos correspondientes en la petición HTTP como veremos a continuación. Dentro de nuestro bot accedemos al componente Petición HTTP, haciendo doble click para acceder a los campos en la barra lateral derecha de nuestra pantalla.
Aquí realizaremos las siguientes configuraciones:
Utilizaremos el método POST y colocaremos la URL de la API a la cual nos conectaremos
En el cuerpo detallaremos los campos que enviaremos a la API:
Cómo encabezados, utilizaremos un Key y Token correspondientes, el cual se describió en el paso anterior y luego podemos probar la petición.
⚠️ Importante: Ten en cuenta que, en Postman se configura en Basic Authentication, y se especifica usuario y contraseña, pero desde el componente HTTP, en el Header, solamente es posible especificar un token. Este Token puede ser generado desde Postman o bien desde un generador de claves tal como:
A continuación, en el apartado Guardar respuesta, vincularemos la información recibida de la API con nuestros campos locales. Por ejemplo, guardaremos en el campo de información operationid el valor proveniente de la variable origin de la respuesta. De esta manera, el dato quedará almacenado automáticamente y disponible para ser utilizado en el flujo del bot o por un agente humano.
🎉 ¡Misión Cumplida!
¡Y listo! Has finalizado con éxito tus pruebas en Postman. Con estos pasos, ya tienes las bases necesarias para validar cualquier endpoint y asegurar que tus datos viajen correctamente antes de llevarlos a la plataforma.