Comment configurer un webhook ?

Dans cet article, vous allez apprendre ce que sont les webhooks et comment les configurer pour recevoir des informations en temps réel depuis Eventtia.

Qu’est-ce qu’un Webhook ?

Un webhook est un mécanisme qui permet à une application de transmettre des mises à jour en temps réel à un autre système dès qu’un événement spécifique se produit. Contrairement aux API traditionnelles, qui nécessitent qu’une application vérifie régulièrement s’il y a du nouveau (ce qu’on appelle le polling), un webhook envoie immédiatement les données vers une URL pré-configurée dès que l’événement a lieu.

Par exemple, si vous configurez un webhook pour être averti de la création d’un nouveau participant, le logiciel d’Eventtia enverra immédiatement une requête HTTP POST contenant les informations du nouveau participant à l’URL que vous avez définie.

Comment configurer un webhook ?

Pour recevoir les notifications via webhook, vous devez fournir une URL de destination à laquelle votre système pourra écouter et traiter les données entrantes.

Voici comment procéder :

1. Accédez aux paramètres de votre événement et cliquez sur l’onglet « Webhook ».

2. Cochez ensuite « Activer le webhook » puis cliquez sur « Créer ».

Ensuite, suivez les étapes suivantes :

1. Créer une URL d'écoute (Listener URL)

• Vous devez créer un point de terminaison (endpoint) sur votre serveur ou votre application capable de recevoir des requêtes HTTP POST. Cet endpoint doit :

  • Être publiquement accessible (ex. : https://votreserveur.com/webhooks/mon-evenement) 

  • Accepter les requêtes POST

  • Analyser le contenu de la requête (généralement au format JSON)

  • (Optionnel) Valider un code ou une signature pour renforcer la sécurité

2. Tester votre URL

• Avant de l’utiliser en production, nous vous recommandons de tester l’URL avec des outils comme :

  • https://webhook.site/

  • Postman

  • Insomnia

• Cela permet de s'assurer que votre endpoint reçoit bien les données correctement.

3. Configurer le webhook dans Eventtia

• Une fois que votre URL d'écoute est prête et accessible publiquement, collez-la dans la section « URL du webhook » de votre événement.
  
  
• À partir de là, vous pourrez sélectionner les événements spécifiques que vous souhaitez surveiller, tels que :

  • attendee_created – lorsqu’un nouveau participant est créé

  • attendee_updated – lorsqu’un participant est mis à jour

  • event_created – lorsqu’un événement est créé

  • event_updated – lorsqu’un événement est mis à jour

  • payment_created – lorsqu’un paiement est effectué

Et voilà. Votre webhook est désormais configuré et opérationnel.