Los webhooks avisan a tu sistema en el momento en que los huéspedes de una reserva completan su registro, para que puedas actualizar tu PMS, lanzar mensajes o dar acceso sin consultar nada. Para crear reservas desde tu software, consulta la guía de la API de reservas.
Avisos disponibles
Recibes avisos sobre el registro de tus reservas; por ejemplo, cuando el registro de una reserva se completa. Así es un aviso:
{
"id": "0192f3a4-…",
"type": "guest_registration.completed",
"version": 1,
"data": {
"property_id": "prop_…",
"property_name": "Casa Sol",
"booking": { "reference": "HMABC123", "check_in": "2026-11-10", "check_out": "2026-11-12" },
"guests": { "registered": 3, "expected": 4 },
"complete": true,
"completed_at": "2026-10-15T09:59:00.000Z"
}
}
El aviso no incluye documentos de identidad, fechas de nacimiento, firmas, nombres, correos ni teléfonos.
Configuración
- Entra en Integraciones → API → Webhooks.
- Elige la propiedad (cada alojamiento tiene su propio destino).
- En el panel de webhooks, añade la URL de tu servidor y selecciona los eventos que quieres recibir.
- Copia el secreto de firma para verificar los avisos en tu servidor.
Gestión desde el panel
Desde el propio panel puedes:
- Añadir, editar, pausar y eliminar direcciones de destino.
- Elegir los eventos a los que se suscribe cada una.
- Ver el historial de entregas: estado, código de respuesta, intentos y contenido de cada aviso.
- Reenviar un aviso concreto manualmente.
- Reenviar los avisos fallidos: recupera de una vez todo lo que no llegó a tu servidor durante una caída.
- Enviar eventos de prueba para comprobar tu integración (llevan
"test": truey datos ficticios). - Ver y rotar el secreto de firma. Tras rotarlo, el anterior sigue siendo válido durante 24 horas para que puedas actualizar tu servidor sin perder avisos.
Reintentos automáticos
Si tu servidor no responde con un código 2xx, el aviso se reintenta automáticamente con esperas cada vez mayores. Si una dirección falla de forma continuada durante varios días, se desactiva; puedes reactivarla desde el panel y reenviar lo pendiente.
Verificar la firma
Cada aviso incluye cabeceras con el identificador del aviso, la marca de tiempo y la firma. Verifica siempre la firma con el secreto de tu webhook y el cuerpo sin modificar. Si necesitas ayuda para implementarlo, escríbenos desde Contacto.
Rechaza los avisos con una marca de tiempo antigua para evitar reenvíos maliciosos.
Buenas prácticas
- Responde rápido con un 2xx y procesa el aviso después.
- Gestiona duplicados: la entrega puede repetirse. Usa el campo
iddel evento para ignorar los ya procesados. - No dependas del orden de llegada.
- Ignora los eventos de prueba (
"test": true) en producción. - Usa siempre HTTPS en tu dirección de destino.