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. Registrás 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. Iniciá sesión en tu cuenta (Extranet, Studio o TripPay — todos soportan webhooks).
2. Navegá a Applications y luego a Webhooks. Consultá Webhooks.
3. Hacé clic en Create webhook.
4. Ingresá un nombre (por ejemplo, “Sincronización de reservas PMS”).
5. Ingresá tu URL de webhook — el endpoint HTTPS en tu servidor.
6. Seleccioná eventos — Elegí eventos específicos para suscribirte, o dejá vacío para recibir todos los eventos.
7. Activá Enabled.
8. Hacé clic en Save.

Tipos de eventos

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

Categoría	Ejemplos
Reserva	booking.create, booking.cancelled
Contrato de reserva	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, consultá el Catálogo de Eventos de Webhook.

Ver todos los más de 64 tipos de eventos

Consejo

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

Mejores prácticas

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

Pausar y eliminar

Podés desactivar un webhook sin eliminarlo. Esto pausa la entrega para que puedas solucionar problemas sin perder tu configuración. Cuando estés listo, activalo nuevamente.

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 — Gestioná tus credenciales API.
• Developers > APIs — Documentación completa de la API.