Documentation technique : toutes les routes API, autorisations et exemples à jour se trouvent sur docs.fitsociety.io. Pour les développeurs, commence par le guide de démarrage rapide de la Public API.
Un webhook envoie une notification à un autre système lorsqu’un événement survient dans FITsociety. Ton CRM peut ainsi réagir à un nouveau membre, ou ton automatisation démarrer après une nouvelle réservation.
Dans cet article
De quoi as-tu besoin ?
Il te faut l’accès à Public API et à la gestion des webhooks pour ton entreprise, ainsi qu’une adresse de réception fournie par ton développeur ou ton outil d’automatisation. Il doit s’agir d’une adresse HTTPS accessible publiquement. Une adresse localhost ou une adresse de réseau interne ne fonctionne pas.
Un webhook signale un événement ; l’autre système réalise l’étape suivante. Pour obtenir des données supplémentaires ou effectuer une modification dans FITsociety, un client API avec les droits adaptés peut aussi être nécessaire.
Créer le webhook
Dans la bonne entreprise, accède à Paramètres → Extensions et Intégrations → Webhooks.
Choisis Ajouter un webhook et donne-lui un nom reconnaissable.
Dans Target URL, saisis l’adresse de réception.
Vérifie Events et sélectionne uniquement les événements souhaités, comme
client.createdoubooking.created. Contrôle aussi la présélection.Enregistre le webhook et copie le signing secret affiché une seule fois. Demande à ton développeur de le conserver en sécurité et de vérifier la signature des notifications.
Tester et vérifier les livraisons
Utilise l’action de test du webhook et vérifie que le système destinataire traite la notification. Consulte aussi les tentatives de livraison récentes dans FITsociety. Une livraison réussie a le statut delivered : le destinataire a répondu avec HTTP 2xx.
En cas d’erreur, il y a au maximum trois tentatives de livraison au total. failed peut encore faire l’objet d’une nouvelle tentative ; exhausted signifie qu’il ne reste plus de tentative. En cas d’erreur, fais vérifier l’adresse de réception, son accessibilité et le message d’erreur.
Un test réussi prouve que la réception fonctionne. Vérifie aussi un événement réel et l’action suivante attendue avant de te fier au workflow.
Modifier et traiter les notifications avec soin
En modifiant le webhook, tu changes son adresse, ses événements ou son statut. Passe le webhook sur Désactivé pour arrêter les nouvelles notifications via ce webhook. Vérifie aussi les éventuelles actions déjà reçues ou en cours dans l’autre système.
Les notifications contiennent des données compactes, pas un dossier client complet. Le destinataire doit reconnaître les doublons grâce à l’identifiant stable de l’événement, afin que le même événement ne déclenche pas deux fois une action.
Pour la gestion via l’API, webhooks:read, webhooks:write et, pour les tentatives de livraison, webhook_deliveries:read sont disponibles. La documentation technique décrit les événements, les payloads et la vérification des signatures.
Pour aller plus loin
Documentation technique pour ton développeur (en anglais)