La connexion n8n permet de créer des workflows entre FITsociety et d’autres services. Elle comprend FITsociety pour les actions et FITsociety Trigger pour les événements démarrant un workflow.
Disponibilité : ce guide concerne n8n auto-hébergé. Le paquet est publié sur npm, mais n8n Cloud ne l’a pas encore approuvé. Il n’est donc pas encore installable dans Cloud comme nœud communautaire approuvé.
De quoi avez-vous besoin ?
Un environnement n8n auto-hébergé, version 2.44.6 ou ultérieure. C’est la version minimale prise en charge et testée.
Un Owner ou Admin n8n autorisé à installer des nœuds communautaires.
Un accès n8n propre à l’entreprise, fourni par FITsociety après approbation de son administrateur.
Pour les déclencheurs directs : une URL webhook HTTPS publiquement accessible de votre environnement n8n.
Demandez l’accès n8n à l’assistance FITsociety en décrivant les données à lire et actions à automatiser. L’accès est adapté à ces besoins. Une carte dans l’aperçu des connexions ne génère pas automatiquement les identifiants. Ceux de Zapier, Make ou d’une autre connexion ne fonctionnent pas.
Étape 1 : installer le paquet
Dans n8n, ouvrez Settings → Community nodes.
Choisissez Install.
Saisissez le nom du paquet
n8n-nodes-fitsociety.Lisez et confirmez l’avertissement sur les nœuds communautaires, puis cliquez sur Install.
Vérifiez l’installation du paquet. Ce guide repose sur la version 0.1.2.
Utilisez le paquet FITsociety sur npm. L’administrateur trouvera davantage d’informations dans la documentation n8n. Avec plusieurs workers, le paquet doit être disponible sur chacun.
Étape 2 : créer la connexion
Créez un workflow et ajoutez le nœud FITsociety .
Dans Credentials, créez une connexion de type FITsociety OAuth2 API.
Dans API Base URL saisissez l’URL fournie par FITsociety. En production, il s’agit de
https://api.fitsociety.io/public/v1.Saisissez les valeurs correspondantes de Company ID, Client ID et Client Secret .
Enregistrez les identifiants et vérifiez la réussite du test de connexion.
Le test lit uniquement le profil de l’entreprise et ne modifie aucune donnée. Aucune URL de retour OAuth distincte n’est nécessaire. n8n chiffre les identifiants. Conservez le Client Secret uniquement dans les identifiants, jamais en texte dans un workflow, une capture ou un message d’assistance.
Étape 3 : effectuer un premier test sûr
Reliez un Manual Trigger au nœud FITsociety. Choisissez Resource: Client et Operation: Search. Sous Filters, utilisez l’adresse e-mail exacte d’un membre de test et exécutez l’étape. Vérifiez que le bon membre de la bonne entreprise est renvoyé avant toute action modifiant les données.
Plusieurs entreprises ou fin d’accès
Créez des identifiants distincts par entreprise avec les données fournies. Pour arrêter un workflow, désactivez-le. Pour révoquer entièrement l’accès à l’entreprise, demandez à son administrateur ou à l’assistance FITsociety de révoquer la paire d’accès n8n concernée. Arrêter un workflow seul ne révoque pas les identifiants.