Mit der n8n-Integration erstellen Sie Workflows zwischen FITsociety und anderen Diensten. Die Verbindung besteht aus FITsociety für Aktionen und FITsociety Trigger für Ereignisse, die einen Workflow starten.

Verfügbarkeit: Diese Anleitung gilt für eine selbst gehostete n8n-Umgebung. Das Paket ist auf npm veröffentlicht, aber noch nicht für n8n Cloud genehmigt. Sie können es daher noch nicht als genehmigte Community-Node in n8n Cloud installieren.

Was benötigen Sie?

• Eine selbst gehostete n8n-Umgebung, Version 2.44.6 oder neuer. Dies ist die mindestens unterstützte und getestete Version.

• Ein n8n Owner oder Admin mit Installationsrechten für Community-Nodes.

• Unternehmensspezifischer n8n-Zugriff, bereitgestellt von FITsociety nach Genehmigung des Unternehmensadministrators.

• Für direkte Trigger: eine öffentlich erreichbare HTTPS-Webhook-URL Ihrer n8n-Umgebung.

Fordern Sie den n8n-Zugriff beim FITsociety-Support an und beschreiben Sie zu lesende Daten und zu automatisierende Aktionen. Die Berechtigungen werden darauf abgestimmt. Eine Karte in der Integrationsübersicht erstellt diese Zugangsdaten nicht automatisch. Zugangsdaten für Zapier, Make oder andere Integrationen funktionieren hier nicht.

Schritt 1: Paket installieren

1. Öffnen Sie in n8n Settings → Community nodes.

2. Wählen Sie Install.

3. Geben Sie den Paketnamen ein: n8n-nodes-fitsociety ein.

4. Lesen und bestätigen Sie den Hinweis zu Community-Nodes und klicken Sie auf Install.

5. Prüfen Sie die Paketinstallation. Diese Anleitung basiert auf Version 0.1.2.

Verwenden Sie das FITsociety-Paket auf npm. Weitere Installationsinformationen findet der Administrator in der n8n-Dokumentation. Bei mehreren Workern muss das Paket auf allen verfügbar sein.

Schritt 2: Verbindung herstellen

1. Erstellen Sie einen Workflow und fügen Sie die Node FITsociety hinzu.

2. Erstellen Sie unter Credentials eine neue Verbindung des Typs FITsociety OAuth2 API.

3. Geben Sie bei API Base URL die von FITsociety bereitgestellte URL ein. Für die Produktion ist dies https://api.fitsociety.io/public/v1.

4. Geben Sie die zusammengehörigen Company ID, Client ID und Client Secret ein.

5. Speichern Sie das Credential und prüfen Sie den erfolgreichen Verbindungstest.

Der Verbindungstest liest nur das Unternehmensprofil und ändert keine Daten. Eine separate OAuth-Rückkehr-URL ist nicht erforderlich. n8n speichert Zugangsdaten verschlüsselt. Speichern Sie das Client Secret nur als Credential, nicht als Workflow-Text, Screenshot oder Supportnachricht.

Schritt 3: Einen sicheren ersten Test durchführen

Verbinden Sie einen Manual Trigger mit der FITsociety-Node. Wählen Sie Resource: Client und Operation: Search. Verwenden Sie unter Filters die genaue E-Mail-Adresse eines Testkunden und führen Sie den Schritt aus. Prüfen Sie, ob der erwartete Kunde aus dem richtigen Unternehmen zurückkommt. Wählen Sie erst danach eine datenändernde Aktion.

Mehrere Unternehmen oder Zugriff beenden

Erstellen Sie pro Unternehmen ein eigenes Credential mit den dafür bereitgestellten Daten. Zum Stoppen deaktivieren Sie den Workflow. Möchten Sie den Unternehmenszugriff vollständig widerrufen, bitten Sie Administrator oder FITsociety-Support, das betreffende n8n-Zugangspaar zu widerrufen. Das Stoppen eines einzelnen Workflows widerruft das Credential nicht.

Lesen Sie auch

• Workflows mit n8n erstellen: FITsociety-Aktionen und Trigger

• n8n funktioniert nicht: Installation, Verbindung und Trigger prüfen