Integración de Webhooks

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

Audiencia

Esta guía está dirigida a desarrolladores que integran Wink con sistemas externos como sistemas de gestió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 reserva), 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 una variedad de tipos de eventos. Los eventos comunes incluyen:

• Reserva creada — Se ha confirmado una nueva reserva.
• Reserva cancelada — Se ha cancelado una reserva.
• Pago completado — El pago ha sido procesado.
• Reserva actualizada — Se han cambiado detalles de una reserva.

Consejo

Comienza suscribiéndote a todos los eventos. Una vez que entiendas las cargas útiles, puedes limitarte 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 elimina permanentemente. Cualquier integración que dependa de ese webhook dejará de recibir notificaciones.

Lecturas adicionales

• Webhooks — Referencia completa para la gestión de webhooks.
• Applications — Gestiona tus credenciales API.
• Developers > APIs — Documentación completa de la API.