Integración de Webhooks

Los webhooks permiten que tus sistemas reciban notificaciones en tiempo real cuando ocurren eventos en tu cuenta Wink — nuevas reservaciones, cancelaciones, actualizaciones de pagos y más. Esta guía te lleva paso a paso por la configuración y las mejores prácticas.

Audiencia

Esta guía es para desarrolladores que integran Wink con sistemas externos como sistemas de administración de propiedades (PMS), gestores de canales, CRM o paneles personalizados.

Cómo funcionan los webhooks

1. Registras una URL de webhook en Wink.
2. Cuando ocurre un evento (por ejemplo, una nueva reservación), Wink envía un HTTP POST a tu URL.
3. Tu servidor procesa la carga útil y responde con un 200 OK.

Configuración de un webhook

1. Inicia sesión en tu cuenta (Extranet, Studio o TripPay — todos soportan webhooks).
2. Navega a Applications y luego a Webhooks. Consulta Webhooks.
3. Haz clic en Create webhook.
4. Ingresa un nombre (por ejemplo, “Sincronización de Reservas PMS”).
5. Ingresa tu URL de webhook — el endpoint HTTPS en tu servidor.
6. Selecciona eventos — Elige eventos específicos para suscribirte, o déjalo vacío para recibir todos los eventos.
7. Activa el interruptor Enabled.
8. Haz clic en Save.

Tipos de eventos

Wink soporta más de 64 tipos de eventos de webhook en categorías que incluyen administración de cuentas, contratos de reservación, pagos, actualizaciones de gestores de canales y administración de entidades. Los eventos comunes incluyen:

Categoría	Ejemplos
Reservación	booking.create, booking.cancelled
Contrato de reservación	booking.contract.created, booking.contract.processing, booking.contract.cancelled
Pago	internal.payment.succeeded, internal.payment.failed
Reembolsos	booking.contract.refund.partial, booking.contract.refund.full
Gestor de canales	channel-manager.update.rate, channel-manager.update.availability
Cuenta	account.create, account.status.updated

Para una lista completa de todos los tipos de eventos con descripciones, consulta el Catálogo de Eventos de Webhook.

Ver todos los más de 64 tipos de eventos

Consejo

Comienza suscribiéndote a todos los eventos durante el desarrollo. Una vez que entiendas las cargas útiles, limita la suscripción solo a los eventos que tu sistema necesita.

Mejores prácticas

• Usa HTTPS — Wink envía cargas útiles solo a endpoints HTTPS.
• Responde rápido — Devuelve un 200 OK tan pronto recibas la carga útil. Realiza cualquier procesamiento pesado de forma asíncrona.
• Idempotencia — Tu manejador debe ser idempotente. Wink puede reintentar la entrega si no recibe una respuesta 200.
• Valida la fuente — Verifica que las solicitudes entrantes provengan de Wink antes de procesarlas.
• Registro — Registra cada carga útil de webhook que recibas. Esto facilita mucho la depuración de problemas de integración.

Pausar y eliminar

Puedes desactivar un webhook sin eliminarlo. Esto pausa la entrega para que puedas solucionar problemas sin perder tu configuración. Cuando estés listo, vuelve a activarlo.

Eliminar un webhook lo remueve permanentemente. Cualquier integración que dependa de ese webhook dejará de recibir notificaciones.

Lectura adicional

• Catálogo de Eventos de Webhook — Lista completa de todos los más de 64 tipos de eventos.
• Webhooks — Referencia completa para la gestión de webhooks.
• Applications — Administra tus credenciales API.
• Developers > APIs — Documentación completa de la API.