¿Cómo configurar los Webhooks de TuriTop?

¿En dónde puedo encontrarlo? Compañía >>> Componentes/Integraciones. 

 Ten en cuenta: las firmas o signatures para webhooks añaden una capa adicional de seguridad. Te permite añadir cualquier llave (key) que quieras en el panel de control de TuriTop, con lo cual, cuando recibas nuestras notificaciones vía webhook, puedes revisar si contiene la misma llave añadida en tu panel de control de TuriTop. Si la llave no existe o es incorrecta, significa que no fue hecha por TuriTop.  

Lo primero que debes saber en función de usar los webhooks de TuriTop es aprender cómo añadirlos y gestionarlos. Sigue los sencillos pasos para conseguirlo:

Paso 1: ve a la pestaña compañía

Inicia sesión en tu panel de control de TuriTop >>> Compañía >>> Componentes/Integraciones >>> Webhooks:

Aquí necesitas insertar una URL válida que redirija a un endpoint válido. Nuestro sistema enviará detalles específicos a dicho endpoint. Esto dependerá de una acción, descrita en el siguiente paso .

Paso 2: selecciona una acción 

Tras haber insertado una URL válida, necesitas ahora seleccionar la acción que se llevará a cabo desde TuriTop al endpoint. De momento, tenemos disponibles tres acciones (esta lista irá creciendo en el tiempo). Haz clic en el desplegable "Acción" y te dará las siguientes opciones: 

 Ten en cuenta: si seleccionas Todas, esto enviará información sobre cualquiera de las acciones disponibles, p.e. nueva reserva, editar reserva o borrar reserva.

Como puedes ver en la imagen de arriba, tienes tres llamadas de acciones: 

• Todas: esta llamada enviará cualquiera de los datos disponibles a la URL de destino.
• Nueva reserva: esta opción enviará información concerniente a la reserva recién creada.
• Editar reserva: se refiere a los datos enviados cuando una reserva es editada. Hay dos formas en las que una reserva puede ser editada, o bien a través de una llamada de la API o bien, una llamada desde el back-office.
• Borrar reserva: cuando borras una reserva, esta acción será notificada a través de una llamada del webhook. 

Paso 3: añade el webhook a tu lista

El paso final es hacer clic en el botón "Añadir" y habrás agregado una llamada webhook satisfactoriamente. Debería verse del siguiente modo: 

Paso 4: prueba tu webhook

La próxima acción que deberías realizar es probar tu webhook recién creado. Para lograrlo, haz clic en el botón "Enviar test webhook". Te saldrá esta ventana en la parte superior: 

Inserta un ID de reserva y haz clic en aceptar. 

Seguridad

Si deseas añadir más seguridad a tus Webhooks, puedes utilizar una firma, ésta se utilizará para crear un token JWT (https://jwt.io/) que autentifica y registra la fecha exacta a la que se envió el Webhook.

Para crearla, solo tienes rellenar los 32 caracteres de la firma a la hora de configurar tu Webhook y se añadirá un nuevo campo llamado “token” a cada una de las llamadas.

 Para decodificarlo, tienes que usar la librería que proporciona el estándar JWT (https://jwt.io/#libraries-io) para verificar con tu firma que el token (y en consecuencia, el webhook) es válido y legítimamente enviado por TuriTop.

Finalmente serás redirigido a tu aplicación o comprobador de webhook. Esta información será enviada en POST y formato JSON: 

 Ten en cuenta: el parámetro "acción" es el resultado de la acción que has preseleccionado cuando añades el webhook. Sin embargo, si seleccionas "Todas", te regresará cualquiera de las acciones explicadas más arriba, p.e. nueva reserva, editar reserva o borrar reserva, con lo cual sólo verás una de ellas y no "todas" bajo el parámetro "action" en el JSON. 

 Precaución: para hacer uso de los webhooks es obligatorio el protocolo HTTPS. No intentes usar el HTTP estándar ya que no te funcionará.