Aller au contenu
Wink

Intégration Webhook

Les webhooks permettent à vos systèmes de recevoir des notifications en temps réel lorsque des événements se produisent sur votre compte Wink — nouvelles réservations, annulations, mises à jour de paiements, et plus encore. Ce guide vous accompagne dans la configuration et les bonnes pratiques.

Public cible

Section intitulée « Public cible »

Ce guide s’adresse aux développeurs intégrant Wink avec des systèmes externes tels que les systèmes de gestion de propriété (PMS), les gestionnaires de canaux, les CRM ou les tableaux de bord personnalisés.

Fonctionnement des webhooks

Section intitulée « Fonctionnement des webhooks »
  1. Vous enregistrez une URL de webhook sur Wink.
  2. Lorsqu’un événement survient (par exemple, une nouvelle réservation), Wink envoie un POST HTTP à votre URL.
  3. Votre serveur traite la charge utile et répond avec un 200 OK.

Configuration d’un webhook

Section intitulée « Configuration d’un webhook »
  1. Connectez-vous à votre compte (Extranet, Studio ou TripPay — tous supportent les webhooks).
  2. Allez dans Applications puis Webhooks. Voir Webhooks.
  3. Cliquez sur Créer un webhook.
  4. Saisissez un nom (par exemple, “Synchronisation Réservation PMS”).
  5. Saisissez votre URL de webhook — le point de terminaison HTTPS sur votre serveur.
  6. Sélectionnez les événements — Choisissez les événements spécifiques auxquels vous abonner, ou laissez vide pour recevoir tous les événements.
  7. Activez l’option Activé.
  8. Cliquez sur Enregistrer.

Types d’événements

Section intitulée « Types d’événements »

Wink prend en charge plus de 64 types d’événements webhook répartis dans des catégories telles que la gestion de compte, les contrats de réservation, les paiements, les mises à jour du gestionnaire de canaux, et la gestion administrative des entités. Les événements courants incluent :

CatégorieExemples
Réservationbooking.create, booking.cancelled
Contrat de réservationbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Paiementinternal.payment.succeeded, internal.payment.failed
Remboursementsbooking.contract.refund.partial, booking.contract.refund.full
Gestionnaire de canauxchannel-manager.update.rate, channel-manager.update.availability
Compteaccount.create, account.status.updated

Pour une liste complète de tous les types d’événements avec descriptions, consultez le Catalogue des événements Webhook.

Voir les 64+ types d’événements

Bonnes pratiques

Section intitulée « Bonnes pratiques »
  • Utilisez HTTPS — Wink envoie les charges utiles uniquement vers des points de terminaison HTTPS.
  • Répondez rapidement — Retournez un 200 OK dès réception de la charge utile. Effectuez tout traitement lourd de manière asynchrone.
  • Idempotence — Votre gestionnaire doit être idempotent. Wink peut réessayer la livraison s’il ne reçoit pas de réponse 200.
  • Validez la source — Vérifiez que les requêtes entrantes proviennent bien de Wink avant de les traiter.
  • Journalisation — Enregistrez chaque charge utile webhook reçue. Cela facilite grandement le débogage des problèmes d’intégration.

Mise en pause et suppression

Section intitulée « Mise en pause et suppression »

Vous pouvez désactiver un webhook sans le supprimer. Cela suspend la livraison pour que vous puissiez dépanner sans perdre votre configuration. Quand vous êtes prêt, réactivez-le.

Supprimer un webhook le retire définitivement. Toute intégration dépendant de ce webhook cessera de recevoir des notifications.

Lectures complémentaires

Section intitulée « Lectures complémentaires »