Zum Hauptinhalt springen

n8n

Verfügbar

Diese Integration ist aktiv und auf allen Pro-Plänen einsatzbereit.

Verbinde Frihet mit n8n, um Workflows zu automatisieren: automatische Erinnerungen, Synchronisierung mit CRM, personalisierte Benachrichtigungen und mehr.

Wofür ist das?​

Mit integriertem n8n:

  • Automatische Erinnerungen — Sendet E-Mails, wenn eine Rechnung fällig ist
  • CRM-Synchronisierung — Neue Kunden werden in Salesforce, Pipedrive usw. erstellt.
  • Personalisierte Benachrichtigungen — Slack, E-Mail, Telegram, benutzerdefinierter Webhook
  • Komplexe Workflows — Bedingungen, Schleifen, logische Verzweigungen
  • Webhook-Endpunkte — Andere Systeme lösen Aktionen in Frihet aus

Anforderungen​

Frihet-Zugangsdaten erhalten​

In Frihet​

  1. Gehe zu Einstellungen → Integrationen → n8n
  2. Klicke auf "API-Schlüssel generieren"
  3. Kopiere den Schlüssel (etwa: fh_live_XXXXXXXXXXXXXXXXX)
  4. Klicke auf "Webhook erstellen"
  5. Kopiere die Webhook-URL (um Ereignisse zu empfangen)

Speichere beides an einem sicheren Ort.

Frihet mit n8n verbinden​

Schritt 1: Workflow in n8n erstellen​

  1. Gehe zu n8n.io
  2. Neuer Workflow
  3. Füge Knoten hinzu: Frihet (suche danach)

Schritt 2: Zugangsdaten konfigurieren​

  1. Gehe im Frihet-Knoten zu Zugangsdaten
  2. Klicke auf "Neue Zugangsdaten erstellen"
  3. Füge den API-Schlüssel von Frihet ein
  4. Speichern

Schritt 3: Aktion auswählen​

Wähle im Knoten aus, was getan werden soll:

  • Rechnung erstellen
  • Ausgabe erstellen
  • Kunde erstellen
  • Kundenliste abrufen
  • Rechnungsliste abrufen
  • Rechnung als bezahlt markieren

Häufige Anwendungsfälle​

Fälligkeitserinnerung​

Wann: Jeden Morgen um 9 Uhr Was es tut: Sucht nach überfälligen Rechnungen und sendet eine E-Mail an den Kunden

n8n workflow:
1. Trigger: Jeden Tag um 09:00
2. Frihet-Knoten: Überfällige Rechnungen abrufen
3. Schleife: Für jede Rechnung
4. E-Mail-Knoten: Erinnerungs-E-Mail senden
5. In Frihet aktualisieren: "Erinnerung gesendet" markieren

Neuer Kunde → CRM​

Wann: Ein Kunde in Frihet erstellt wird Was es tut: Fügt ihn automatisch zu Salesforce/Pipedrive hinzu

n8n workflow:
1. Trigger: Frihet-Webhook (neuer Kunde)
2. Frihet-Knoten: Kundendaten abrufen
3. Salesforce-Knoten: Kontakt erstellen
4. E-Mail-Knoten: Team benachrichtigen

Rechnung bezahlt → Slack-Benachrichtigung​

Wann: Eine Rechnung als bezahlt markiert wird Was es tut: Sendet eine Benachrichtigung an Slack mit Details

n8n workflow:
1. Trigger: Frihet-Webhook (Rechnung bezahlt)
2. Frihet-Knoten: Rechnungsdetails abrufen
3. Slack-Knoten: Formatierte Nachricht senden
4. Sheet-Knoten: In Google Sheets protokollieren (optional)

Rechnung aus Formular erstellen​

Wann: Jemand ein Formular ausfüllt What es tut: Erstellt automatisch eine Rechnung in Frihet

n8n workflow:
1. Trigger: Formular-Webhook (TypeForm, Typebot usw.)
2. Knoten: Formulardaten verarbeiten
3. Frihet-Knoten: Rechnung erstellen
4. E-Mail-Knoten: Kunden bestätigen

Vorkonfigurierte Vorlagen​

n8n und Frihet bieten vorgefertigte Vorlagen:

  1. Gehe in n8n zu Community → Vorlagen
  2. Suche nach "Frihet"
  3. Wähle eine Vorlage
  4. Klicke auf "Diese Vorlage verwenden"
  5. Konfiguriere nur die Zugangsdaten

Verfügbare Vorlagen​

  • "Erinnerung an überfällige Rechnungen"
  • "Kunden mit Airtable synchronisieren"
  • "Zahlungsbenachrichtigungen in Slack"
  • "Rechnungen aus Typeform erstellen"
  • "Tägliches Backup auf Google Drive"

Verwende sie als Basis und passe sie an.

Frihet-Webhook​

Frihet sendet Ereignisse automatisch an n8n. Siehe die vollständige Webhook-Dokumentation für Details zur HMAC-SHA256-Signatur, Wiederholungsversuchen und allen Ereignistypen.

Ereignisse, die den Webhook auslösen​

EreignisGesendete Daten
Rechnung erstelltID, Kunde, Betrag, Fälligkeit
Rechnung bezahltID, Kunde, Betrag, Zahlungsdatum
Rechnung überfälligID, Kunde, Betrag, Tage überfällig
Kunde erstelltID, Name, E-Mail, Telefon
Ausgabe erstelltID, Kategorie, Betrag, Datum
Zahlung erhaltenRechnungs-ID, Kunde, Betrag

Webhook in Frihet konfigurieren​

  1. Einstellungen → Integrationen → n8n
  2. Klicke auf "Webhook erstellen"
  3. Wähle aus, welche Ereignisse ausgelöst werden sollen (empfohlen: alle)
  4. Kopiere die Webhook-URL
  5. Konfiguriere in n8n einen "Webhook"-Knoten als Trigger mit dieser URL

Verfügbare Aktionen in Frihet​

Rechnung erstellen​

Eingabe:
- Kunden-ID (oder neu erstellen)
- Konzept
- Betrag
- Fälligkeit
- Mehrwertsteuer

Ausgabe:
- ID der erstellten Rechnung
- Dokumentennummer
- Status

Ausgabe erstellen​

Eingabe:
- Kategorie
- Betrag
- Datum
- Lieferant (optional)

Ausgabe:
- Ausgaben-ID
- Bestätigung

Liste abrufen​

Eingabe:
- Filter (Datum, Kunde, Status)
- Ergebnislimit

Ausgabe:
- Array von Rechnungen/Ausgaben/Kunden

Als bezahlt markieren​

Eingabe:
- Rechnungs-ID
- Betrag (optional)
- Zahlungsmethode (optional)

Ausgabe:
- Bestätigung
- Aktualisierungsdatum

Vollständiges Beispiel: Tägliche Erinnerung​

Ziel​

Jeden Morgen um 8 Uhr, wenn überfällige Rechnungen vorliegen, senden Sie eine E-Mail an den Kunden.

Workflow in n8n​

Schritt 1: Trigger

Scheduler: Jeden Tag um 08:00
Timezone: Europe/Madrid

Schritt 2: Überfällige Rechnungen abrufen

Knoten: Frihet
Aktion: Get Invoices
Filter: State = "unpaid" AND Due Date < Today

Schritt 3: Schleife über jede Rechnung

Loop Node: Für jede Rechnung im Ergebnis
  - E-Mail des Kunden abrufen
  - Überfällige Tage berechnen

Schritt 4: E-Mail senden

Knoten: Gmail / SendGrid
An: E-Mail des Kunden
Betreff: "Rechnung #{{$node.Frihet.data.number}} zur Zahlung fällig"
Text:
  "Ihre Rechnung {{id}} über {{monto}} Euro
   ist seit {{días_vencida}} Tagen überfällig.
   Bitte begleichen Sie die Zahlung so schnell wie möglich.
   [Zahlungslink]"

Schritt 5: In Frihet aktualisieren

Knoten: Frihet
Aktion: Update Invoice
Aktualisieren: reminder_sent = true
Aktualisieren: reminder_date = today

Bidirektionale Synchronisierung mit CRM​

Kunde in Frihet erstellen → Salesforce​

1. Trigger: Frihet-Webhook (Kunde erstellt)
2. Frihet: Kundendaten abrufen
3. Salesforce: Account erstellen
4. Salesforce: Kontakt erstellen
5. Frihet: Salesforce ID beim Kunden speichern

Deal in Salesforce erstellen → Rechnung in Frihet​

1. Trigger: Salesforce-Webhook (Deal gewonnen)
2. Salesforce: Deal-Daten abrufen
3. Frihet: Kunde erstellen (falls neu)
4. Frihet: Rechnung mit Deal-Betrag erstellen
5. Salesforce: Deal mit Link zu Frihet aktualisieren

Personalisierte Benachrichtigungen​

Option 1: E-Mail​

Knoten: Gmail / SendGrid
Personalisierte Vorlage mit:
  - Logo Ihres Unternehmens
  - Rechnungsdetails
  - Zahlungslink

Option 2: Slack​

Knoten: Slack
Nachricht:
  ":moneybag: Rechnung bezahlt
   Kunde: {{cliente}}
   Betrag: €{{monto}}
   Status: Bezahlt ✅"

Option 3: WhatsApp/Telegram​

Knoten: Telegram / WhatsApp (über Twilio)
Nachricht:
  "Hallo {{nombre}},
   Ihre Rechnung #{{id}} ist in 3 Tagen fällig.
   [Hier bezahlen]"

Option 4: Benutzerdefinierter Webhook​

Wenn Sie Ihr eigenes System haben:

Knoten: HTTP POST
URL: https://tu-sistema.com/frihet-webhook
Body:
  {
    "event": "invoice_paid",
    "invoice_id": "...",
    "amount": 1200,
    "client": "..."
  }

Ihr System verarbeitet die Daten nach Bedarf.

Bedingungen und Logik​

Sie können Bedingungen hinzufügen:

WENN Rechnung überfällig MEHR ALS 7 TAGE
  DANN E-Mail senden + Aufgabe erstellen
SONST WENN überfällig WENIGER ALS 7 TAGE
  DANN nur E-Mail senden
SONST
  DANN nichts tun

Oder komplexere Verzweigungen:

WENN Kunde "Premium" ist
  DANN anrufen
SONST WENN Kunde "Regulär" ist
  DANN E-Mail senden
SONST
  DANN ignorieren

Testen und Debuggen​

Workflow manuell ausführen​

  1. Klicke in n8n auf "Execute"
  2. Siehe die Ergebnisse Schritt für Schritt
  3. Wenn ein Fehler auftritt, wird dieser mit Details angezeigt
  4. Anpassen und erneut ausführen

Logs und Verlauf​

  1. Gehe zu Executions in Ihrem Workflow
  2. Siehe jede Ausführung:
    • Wann sie ausgeführt wurde
    • Ob sie erfolgreich war
    • Ausführungszeit
    • Ergebnisse jedes Knotens

Testen mit Testdaten​

Vor der Aktivierung (Planung) testen:

  1. Bearbeiten Sie den Trigger auf Manuell
  2. Klicken Sie mehrmals auf "Execute"
  3. Überprüfen Sie, ob jeder Knoten funktioniert
  4. Wechseln Sie dann zu Automatischem Trigger (Scheduler)

Limits und Kosten​

In n8n​

  • Automatische Workflows: Abhängig von Ihrem Plan
  • Ausführungen: Kostenlos bis zu einem bestimmten Limit
  • Knoten: Unbegrenzt
  • Integrationen: Hunderte verfügbar

In Frihet​

  • API-Aufrufe: In Pro enthalten (keine zusätzlichen Limits)
  • Webhooks: Unbegrenzt
  • Daten: Kein spezielles Limit für n8n

Fehlerbehebung​

"Webhook wird nicht ausgelöst"​

  • Überprüfen Sie, ob der Webhook in Frihet aktiv ist
  • Das Ereignis muss mit der Konfiguration übereinstimmen
  • Überprüfen Sie die n8n-Logs: Executions → Verlauf
  • Wenn ein HTTP-Fehler auftritt, überprüfen Sie den Status des Webhooks

"Fehler: Keine Zugangsdaten gefunden"​

  • Überprüfen Sie in n8n, ob die Zugangsdaten gespeichert sind
  • Kopieren Sie den Frihet API-Schlüssel erneut
  • Erstellen Sie die Zugangsdaten neu

"Wie debugge ich, wenn etwas nicht funktioniert?"​

  1. Fügen Sie einen "Log"-Knoten zwischen den Schritten hinzu, um Zwischendaten anzuzeigen
  2. Führen Sie manuell Schritt für Schritt aus
  3. Gehe zu Executions → vollständiger Verlauf
  4. Suchen Sie den Fehler in den Logs

"Kann ich mehrere Workflows verwenden?"​

Ja. Sie können haben:

  • Workflow 1: Tägliche Erinnerungen
  • Workflow 2: CRM-Synchronisierung
  • Workflow 3: Automatische Backups
  • Alle laufen parallel

Nächste Schritte​

Vorheriger: Revolut Business