Workflow Grundlagen

Ein Workflow ist eine automatisierte Abfolge von Aktionen. Stell dir vor: "Wenn X passiert, dann mache Y und Z."

Beispiel: Neue E-Mail mit Rechnung → PDF extrahieren → In Paperless speichern → Slack-Nachricht senden

Nodes sind die einzelnen Bausteine eines Workflows. Jeder Node macht genau eine Sache.

Connections verbinden Nodes und definieren wie Daten fliessen.

┌─────────────┐       ┌─────────────┐       ┌─────────────┐
│   Webhook   │──────▶│  HTTP Req   │──────▶│   Slack     │
│  (Trigger)  │ JSON  │  (Action)   │ JSON  │  (Action)   │
└─────────────┘       └─────────────┘       └─────────────┘
                            │
                            │ JSON (bei Fehler)
                            ▼
                      ┌─────────────┐
                      │   Email     │
                      │  (Action)   │
                      └─────────────┘

So verbindest du Nodes:

1. Ziehe vom Output-Punkt (rechts) eines Nodes
2. Zum Input-Punkt (links) des nächsten Nodes
3. Die Verbindung wird als Linie angezeigt

n8n arbeitet mit Items. Jeder Node empfängt und sendet Items im JSON-Format.

[
  {
    "json": {
      "name": "Max Mustermann",
      "email": "max@beispiel.de",
      "amount": 150.00
    }
  },
  {
    "json": {
      "name": "Anna Schmidt",
      "email": "anna@beispiel.de",
      "amount": 89.50
    }
  }
]

Wichtige Konzepte:

Mit Expressions greifst du dynamisch auf Daten aus vorherigen Nodes zu. Expressions werden in {{ }} geschrieben.

// Aktuelles Item
__LBRACE2__ $json.name __RBRACE2__                    // → "Max Mustermann"
__LBRACE2__ $json.email __RBRACE2__                   // → "max@beispiel.de"

// Verschachtelte Daten
__LBRACE2__ $json.address.city __RBRACE2__            // → "Berlin"
__LBRACE2__ $json.items[0].name __RBRACE2__           // → Erstes Element im Array

// Daten aus anderem Node
__LBRACE2__ $('HTTP Request').item.json.id __RBRACE2__ // → Daten vom Node "HTTP Request"

// Alle Items eines Nodes
__LBRACE2__ $('Webhook').all() __RBRACE2__            // → Array aller Items

Nuetzliche Expressions:

// Datum & Zeit
__LBRACE2__ $now __RBRACE2__                          // Aktuelles Datum/Zeit
__LBRACE2__ $today __RBRACE2__                        // Heute (ohne Uhrzeit)
__LBRACE2__ $now.format('DD.MM.YYYY') __RBRACE2__     // → "15.01.2026"

// Text-Manipulation
__LBRACE2__ $json.name.toUpperCase() __RBRACE2__      // → "MAX MUSTERMANN"
__LBRACE2__ $json.email.split('@')[1] __RBRACE2__     // → "beispiel.de"

// Mathematik
__LBRACE2__ $json.price * 1.19 __RBRACE2__            // Preis + MwSt
__LBRACE2__ Math.round($json.amount) __RBRACE2__      // Runden

// Bedingungen (ternärer Operator)
__LBRACE2__ $json.status === 'active' ? 'Aktiv' : 'Inaktiv' __RBRACE2__

// Workflow-Info
__LBRACE2__ $workflow.name __RBRACE2__                // Name des Workflows
__LBRACE2__ $execution.id __RBRACE2__                 // Aktuelle Execution ID

Credentials speichern Zugangsdaten sicher und verschlüsselt. API-Keys, Passwörter und Tokens werden nie im Workflow selbst gespeichert.

Credential erstellen:

1. Node hinzufügen (z.B. Slack)
2. Bei "Credential" auf "Create New" klicken
3. Zugangsdaten eingeben (API Key, OAuth, etc.)
4. Speichern - wird verschlüsselt abgelegt

Workflows können fehlschlagen. Mit Error Handling reagierst du auf Fehler.

┌─────────────┐       ┌─────────────┐
│   Webhook   │──────▶│  HTTP Req   │──────▶ Erfolg ──▶ Slack
└─────────────┘       └─────────────┘
                            │
                            │ Error Output
                            ▼
                      ┌─────────────┐
                      │ Error Email │  ← Benachrichtigung bei Fehler
                      └─────────────┘

Error Workflow einrichten:

1. Node-Einstellungen öffnen (Zahnrad)
2. "Continue On Fail" aktivieren
3. Oder: Error Output mit separatem Pfad verbinden
4. Bei Fehler: Benachrichtigung senden oder loggen

Lass uns einen einfachen Workflow bauen: Webhook → Telegram Nachricht

Schritt 1: Trigger erstellen

1. Neuen Workflow erstellen
2. Klicke auf + und suche "Webhook"
3. HTTP Method: POST
4. Path: test-webhook

Schritt 2: Telegram Node

1. Klicke auf + und suche "Telegram"
2. Operation: Send Message
3. Credential erstellen (Bot Token von @BotFather)
4. Chat ID: Deine Chat ID
5. Text: {{ 'Neue Nachricht: ' + $json.message }}

Schritt 3: Testen

1. Klicke auf "Test Workflow"
2. Webhook URL wird angezeigt
3. Sende Test-Request:

curl -X POST https://n8n.deine-domain.de/webhook/test-webhook \
  -H "Content-Type: application/json" \
  -d '{"message": "Hallo von curl!"}'