Configuration des webhooks Growth+This feature requires the Growth+ plan or higher
Les webhooks permettent à des applications externes de recevoir des notifications en temps réel lorsqu'un événement se produit dans votre compte EquipDash. Au lieu d'interroger l'API sans cesse, votre application reçoit instantanément une requête HTTP POST chaque fois qu'un événement sélectionné a lieu.
Créer un point de terminaison webhook
- Cliquez sur Paramètres dans la barre latérale.
- Sélectionnez API et intégrations dans le menu des paramètres.
- Cliquez sur l'onglet Webhooks.
- Cliquez sur + Créer un webhook.
- Renseignez les champs suivants :
- Nom -- un libellé descriptif (par exemple, « Synchronisation comptable », « Notifications Slack »).
- URL -- l'adresse du point de terminaison où EquipDash doit envoyer les données du webhook (elle doit commencer par HTTPS).
- Événements -- sélectionnez les événements qui doivent déclencher ce webhook (voir le tableau des événements ci-dessous).
- Actif -- activez cette option pour commencer à recevoir les événements immédiatement.
- Cliquez sur Créer.

Secret du webhook
Après la création d'un webhook, EquipDash génère un secret de webhook. Ce secret sert à vérifier que les requêtes reçues proviennent bien d'EquipDash.
- Copiez le secret immédiatement et conservez-le en lieu sûr.
- Utilisez le secret pour valider l'en-tête
X-Webhook-Signaturedes requêtes reçues.
Le secret du webhook n'est affiché qu'une seule fois, au moment de la création du webhook. Si vous le perdez, vous pouvez le régénérer depuis la page de détail du webhook -- mais vous devrez alors mettre à jour votre application avec le nouveau secret.
Événements webhook disponibles
Réservations
| Événement | Se déclenche lorsque |
|---|---|
booking.created | Une nouvelle réservation est créée |
booking.updated | Une réservation est modifiée |
booking.cancelled | Une réservation est annulée |
booking.completed | Une réservation est marquée comme terminée |
Paiements
| Événement | Se déclenche lorsque |
|---|---|
payment.received | Un paiement est enregistré |
payment.refunded | Un remboursement est effectué |
Clients
| Événement | Se déclenche lorsque |
|---|---|
customer.created | Un nouveau client est ajouté |
customer.updated | La fiche d'un client est modifiée |
customer.deleted | Un client est supprimé |
Produits
| Événement | Se déclenche lorsque |
|---|---|
product.created | Un nouveau produit est ajouté |
product.updated | Un produit est modifié |
product.archived | Un produit est archivé |
Expériences
| Événement | Se déclenche lorsque |
|---|---|
experience.created | Une nouvelle expérience est ajoutée |
experience.updated | Une expérience est modifiée |
experience.archived | Une expérience est archivée |
Formulaires
| Événement | Se déclenche lorsque |
|---|---|
form_response.submitted | Un client envoie une décharge ou un formulaire |
Bons cadeaux
| Événement | Se déclenche lorsque |
|---|---|
voucher.sold | Un bon ou une carte cadeau est acheté |
voucher.redeemed | Un bon est utilisé pour une réservation |
Gérer les webhooks
Depuis l'onglet Webhooks, vous pouvez :
- Modifier un webhook pour changer son nom, son URL ou les événements sélectionnés.
- Mettre en pause un webhook en le désactivant. Aucun événement n'est envoyé pendant la pause.
- Régénérer le secret si le secret de votre webhook a été compromis.
- Supprimer un webhook pour l'effacer définitivement.
Vérifier les signatures des webhooks
Chaque requête webhook comprend un en-tête X-Webhook-Signature. Pour vérifier qu'elle est authentique :
- Calculez un hachage HMAC-SHA256 du corps de la requête avec votre secret de webhook.
- Comparez le hachage calculé avec la valeur de l'en-tête
X-Webhook-Signature. - S'ils sont identiques, la requête est authentique.
Cela empêche des personnes malveillantes d'envoyer de faux événements webhook à votre point de terminaison.