Academy – Plataforma Centribal

Plataforma Centribal

ACADEMY

Te damos la bienvenida al espacio de aprendizaje de nuestra plataforma

image_pdf

WEBHOOK DE PLATAFORMA CENTRIBAL​

image_pdf

Los webhooks son retrollamadas de HTTP de un usuario.​ Estas se registran en algunas ocasiones, como al publicar un comentario en un blog, o cuando pasamos información que el usuario nos ha dado en el bot a un servicio externo para verificar dicha información y luego ofrecer una respuesta.

Cuando esto ocurre, la web envía una solicitud HTTP a la URL configurada para el webhook (En nuestro caso un WebService).

Los usuarios pueden configurarlos para que la web se comporte de una forma u otra. Como usan HTTP, pueden integrarse en servicios web sin añadir una nueva infraestructura o desarrollar algo mas complejo.

En el ejemplo a continuación podemos ver la interacción entre Gmail, Google Sheets, Facebook y Dropbox, toda esta comunicación es posible mediante la comunicación entre aplicaciones distintas usando peticiones HTTP.

Mediante el Webhook de Plataforma Centribal, tendremos capacidad de recibir peticiones desde otras aplicaciones o servicios web externos para poder recibir información y servirla al usuario en el chat.

Estos datos en PC, son únicos de cada proyecto y para cada usuario (A) gracias a estos identificadores. Como tercer dato que ayuda a mantener segura la conexión entre PC y el servicio web tenemos, la ID de la sesión que se genera automáticamente cuando el usuario activa el chatbot.

A

Account_ID

Project_ID

Los elementos del webhook serán:

  1. URL: Es la dirección o enlace de protocolo HTTPS para dirigir la información.
  2. Method: El método de petición del webhook siempre será POST para que pueda brindar un mensaje hacia el bot.
  3. Auth: Para poder conectar el webhook a Plataforma Centribal será necesario tener una conexión segura, por lo que el método de Autenticación mediante un Bearer Token es necesario. El método no es posible cambiarlo.
  4. Token: Básicamente es la llave, clave, contraseña, password que ayudara a autenticar al servicio.
  5. Cuerpo (se define como JSON): Contiene el código necesario para que Plataforma Centribal responda la información que nos manda el servicio o aplicación externa.

Los elementos a compartir para poder hacer la conexión al webhook, son aquellos que tengan el icono de copiar en la parte derecha..

Ejemplo de caso de uso:

Mediante el chatbot, tomamos una orden de pizza para un usuario final. Una vez tengamos la orden confirmada por el usuario final, enviamos esta información al servicio web del cliente y a partir de ese momento, el servicio web del cliente, mediante el webhook, podrá enviar información al chatbot, como el recibo de compra y/o el estado de la orden (en preparación, al horno, en delivery, etc.)