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 paiement, et plus encore. Ce guide vous accompagne dans la configuration et les bonnes pratiques.

Public cible

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

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 par un 200 OK.

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. Entrez 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 le bouton Activé.
8. Cliquez sur Enregistrer.

Types d’événements

Wink prend en charge une variété de types d’événements. Les événements courants incluent :

• Réservation créée — Une nouvelle réservation a été confirmée.
• Réservation annulée — Une réservation a été annulée.
• Paiement effectué — Le paiement a été traité.
• Réservation mise à jour — Les détails d’une réservation ont changé.

Astuce

Commencez par vous abonner à tous les événements. Une fois que vous comprenez les charges utiles, vous pouvez restreindre aux seuls événements dont votre système a besoin.

Bonnes pratiques

• Utilisez HTTPS — Wink envoie les charges utiles uniquement aux 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 de webhook reçue. Cela facilite grandement le débogage des problèmes d’intégration.

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. Lorsque 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

• Webhooks — Référence complète pour la gestion des webhooks.
• Applications — Gérez vos identifiants API.
• Développeurs > APIs — Documentation complète de l’API.