FITsociety Help FR

Configurer les webhooks pour transmettre les changements

3 min de lecture

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

  1. Dans la bonne entreprise, accède à Paramètres → Extensions et Intégrations → Webhooks.

  2. Choisis Ajouter un webhook et donne-lui un nom reconnaissable.

  3. Dans Target URL, saisis l’adresse de réception.

  4. Vérifie Events et sélectionne uniquement les événements souhaités, comme client.created ou booking.created. Contrôle aussi la présélection.

  5. 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)

Cet article vous a-t-il été utile ? Merci pour votre retour !

Merci, nous lisons chaque commentaire.

Articles liés