API y Webhooks

GUÍA: Webhooks, recibe los registros en tiempo real

Por: Diego Betancor, CTO · Ingeniero informático y economista de empresa|Actualizado: 2026-11-04

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

  1. Entra en Integraciones → API → Webhooks.
  2. Elige la propiedad (cada alojamiento tiene su propio destino).
  3. En el panel de webhooks, añade la URL de tu servidor y selecciona los eventos que quieres recibir.
  4. 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": true y 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 id del 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.

Automatiza tus partes de viajeros

Prueba Registro Parte Viajeros durante 7 días totalmente gratis.

Probar Gratis