Webhooks de TuriTop

Webhook

Un webhook es un elemento del desarrollo web que te permite hacer que una aplicación o página web determinadas cambien su comportamiento a través de callbacks personalizados. Esto significa que puedes obtener información sobre los cambios de varios parámetros en tiempo real con esta herramienta. 

Ten en cuenta: los webhooks son herramientas avanzadas, úsalas con precaución.  

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:

Components/Integrations

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: 

Action

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: 

Webhook

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. 

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

WebHook TesTer

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

Ahora sabes cómo añadir y configurar un Webhook desde el panel de control de tu Sistema de Reservas TuriTop.