Ich kann FITsociety nicht in n8n Cloud installieren
Die FITsociety-Node wurde für eigenes n8n-Hosting veröffentlicht, ist aber noch nicht für n8n Cloud genehmigt. Eine npm-Veröffentlichung macht die Node nicht automatisch in Cloud verfügbar. Diese Anleitung geht deshalb von einer selbst gehosteten Umgebung aus.
Community nodes oder die FITsociety-Node fehlen
Lassen Sie den n8n Owner oder Admin prüfen, ob Community-Nodes in Ihrer Umgebung erlaubt sind und ob n8n-nodes-fitsociety installiert ist. Verwenden Sie n8n 2.44.6 oder neuer. Bei mehreren Workern muss überall dieselbe Paketversion vorhanden sein. Entfernen Sie das Paket nicht als ersten Reparaturschritt; bestehende Workflows können davon abhängen.
Der Verbindungstest schlägt fehl
Verwenden Sie die vollständige HTTPS-URL mit
/public/v1als API Base URL.Prüfen Sie, ob Company ID, Client ID und Client Secret zum selben Unternehmen und zur n8n-Verbindung gehören.
Verwenden Sie keine Zugangsdaten von Zapier, Make oder anderen APIs als Ersatz.
Prüfen Sie, ob der Zugriff noch aktiv ist. Fordern Sie bei widerrufenem oder ersetztem Zugriff über Unternehmensadministrator und FITsociety-Support neue Daten an.
Ein erfolgreicher Verbindungstest bestätigt die Verbindung zum Unternehmensprofil. Er beweist nicht, dass das Credential jede Aktion ausführen darf. Fehlt nur eine bestimmte Funktion, lassen Sie die erteilten Rechte prüfen.
Eine Aktion erhält einen Zugriffs-, Such- oder Validierungsfehler
401 oder ungültige Verbindung: Prüfen Sie Credential und weiterhin aktiven Unternehmenszugriff.
403 oder unzureichende Rechte: Lassen Sie die benötigten Aktions- oder Datenrechte prüfen. Ein Lese-Credential kann keine Kunden ändern.
404 oder nicht gefunden: Prüfen Sie Unternehmen und richtige Client ID oder Booking ID.
409 oder Konflikt: Prüfen Sie, ob der Datensatz bereits existiert oder ein Wiederholungsschlüssel für geänderte Eingaben verwendet wird.
Ungültige Eingabe: Prüfen Sie Pflichtfelder, Datumswerte, Zeitzonen und erlaubte Werte benutzerdefinierter Felder.
429 oder zu viele Anfragen: Reduzieren Sie parallele Ausführungen und beachten Sie die angegebene Wartezeit vor einem erneuten Versuch.
Verwenden Sie bei ergebnisloser Kundensuche die genaue E-Mail-Adresse und prüfen Sie mögliche Statusfilter. Für Kalender- und Buchungssuchen sind höchstens 92 Tage erlaubt.
Der Trigger empfängt nichts
Prüfen Sie, ob der Workflow aktiv oder veröffentlicht ist und die richtigen Events ausgewählt sind.
Prüfen Sie die Webhook-Rechte und erforderlichen Datenbestätigungen des Credentials. Eine erfolgreiche normale Suche ist dafür kein Nachweis.
Lassen Sie den n8n-Administrator die öffentliche HTTPS-Webhook-URL und Reverse-Proxy-Einstellungen prüfen. FITsociety muss die URL direkt erreichen können; localhost, private Adressen und Weiterleitungen werden abgelehnt.
Deaktivieren und aktivieren Sie den Workflow nach Änderungen an URL, Events oder Credential erneut.
Erstellen Sie ein neues passendes Testereignis und prüfen Sie den Ausführungsverlauf. Alte Ereignisse werden nicht automatisch erneut gesendet.
Eine Meldung zu Signatur oder Zeitstempel
Der Trigger prüft die tatsächliche Herkunft einer Nachricht von FITsociety. Lassen Sie Serveruhr, Proxy und unveränderte Weiterleitung des ursprünglichen Webhook-Inhalts prüfen. Deaktivieren Sie diese Prüfung nicht. Nach Austausch des Client Secret müssen Trigger-Workflows erneut aktiviert werden.
Eine Aktion wird doppelt ausgeführt
Webhook-Zustellungen können wiederholt werden. Verwenden Sie die ursprüngliche Ereignis-ID zur Duplikaterkennung und als Business Event Key für FITsociety-Schreibaktionen. Verwenden Sie nicht bei jedem Wiederholungsversuch eine neue Zufalls-ID. Prüfen Sie auch den Duplikatschutz der empfangenden App.
Hilfe vom Support
Geben Sie Unternehmensname, n8n-Version, FITsociety-Paketversion, Resource und Aktion oder Trigger, Fehlermeldung und Zeitpunkt mit Zeitzone an. Ergänzen Sie die Ausführungs-ID, sofern verfügbar. Machen Sie Schlüssel, Token, Webhook-Secrets und Kundendaten in Screenshots und Workflow-Exporten unkenntlich. Teilen Sie kein Client Secret im Supportbericht.