Webhooks en tiempo real que nunca pierden un evento
Transmite cada evento de reserva y pago a tus propios sistemas: CRM, data warehouse, Slack, integraciones a medida. Firmados con HMAC, reintentos con backoff exponencial y registro completo de entregas. Pensados para equipos de ingeniería que se niegan a hacer polling de una API.
Por qué los equipos de ingeniería eligen los webhooks de Triviyo
Patrones estándar, comportamiento predecible y un registro de entregas que de verdad te ayuda a depurar.
Se disparan en menos de un segundo
Los eventos se envían en los primeros 500 ms tras la acción que los dispara: sin polling, sin demoras, sin reservas perdidas. Tus sistemas aguas abajo quedan perfectamente sincronizados con Triviyo.
Firmas HMAC en cada payload
Cada webhook se firma con HMAC-SHA256 usando el secreto de tu endpoint. Verifica la firma antes de actuar sobre el payload: el mismo patrón que Stripe, GitHub y cualquier otro webhook en el que ya confías.
Reintentos con backoff exponencial
Si tu endpoint devuelve un código distinto de 2xx, Triviyo reintenta con backoff exponencial durante hasta 72 horas. Los fallos transitorios se autocorrigen sin intervención manual, y puedes reenviar cualquier evento desde el registro de entregas.
Nombres de eventos estándar
booking.created, booking.updated, booking.cancelled, payment.succeeded: los nombres que espera cualquier ingeniero. Suscríbete exactamente a los eventos que necesita tu integración; ignora el resto.
Secretos y listas de permitidos por endpoint
Cada endpoint tiene su propio secreto de firma y, opcionalmente, una lista de IPs permitidas en el receptor. Rota secretos sin caídas y restringe los endpoints a tu infraestructura únicamente.
Registro de entregas con reenvío
Cada intento de entrega queda registrado con código de estado, cuerpo de respuesta y marca temporal, disponible en el panel y vía API. Reenvía cualquier evento manualmente cuando tu entorno de staging se haya perdido uno.
Webhooks de Triviyo vs. polling a una API REST
Cómo es la transmisión de eventos en tiempo real frente a machacar un endpoint REST.
| Qué incluye la API de webhooks | Triviyo | Without Triviyo |
|---|---|---|
| Tiempo de configuración | Menos de 15 minutos | Días montando un poller |
| Disponibilidad | Desde Professional | Solo con acceso API Enterprise |
| booking.created | ||
| booking.updated | ||
| booking.cancelled | ||
| payment.succeeded | ||
| Firmas HMAC-SHA256 | Add-on Enterprise | |
| Estrategia de reintentos | Backoff exponencial, ventana de 72 h | Un intento o ninguno |
| Registro de entregas con reenvío | ||
| Soporte | Equipo de ingeniería en Slack | Cola de tickets por email |
Patrones estándar: nada exótico, nada propietario.
Equipos de ingeniería que usan los webhooks de Triviyo en producción
“Eliminamos 400 líneas de código de polling el día en que se lanzaron los webhooks de Triviyo. booking.created aterriza en nuestro data warehouse en menos de un segundo: la atribución y los paneles de ingresos por fin son en tiempo real, no con 15 minutos de retraso.”
“El registro de entregas es el héroe silencioso. Cuando nuestra integración con Slack se rompió un festivo, reenvié 30 eventos desde el panel mientras el equipo de plataforma estaba fuera. Sin pérdida de datos, sin escalado.”
Preguntas frecuentes
¿A qué eventos puedo suscribirme?
booking.created, booking.updated, booking.cancelled y payment.succeeded en el lanzamiento. Más eventos (payment.refunded, waiver.signed, checkin.completed, gift_card.redeemed) llegarán en actualizaciones progresivas. Suscríbete por endpoint exactamente a lo que necesita tu integración.
¿Cómo verifico que el webhook viene realmente de Triviyo?
Cada payload se firma con HMAC-SHA256 usando el secreto único de tu endpoint. Verifica la cabecera X-Triviyo-Signature contra el cuerpo de la petición antes de actuar: el mismo patrón que los webhooks de Stripe y GitHub. Hay ejemplos de código en nuestra documentación.
¿Qué pasa si mi endpoint está caído?
Triviyo reintenta con backoff exponencial durante hasta 72 horas: empieza al minuto, luego 5, 25, 2 h, 6 h, 24 h. Después, el evento queda en el registro de entregas para que lo reenvíes manualmente cuando tu endpoint se recupere.
¿Puedo probar los webhooks en un entorno de staging?
Sí. Todos los planes incluyen un modo de pruebas con sus propios endpoints de webhook y eventos simulados. Dispara cualquier evento desde el panel para verificar tu integración antes de pasar a producción, y reenvíalo tantas veces como necesites.
¿Qué plan necesito para los webhooks?
Desde Professional. Los planes Starter incluyen el panel completo y los informes; los webhooks se desbloquean en Professional porque requieren una inversión sostenida en infraestructura por nuestra parte para cumplir las garantías de latencia y entrega.
¿Hay un límite de tasa?
No hay un límite estricto: entregamos sin problema cientos de eventos por minuto a tu endpoint. Si tu endpoint no puede seguir el ritmo, bajamos la velocidad y reintentamos automáticamente en lugar de descartar eventos.
Crea integraciones en tiempo real que no hacen polling
Monta tu primer endpoint de webhook en 15 minutos. Firmado, reintentado, registrado: exactamente como esperan los equipos de ingeniería que funcionen los webhooks.
14 días de prueba gratis. Sin tarjeta de crédito. Cancela cuando quieras.