La funcionalidad de webhooks de Ventrata permite que las aplicaciones de terceros reciban notificaciones en tiempo real cada vez que una reserva se actualiza, cancela, reprograma o modifica. Estos eventos pueden utilizarse después para activar correos electrónicos desde plataformas externas.
📗 CONSEJO
Correos electrónicos de pedidos y reservas
Para enviar correos electrónicos relacionados con reservas mediante una aplicación de terceros, usa el booking_update webhook.
Este webhook contiene un objeto diff, que resalta los cambios realizados en la reserva:
{
"diff": [
{
"op": "replace",
"was": "ON_HOLD",
"path": "/status",
"value": "CONFIRMED"
}
],
"booking":
{
..el objeto de la reserva..
}
}
Al comprobar /status en el objeto diff , se pueden activar distintos tipos de correos electrónicos.
Tipo de correo electrónico |
| Descripción |
Order Confirmation Email (Correo electrónico de confirmación de pedido) |
| cambio de estado de cualquier valor a CONFIRMED (CONFIRMADO) debe tratarse como una nueva confirmación |
Order Cancellation Email (Correo electrónico de cancelación de pedido) |
| cambio de estado de cualquier valor a CANCELLED (CANCELADO) debe tratarse como una cancelación |
Order Update Email (Correo electrónico de actualización de pedido) |
| cualquier reserva en la que |
Order Recovery Email (Correo electrónico de recuperación de pedido) |
| cambio de estado de cualquier valor a EXPIRED (EXPIRADO) debe tratarse como una reserva recién expirada;
si existen datos de contacto en la reserva, puedes contactar al cliente para recuperar el pedido |
📗 CONSEJO
También puedes crear plantillas de correo electrónico directamente en el editor integrado de Ventrata sin usar webhooks.
Transacciones y cambios de tickets
Para enviar notificaciones sobre reembolsos y cambios de entradas, utiliza el webhook order_update.
La carga útil de este webhook contiene datos transaccionales y de cambios de entradas dentro de su objeto diff:
{
"diff": [
{
"op": "remove",
"was": {
..el objeto cancelado..
},
"path": "/bookings/0"
},
{
"op": "remove",
"was": {
..objeto de vale cancelado..
},
"path": "/voucher/deliveryOptions/1"
}
]
📗 CONSEJO
Como el cuerpo de la respuesta contiene gran cantidad de información, te recomendamos configurar el webhook y ejecutar algunas transacciones de prueba en el backoffice. Según los datos de la respuesta, puedes decidir qué campos usar para activar tus flujos de mensajería.
Métodos
1. Usar la API OCTO
Ventrata utiliza el estándar de la API OCTO, que te permite configurar webhooks de forma programática.
Consulta la documentación Ventrata OCTO API para obtener detalles de implementación.
2. Usar el panel de Ventrata
Si tienes al menos una conexión configurada en el panel de Ventrata, puedes configurar un nuevo webhook usando la interfaz del panel.
Puedes configurar un webhook utilizando uno de los siguientes eventos:
Order Update (Actualización de pedido) - se activa cuando se añade una transacción a un pedido o se actualizan los datos del cliente
Booking Update (Actualización de reserva) - se activa cuando una reserva se confirma, actualiza o cancela
Availability Update (Actualización de disponibilidad) - se activa cuando cambia la disponibilidad
Product Update (Actualización de producto) - se activa cuando se modifican los detalles del producto
Obtén más información sobre la configuración de webhooks en el panel de Ventrata en este artículo.