Aller au contenu

Développeurs et API

Recevez un webhook à chaque commande de billet

Un webhook envoie chaque commande à une adresse qui vous appartient, quelques secondes après le paiement de l’acheteur. Les agences et les promoteurs qui utilisent leur propre CRM, système d’entreposage ou de traitement des commandes reçoivent chaque vente au moment où elle a lieu, au lieu d’attendre un export nocturne.

Faites envoyer chaque nouvelle commande à une adresse qui vous appartient, quelques secondes après le paiement, pour que vos systèmes reçoivent la vente sans interrogation programmée.

Pour
Envoyer chaque vente de billet à vos propres systèmes au moment où elle a lieu
Durée
8 minutes

Avant de commencer

  • Disposez d’une adresse qui accepte les requêtes POST et répond rapidement. Utilisez HTTPS pour un véritable endpoint, car chaque requête contient les informations de la commande et de l’acheteur.
  • Disposez d’un jeton d’accès personnel pour la ligne de commande. La création de ce jeton fait l’objet d’un guide distinct.
  • Sachez quels événements doivent l’alimenter : un événement, tous les événements d’une marque ou tous ceux d’une tournée.

  1. Générez la clé du webhook

    Ouvrez les paramètres de votre compte et sélectionnez Générer une clé API de webhook sous Clé API de webhook.

    Remarque: Des plateformes comme Zapier vous demandent cette clé lorsque vous les connectez. Un webhook que vous créez vous-même appelle directement votre adresse et n’a pas besoin de celle affichée sur cette carte.

    Carte Clé API de webhook de Ticket Fairy affichant la clé, avec un contrôle pour la copier et un autre pour la régénérer
    La clé du webhook après sa génération.

  2. Pointez un webhook vers votre propre adresse

    Exécutez ticketfairy webhook create --url https://example.com/hooks/tickets --on order pour la marque sur laquelle vous travaillez.

    Remarque: Chaque commande est envoyée à cette adresse au format JSON. Répondez rapidement avec un code de réussite, puis effectuez les opérations lentes afin qu’une mise en vente très fréquentée n’attende pas votre traitement.

  3. Choisissez ce qui le déclenche

    Indiquez dans --on l’unique élément dont vous voulez être informé : order pour les commandes, ou new_event, update_event, publish_event et find_event pour l’événement lui-même.

    Remarque: Un webhook transmet une notification. Un système qui veut recevoir les commandes et les publications en a donc besoin de deux.

Quand placer un webhook sur la marque plutôt que sur l’événement

Associez un webhook à un événement lorsque seul cet événement doit alimenter votre système, et à la marque lorsque tous les événements doivent le faire. Une tournée possède sa propre association. Les quatre notifications d’événement font exception et déterminent le choix pour vous : new_event, update_event, publish_event et find_event atteignent uniquement les webhooks de marque et de tournée, jamais celui associé à un seul événement. Pour recevoir les publications, votre système doit donc avoir son webhook sur la marque.

  1. Associez-le à l’élément qui doit l’écouter

    Ajoutez --event, --brand ou --tour à la commande qui le crée.

    Remarque: Si aucun des trois paramètres n’est indiqué, la commande utilise la marque sur laquelle vous travaillez.

  2. Vendez un billet et vérifiez sa réception

    Achetez vous-même un billet et vérifiez que la requête atteint votre adresse.

    Remarque: L’envoi se fait en arrière-plan, et non pendant le paiement. Attendez donc quelques secondes. Remboursez ensuite votre propre commande.

Ou faites-le faire pour vous

Fai peut ouvrir la page qui contient la clé du webhook. Les webhooks eux-mêmes se créent depuis la ligne de commande ; les étapes ci-dessous présentent les commandes.

Dans votre tableau de bord, avec Fai

Ouvre les paramètres de mon compte pour que je puisse obtenir ma clé de webhook

Depuis votre propre assistant, via MCP

Connectez votre assistant à notre serveur MCP et demandez-lui :

Conservez --read-only dans votre configuration MCP. Cette tâche ne fait que lire des données, votre assistant n’a donc pas besoin d’outils qui effectuent des changements.

Sélectionne la marque <BRAND NAME> et affiche ses événements

Depuis votre terminal

Installez la CLI depuis notre page CLI, connectez-vous avec ticketfairy auth login, puis choisissez la marque sur laquelle vous travaillez avec ticketfairy brand use <BRAND_ID>. ticketfairy brand list et ticketfairy event list affichent les identifiants utilisés par les autres commandes.

Créez le webhook, puis vérifiez ce qui écoute.

Appeler votre adresse à chaque commande passée

ticketfairy webhook create --url https://example.com/hooks/tickets --on order

Afficher les webhooks de la marque active

ticketfairy webhook list

Laissez Fai le faire pour vous

Fai travaille dans votre tableau de bord Ticket Fairy. Créez votre compte, ouvrez Fai et collez la consigne ci-dessus.

Créer un compte gratuit Réserver une démo

Pas de frais d'installation. Pas d'abonnement mensuel obligatoire. Pas de carte bancaire requise.

Désactivez-en un

  1. Désactivez-le pendant votre intervention

    Exécutez ticketfairy webhook update <ID> --disable, en récupérant l’identifiant avec ticketfairy webhook list.

    Remarque: Un webhook désactivé conserve ses paramètres et ne reçoit plus rien. Réactivez-le avec la même commande et --enable.

  2. Supprimez celui dont vous n’avez plus besoin

    Exécutez ticketfairy webhook delete <ID> lorsqu’il n’est plus nécessaire.

    Remarque: La suppression est définitive. Désactivez d’abord le webhook si vous voulez seulement le mettre en pause.

Fai peut ouvrir le tableau de bord pour vous. Aujourd’hui, les webhooks se consultent et se modifient depuis la ligne de commande.

Dans votre tableau de bord, avec Fai

Ouvre les paramètres de mon compte

Depuis votre propre assistant, via MCP

Conservez --read-only dans votre configuration MCP. Cette tâche ne fait que lire des données, votre assistant n’a donc pas besoin d’outils qui effectuent des changements.

Sélectionne la marque <BRAND NAME> et affiche ses événements

Depuis votre terminal

Consultez les webhooks, puis désactivez-en un ou supprimez-le.

Afficher les webhooks de la marque active

ticketfairy webhook list

Empêcher un webhook de recevoir des données sans le supprimer

ticketfairy webhook update <WEBHOOK_ID> --disable

Supprimer définitivement un webhook

ticketfairy webhook delete <WEBHOOK_ID>

Questions que vous pourriez avoir

Pourquoi rien n’est-il arrivé lorsque mon événement a été mis en ligne ?
Vérifiez à quoi le webhook est associé. Les notifications d’événement atteignent uniquement les webhooks de marque et de tournée. Un webhook associé à un seul événement ne reçoit donc que les commandes.
Que se passe-t-il lorsque mon adresse est indisponible ?
That delivery fails and the next one is tried as normal. Answer 410 Gone and we take the webhook off the list, which is the clean way to unsubscribe from your end.
Puis-je vérifier qu’une requête vient bien de Ticket Fairy ?
Oui. Demandez au support de Ticket Fairy d’ajouter un secret de signature à votre événement. Chaque requête contiendra alors un en-tête X-Signature que votre endpoint recalculera avec le même secret.
La même commande peut-elle m’être envoyée plusieurs fois ?
Oui. La commande complète est envoyée à nouveau chaque fois qu’elle change. Un remboursement, une annulation, une revente ou un transfert déclenche donc chacun un nouvel envoi. Faites la correspondance avec le numéro de commande et appliquez ce que vous recevez, au lieu de compter chaque envoi comme une nouvelle vente.
Puis-je tester avec une adresse locale ?
Une adresse http simple sur votre propre machine est acceptée. Un tunnel est donc pratique, mais pas obligatoire. Chaque requête contient les informations de la commande et de l’acheteur. Utilisez http pour les tests et fournissez une adresse HTTPS au système en production.

Vous avez encore une question ?

Réservez une démo et nous y répondrons lors d'un appel, pour votre type d'événement. Ou créez votre compte et voyez par vous-même.

Réserver une démo Créer un compte gratuit

Pas de frais d'installation. Pas d'abonnement mensuel obligatoire. Pas de carte bancaire requise.

Guides associés

Faites-le sur votre propre événement

Créez votre compte, montez votre événement et suivez les étapes dans votre propre tableau de bord. Vous n’avez pas besoin de réserver un appel commercial.

Créer un compte gratuit Réserver une démo

Réserver une démo

Découvrez comment Ticket Fairy gère vos billets, votre mise en vente et l’entrée à l’événement. Choisissez un horaire qui vous convient.

Appel vidéo de 45 minutes
Choisissez un créneau qui vous convient