> For the complete documentation index, see [llms.txt](https://docs.scoreholio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scoreholio.com/fr/suivre-les-points-sur-plusieurs-evenements/track-points-across-events/webhooks.md).
# Webhooks des saisons
## Webhooks
Avant les webhooks, la seule façon de récupérer des données depuis Scoreholio Seasons était de te connecter et de lancer un rapport ou un export — un instantané manuel, pris après coup.
Les webhooks changent tout. Au lieu d’aller chercher les données toi-même, Scoreholio te les envoie dès qu’un changement se produit. Tu nous donnes une URL, tu nous dis quels événements t’intéressent, et on appelle cette URL à chaque fois que l’un d’eux se produit.
Ça veut dire que tu peux :
* Synchroniser les membres vers ton CRM dès qu’ils s’inscrivent — pas besoin d’export nocturne.
* Publier dans Slack/Discord/Teams lorsqu’un nouveau tournoi est créé.
* Déclencher un e-mail quand une transaction de saison est enregistrée.
* Garder un tableau de bord externe ou un tableur à jour en temps réel.
Les webhooks sont actuellement la seule façon de récupérer des données de Seasons par programmation. Il n’existe pas d’API REST publique.
### Tu n’as pas de développeur ? Utilise Zapier.
Tu n’as pas besoin d’écrire une seule ligne de code pour utiliser les webhooks. Zapier (et des outils similaires comme Make, n8n ou Pipedream) peut capter un webhook Scoreholio et le transformer en presque n’importe quelle action que tu peux imaginer — ajouter une ligne à une feuille Google Sheets, envoyer une campagne Mailchimp, publier dans Slack, créer un contact HubSpot, envoyer un SMS, et ainsi de suite.
Voici comment le configurer dans Zapier :
1. Dans Zapier, crée un nouveau Zap et choisis Webhooks by Zapier comme déclencheur.
2. Choisis l’événement Catch Hook.
3. Zapier va te donner une URL qui ressemble à quelque chose comme . Copie-la.
4. Dans Scoreholio, va dans Paramètres → Webhooks → Ajouter un webhook, colle cette URL, puis choisis les événements que tu veux.
5. Enregistre. Ensuite, fais dans Scoreholio l’action qui doit déclencher l’événement (par ex. ajouter un membre de test) pour que Zapier puisse voir à quoi ressemble le payload.
6. Retourne dans Zapier et clique sur Tester le déclencheur — tu devrais voir l’événement arriver.
7. Ajoute ensuite l’action que tu veux : Google Sheets, Slack, Mailchimp, Gmail, etc.
Le plan gratuit de Zapier inclut Webhooks by Zapier, mais un gros volume d’événements peut te faire passer à un plan payant. Si tu t’attends à beaucoup d’événements, vérifie les limites de tâches de Zapier.
La même approche fonctionne avec Make, n8n, Pipedream et d’autres outils no-code — ils ont tous une étape « déclencheur webhook » ou « capter un webhook ».
### Sur quoi peux-tu t’abonner ?
Chaque fois que l’une de ces choses se produit dans ton compte, on enverra un message à ton URL :
* Saisons — créées, mises à jour, supprimées
* Tournois — créés, mis à jour, supprimés
* Membres — créés, mis à jour, supprimés
* Transactions de saison — créées, mises à jour, supprimées
* Organisateurs — créés, mis à jour, supprimés
* Équipes — créées, mises à jour, supprimées (seulement si les classements par équipe sont activés pour cette saison)
Tu choisis exactement ceux qui t’intéressent — pas besoin de tous t’abonner.
### Comment en configurer un
1. Ouvre et connecte-toi avec ton compte Pro
2. Va dans Paramètres → Webhooks
3. Clique sur Ajouter un webhook
4. Colle l’URL où tu veux qu’on envoie les événements (par ex. , ou ton URL Zapier Catch Hook)
5. Coche les cases des événements qui t’intéressent
6. (Optionnel) Choisis des saisons précises à surveiller — laisse vide pour recevoir les événements de toutes les saisons
7. Clique sur Enregistrer
Quand tu l’enregistres, on te montrera un secret de signature — copie-le quelque part en sécurité. On ne l’affichera qu’une seule fois. Tu en auras besoin pour vérifier que les messages viennent bien de nous (voir ci-dessous).
### « Juste pour ces saisons » vs « toutes les saisons »
Par défaut, un webhook se déclenche pour chaque saison de ton compte. Si tu ne veux que, par exemple, ta ligue du printemps 2026, clique sur Modifier les saisons dans le formulaire et choisis celles que tu veux.
Attention : season.created, season.updated et season.deleted se déclenchent toujours pour chaque saison, quel que soit ce filtre — parce qu’au moment où une saison est créée ou supprimée, le filtre ne s’applique pas vraiment encore.
### Comment savoir que c’est vraiment Scoreholio ?
Chaque requête qu’on envoie inclut un en-tête appelé X-Scoreholio-Signature. C’est une empreinte créée à partir de ton secret de signature et du corps du message.
Quand tu reçois un webhook :
1. Prends le corps brut de la requête
2. Calcule la même empreinte avec ton secret de signature
3. Compare-la avec la valeur dans l’en-tête
4. Si elles correspondent → c’est nous. Si elles ne correspondent pas → jette le message.
Ça empêche des gens au hasard sur Internet d’envoyer de faux événements en POST vers ton URL.
Si tu utilises Zapier (ou un autre outil no-code), tu peux ignorer la vérification de signature — les URL de webhook Zapier sont déjà une longue chaîne aléatoire, presque impossible à deviner. La vérification de signature sert surtout quand tu fais tourner ton propre serveur.
### Mettre un webhook en pause
Si ton serveur est hors ligne pour maintenance, tu n’as pas besoin de supprimer le webhook — modifie-le juste et passe Actif à En pause. On arrêtera d’envoyer jusqu’à ce que tu le repasses en actif.
### Comment savoir si ça marche ?
La liste des webhooks t’affiche, pour chacun :
* Dernier — la dernière livraison était-elle un ✓ ou un ✗
* Quand — il y a combien de temps on a essayé d’envoyer la dernière fois
Si tu vois toujours des ✗, ton URL ne répond probablement pas avec un code d’état 2xx, ou elle est hors ligne.
### Suppression
Clique sur Options → Supprimer sur la ligne. Il arrête immédiatement de recevoir des événements. (Le secret de signature disparaît aussi pour toujours, donc si tu le recrées un jour, tu auras un nouveau secret.)