Aller au contenu
TicketingHub Help

Comment configurer des webhooks

Les webhooks envoient les événements TicketingHub sélectionnés à un autre système au moment où ils se produisent.

Avant de commencer

  • Les webhooks doivent être activés pour votre compte TicketingHub. Contactez TicketingHub si la section Webhooks n’est pas disponible.
  • Vous devez disposer d’un accès administrateur ou gestionnaire.
  • Le système destinataire doit fournir une URL HTTPS publique.

Ajouter un webhook

  1. Accédez à Paramètres → Avancé.
  2. Repérez Webhooks, puis sélectionnez Modifier.
  3. Sélectionnez Nouveau webhook.
  4. Saisissez l’URL HTTPS qui recevra les événements.
  5. Sélectionnez les types d’événements à envoyer, par exemple une réservation confirmée ou annulée.
  6. Facultatif : saisissez un secret robuste afin que le système destinataire puisse vérifier chaque requête.
  7. Créez le webhook, puis déclenchez l’un des événements sélectionnés pour le tester.

Si vous ajoutez un secret, TicketingHub signe chaque requête et envoie la signature dans l’en-tête X-TicketingHub-Signature-256. Votre développeur doit vérifier cette signature avant d’accepter les données.

Maintenir le webhook actif

Le système destinataire doit répondre rapidement avec un code d’état 2xx indiquant une réussite. TicketingHub réessaie les livraisons qui expirent ou qui renvoient une réponse indiquant un échec. Un point de terminaison qui continue à échouer est automatiquement désactivé ; corrigez le système destinataire, puis revenez à la page Webhooks et réactivez-le.

TicketingHub envoie uniquement les événements à des adresses publiques. Si l’URL pointe vers une adresse réseau privée, comme celle d’un serveur situé sur votre propre réseau, TicketingHub n’envoie pas l’événement et désactive immédiatement le webhook. La page Webhooks affiche « L’URL pointe vers une adresse réseau privée » et les administrateurs de votre compte reçoivent un e-mail. Remplacez l’URL par une adresse HTTPS publique, puis réactivez le webhook.

Choisissez uniquement les événements dont vous avez besoin et évitez d’utiliser une URL de test dans un compte actif. Pour envoyer des événements à Zapier sans créer votre propre récepteur, consultez Comment connecter TicketingHub à Zapier. Pour créer une intégration qui demande également des données à TicketingHub, consultez Comment créer et utiliser un jeton d’API.