Saltar al contenido principal
Iniciar sesión
English (US) Français Italiano
Menu

Usando Webhooks de Hostaway

Robert
  • Actualización

Webhooks

  • Webhook es una herramienta poderosa para que el software de Hostaway envíe datos de reservas a proveedores de software de terceros con soporte para webhook
  • Cuando configures el webhook para tu software de terceros, algunos requerirán obtener un ejemplo de los datos de la reserva para completar la configuración. Puedes crear el webhook en Hostaway y establecer la URL en este software de terceros
  • Después de esto, puedes hacer una reserva directa "falsa" en Hostaway en el menú de reservas. Esto enviará los datos aproximadamente 5-10 minutos después al tercero para que puedas completar la configuración
  • Para probar los webhooks y cómo se ven en la carga útil, puedes usar este sitio web.

 

Webhook Unificado

Antes del 1 de abril de 2022, teníamos dos webhooks: uno para reservas y otro para mensajes de huéspedes. Lanzamos una nueva versión conocida como webhook unificado que tiene las siguientes ventajas:

  1. Solo necesitas suscribirte a un webhook para recibir actualizaciones.

  2. El webhook unificado activa más eventos que el webhook de reservas anterior.

 

El webhook unificado se activará en los siguientes casos

  1. Mensaje recibido del huésped

    • Los webhooks de mensajería solo se activan para mensajes de huéspedes, no para mensajes de anfitriones

  2. Estado de la reserva cambiado (Nuevo, Modificado, Cancelado, etc.)

  3. Estado del pago cambiado. Los cargos pagados que no actualizan el estado del pago no activan el webhook. Si el cargo cambia el estado del pago (por ejemplo, de no pagado a parcialmente pagado, o de parcialmente pagado a pagado) el webhook se activa

  4. Fechas/horarios de la reserva cambiados

  5. Precio total cambiado

  6. Código de puerta cambiado

 

Si no se cumplen las siguientes condiciones, el webhook no funcionará

Hostaway verifica 4 cosas en las URLs cuando agregas/actualizas la URL de los webhooks unificados en este orden:

  1. Si la URL es válida. Las restricciones están aquí
  2. Si el host de la URL está en una red interna por razones de seguridad, para prevenir el acceso a cualquier aplicación interna
  3. Si el esquema de la URL es uno de estos esquemas soportados:
    1. HTTP
    2. HTTPS (recomendado)
  4. Si el puerto (si se proporciona) de la URL es uno de estos puertos soportados:
    80 (puerto http por defecto)
    443 (puerto https por defecto)

 

Usando el webhook unificado

  1. Inicia sesión como el propietario de la cuenta de administrador en tu Panel de Hostaway
  2. Ve a la configuración del menú > Integraciones
  3. Agrega la URL del Webhook para el webhook que debe ser dirigido.
  4. Opcionalmente selecciona listados y canales, y si es necesario protégelos con un nombre de usuario y contraseña

mceclip0.png

 

Notas importantes a considerar:

  • El webhook se activará tan pronto como los datos más relevantes estén listos, en algunos casos, puede ver que los campos complejos y los datos que llegan más tarde no se proporcionan en ese momento. Seguimos mejorando el webhook para proporcionar más datos en las cargas útiles con el tiempo.
  • Al usar webhooks universales en combinación con API pública, considere llamar a la API posteriormente para recuperar detalles actualizados no incluidos en el webhook cuando sea necesario.
  • Planeamos lanzar un endpoint de API pública para crear y actualizar la creación de webhooks para finales de 2022.

Serán obsoletos durante el año 2024:

  • En este momento, Hostaway también admite las 2 versiones anteriores de webhooks bajo los módulos de webhooks específicos de Reservas y específicos de Mensajes, así como en la documentación de la API
  • Estos sistemas de webhooks están programados para ser eliminados en 2024 cuando se pedirá a todos los clientes que migren al nuevo sistema de webhooks universales
  • Recomendamos comenzar a usar el sistema de webhooks universales en cualquier nueva aplicación construida o conectada.


Qué hacer cuando recibe una notificación sobre un fallo de webhook:

1. Vaya a "Configuración > Integraciones", baje en la página hasta la sección de webhooks y haga clic en "Registros":


2. Haga clic en el botón para exportar el CSV

3. Abra el archivo CSV en su computadora y filtre por ID de Objeto (que es el ID de la reserva) y vea lo que se indica en el campo "Cuerpo de respuesta".
Si todo va bien, dirá "200", de lo contrario, es un error proporcionado por el software de terceros con el que se está integrando a través del webhook y deberá comunicarse con el software de terceros para preguntar por qué ocurrió tal error

Artículos relacionados