Utilisez le nœud FITsociety pour récupérer ou modifier des données. Utilisez FITsociety Trigger lorsqu’un événement FITsociety doit démarrer le workflow. Les actions autorisées dépendent des droits des identifiants de votre entreprise.
Actions disponibles
Client : rechercher, récupérer, créer, modifier les coordonnées et inviter.
Tag : récupérer, ajouter ou retirer les tags d’un membre.
Coach : récupérer les coachs et attribuer un coach à un membre.
Booking : rechercher, récupérer, créer, annuler et modifier la présence.
Calendar Event : récupérer les événements d’agenda.
Form : récupérer les formulaires, attribuer un questionnaire initial et planifier un bilan.
Custom Field : récupérer les définitions et valeurs des membres, et modifier les valeurs éditables.
Recevoir un événement ne donne aucun droit d’écriture supplémentaire. Un événement de facture peut déclencher un workflow, mais le nœud ne propose pas d’action générale de création de factures. Les règles habituelles, produits disponibles et crédits restent applicables aux réservations.
Exemple : rechercher et récupérer un membre
Créez un workflow avec un Manual Trigger.
Ajoutez FITsociety avec Client → Search et filtrez avec l’adresse e-mail exacte d’un membre de test.
Ajoutez un deuxième nœud FITsociety avec Client → Get.
Associez le Client ID du résultat de recherche au champ Client ID du deuxième nœud.
Exécutez le workflow et vérifiez le résultat. Ajoutez une condition si la recherche peut ne rien renvoyer.
Démarrer un workflow depuis FITsociety
FITsociety Trigger propose 56 événements concernant notamment membres, réservations, facturation, formulaires, mesures, objectifs, habitudes, documents et conversations. Un événement n’est pas un export complet du dossier concerné. Vérifiez les champs reçus avant de les réutiliser.
Ajoutez FITsociety Trigger comme nœud de départ.
Sélectionnez les bons identifiants de l’entreprise.
Sous Events choisissez un ou plusieurs événements adaptés.
Ajoutez l’étape suivante et les filtres éventuels.
Enregistrez puis activez ou publiez le workflow, selon les termes de votre version n8n.
Effectuez ensuite une action de test adaptée dans FITsociety et vérifiez son exécution dans n8n.
L’activation enregistre automatiquement l’abonnement. Aucun webhook générique ne doit être créé manuellement dans FITsociety. Les identifiants doivent toutefois disposer des droits webhook et des consentements distincts requis pour les données de santé et communications privées. La lecture des membres seule ne suffit pas.
Les déclencheurs nécessitent une URL webhook HTTPS publique de n8n. Une adresse localhost ou interne seule ne fonctionne pas. Après une modification des Events, de l’URL ou des identifiants, désactivez puis réactivez le workflow pour actualiser l’abonnement. Les événements historiques ne sont pas rattrapés automatiquement.
Traiter les événements répétés en sécurité
Un événement peut être renvoyé, par exemple après une erreur temporaire de connexion. Utilisez l’id de l’événement pour repérer les doublons dans la suite du traitement. Pour les écritures FITsociety, associez cet ID à Business Event Key, afin qu’une nouvelle exécution reconnaisse la même action prévue pendant la durée de conservation. Pour des modifications distinctes, utilisez des clés ou nœuds différents. Cela ne garantit pas indéfiniment l’absence de doublons dans toutes les applications connectées.
Renseigner soigneusement les données
Pour le calendrier et les réservations, choisissez au maximum 92 jours. Utilisez YYYY-MM-DD pour les dates et un fuseau pour les heures. Pour les champs personnalisés, seuls les champs choisis sont modifiés ; zéro et false restent valides. Utilisez null pour effacer volontairement une valeur. La validation de l’entreprise reste applicable.
Testez les écritures uniquement avec des données prévues à cet effet. Client Create peut associer un compte existant et envoyer un e-mail. Client Send Invitation envoie une véritable invitation. Un agent IA configuré à cet effet peut aussi utiliser le nœud FITsociety comme outil ; limitez actions et données à ses besoins.