● En vivo
ENTREGA 01 · COMPLETADA
PUBLICAR
your-endpoint.com/hooks/abc123
X-SmoothStay-Event
reservación.creada
X-SmoothStay-Delivery
d_7CUHUG91
X-SmoothStay-Secret
••••••••••••
{
“uuid”: “1784403540405x749914698”,
“guest_name”: “Lucía Herrera”,
“check_in”: “2026-09-14T15:00:00.000Z”,
“check_out”: “2026-09-18T11:00:00.000Z”,
“unit”: { “name”: “Casa Foggy Bottom”, … },
“contact”: { “email”: “lucia@example.com”, … },
“access”: { “token”: “7CUHUG”, “link”: “…” }
}
Carga de datos ilustrativa. Los registros relacionados llegan anidados como objetos completos.
Eventos en tiempo real
Seis eventos cubren tus contactos y reservaciones. Cada uno envía un solo POST en el momento en que cambia el registro. Sin consultas continuas ni exportaciones.
Cualquier herramienta que ya uses
Pega una URL de webhook de Zapier, Make o Activepieces y crea el resto del flujo de trabajo donde ya tienes tus otras herramientas.
Verificado y registrado
Cada solicitud incluye un secreto compartido a través de HTTPS. Los envíos fallidos se reintentan, y la pestaña de Logs muestra la carga exacta que enviamos.
Seis eventos, contactos y reservaciones
Elige solo los eventos que activan tu flujo de trabajo, así tu endpoint nunca recibirá tráfico que vaya a ignorar. Puedes cambiar la selección en cualquier momento.
✓
Cada evento envía un POST con el registro completo
✓
Se activan el registro de huéspedes, el ingreso manual y la sincronización con el PMS
✓
Desmarca todos los eventos para pausar el envío sin desconectarte
contacto.creado
reservación creada
contacto.actualizado
reservación.actualizada
contacto.eliminado
reservacion.eliminada
Conéctate en minutos
Configuración → Integraciones → Configurar webhooks. Cuatro pasos, y el primer evento en vivo llega el mismo día.
Sabrás si una entrega falla, y por lo general no pasará
El riesgo con cualquier automatización es que deje de funcionar silenciosamente y te enteres semanas después. Tres cosas aseguran que eso no pase aquí.
Un pequeño fallo no hace que pierdas el evento
Si tu herramienta de recepción se cae o está ocupada por un momento, lo reintentamos. Hacemos hasta tres intentos en caso de tiempos de espera agotados, límites de tarifa y errores de servidor.
Un descanso de verdad te consigue un email
Si tu endpoint sigue fallando, desactivaremos el webhook y le enviaremos un correo a tu administrador para que un flujo de trabajo detenido no pase desapercibido.
Puedes ver exactamente qué enviamos
La pestaña Logs registra cada envío con el estado que devolvió tu endpoint, su respuesta sin procesar y el payload mismo. Sin adivinanzas.
¿Vas a construir directamente con los datos en lugar de usar una herramienta de automatización? La referencia completa cubre eventos, forma del payload, headers, reintentos y garantías de entrega.
Preguntas sobre webhooks
¿Necesito saber programar para usar webhooks?
No. La mayoría de los anfitriones conectan una herramienta de automatización como Zapier, Make o Activepieces: pega la URL de su webhook (catch hook) en SmoothStay y arma el resto con los pasos de esa herramienta. Cualquier endpoint que acepte solicitudes POST mediante HTTPS funciona. Solo necesitas la referencia técnica si vas a programar directamente con los datos.
¿Los webhooks reemplazan la integración con Hospitable?
No, cumplen funciones distintas. Hospitable importa tus reservaciones a SmoothStay; los webhooks envían los registros de SmoothStay a tus otras herramientas. Muchos anfitriones usan ambos.
¿Qué pasa si falla la entrega de un webhook?
Intentamos cada entrega hasta tres veces. Si tu endpoint sigue fallando, desactivamos el webhook y le enviamos un correo al admin de tu organización. Corrígelo, envía un evento de prueba exitoso y la entrega se reactivará; los eventos generados durante la interrupción no se reenvían. Para ver qué ocurrió, ve a la pestaña Registros y haz clic en Depurar en una entrega: verás el estado que devolvió tu endpoint, su respuesta y el payload exacto que enviamos.
¿Cómo verifico y elimino eventos duplicados de webhooks?
Compara el encabezado X-SmoothStay-Secret con tu clave secreta guardada usando una coincidencia de texto simple, y rechaza lo que no coincida. Las entregas se hacen al menos una vez y sin un orden fijo, así que elimina duplicados con el encabezado X-SmoothStay-Delivery y usa X-SmoothStay-Timestamp para saber qué actualización es más reciente.
¿Puedo pausar los eventos de webhook sin perder mi configuración?
Sí: deselecciona todos los eventos. La desconexión es permanente y elimina la configuración de tu endpoint, el secret y los registros de entrega.
Pon los datos de tus reservaciones donde los necesites
Pruébalo gratis por 14 días. No necesitas tarjeta de crédito.