n8n ne fonctionne pas : vérifier installation, connexion et déclencheurs

4 min de lecture

Je ne peux pas installer FITsociety dans n8n Cloud

Le nœud FITsociety est publié pour un hébergement n8n propre, mais n8n Cloud ne l’a pas encore approuvé. Une publication npm ne le rend pas automatiquement disponible dans Cloud. Ce guide concerne donc une installation auto-hébergée.

Community nodes ou le nœud FITsociety manque

Demandez au Owner ou Admin n8n de vérifier que les nœuds communautaires sont autorisés et que n8n-nodes-fitsociety est installé. Utilisez n8n 2.44.6 ou ultérieur. Avec plusieurs workers, la même version du paquet doit être installée partout. Ne supprimez pas le paquet comme première mesure : les workflows existants peuvent en dépendre.

Le test de connexion échoue

Utilisez l’URL HTTPS complète contenant /public/v1 comme API Base URL.
Vérifiez que Company ID, Client ID et Client Secret appartiennent à la même entreprise et à la connexion n8n.
Ne les remplacez pas par des identifiants Zapier, Make ou d’une autre API.
Vérifiez que l’accès est toujours actif. S’il est révoqué ou remplacé, demandez de nouveaux identifiants à l’administrateur de l’entreprise et à l’assistance FITsociety.

Un test réussi confirme la connexion au profil de l’entreprise, sans prouver que les identifiants autorisent toutes les actions. Si une seule fonction manque, faites vérifier les droits accordés.

Une action renvoie une erreur d’accès, de recherche ou de validation

401 ou connexion non valide : vérifiez les identifiants et l’activation de l’accès à l’entreprise.
403 ou droits insuffisants : faites examiner les droits d’action ou de données nécessaires. Des identifiants en lecture seule ne peuvent pas modifier un membre.
404 ou introuvable : vérifiez l’entreprise et le bon Client ID ou Booking ID.
409 ou conflit : vérifiez si l’enregistrement existe déjà ou si une clé de nouvelle tentative est utilisée avec une entrée modifiée.
Entrée non valide : vérifiez champs obligatoires, dates, fuseaux horaires et valeurs autorisées des champs personnalisés.
429 ou trop de requêtes : réduisez la concurrence et respectez le délai indiqué avant de réessayer.

Si la recherche d’un membre ne renvoie rien, utilisez l’adresse e-mail exacte et vérifiez les filtres de statut. Les recherches de calendrier et de réservations sont limitées à 92 jours.

Le déclencheur ne reçoit rien

Vérifiez que le workflow est actif ou publié et que les bons Events sont sélectionnés.
Vérifiez que les identifiants disposent des droits webhook et des confirmations de données requises. Une recherche ordinaire réussie ne le prouve pas.
Demandez à l’administrateur de vérifier l’URL HTTPS publique du webhook et le reverse proxy. FITsociety doit atteindre directement l’URL ; localhost, adresses privées et redirections sont refusés.
Après une modification de l’URL, des Events ou des identifiants, désactivez puis réactivez le workflow.
Créez un nouvel événement de test adapté et consultez l’historique d’exécution. Les anciens événements ne sont pas automatiquement renvoyés.

Message concernant la signature ou l’horodatage

Le déclencheur vérifie que le message provient réellement de FITsociety. Faites vérifier l’horloge du serveur, le proxy et la transmission inchangée du contenu initial du webhook. Ne désactivez pas ce contrôle. Après remplacement du Client Secret, réactivez les workflows de déclenchement.

Une action s’exécute deux fois

La livraison des webhooks peut être répétée. Utilisez l’ID d’événement d’origine pour dédupliquer et comme Business Event Key des écritures FITsociety. Ne créez pas un nouvel ID aléatoire à chaque tentative. Vérifiez aussi la protection contre les doublons de l’application destinataire.

Aide de l’assistance

Indiquez le nom de l’entreprise, les versions n8n et du paquet FITsociety, la ressource et l’action ou le déclencheur, l’erreur et l’heure avec fuseau. Ajoutez l’ID d’exécution si disponible. Masquez clés, jetons, secrets webhook et données des membres dans les captures et exports. Ne partagez pas de Client Secret avec l’assistance.