Best Practices

Benennung, Modularisierung und Versionierung — Workflows wartbar halten.

Benennung

• Workflow: Lead – Webhook zu HubSpot
• Nodes: Normalisiere E-Mail, nicht Set1
• Credentials: HubSpot – Prod

In sechs Monaten weiß niemand mehr, was „Test final FINAL“ war.

Klein halten

Ein Workflow = eine Verantwortung. Lieber Sub-Workflows (Execute Workflow) als 80 Nodes auf einer Canvas.

Umgebungen

• Getrennte Credentials Dev/Prod
• Feature erst auf Staging aktivieren
• Production-URLs und Secrets nicht mischen

Dokumentation

• Sticky Notes auf dem Canvas für Nicht-Offensichtliches
• Kurzbeschreibung im Workflow
• Changelog in Commit/Export-Kommentar bei größeren Änderungen

Versionierung

• Regelmäßige Exports oder Git-Sync (je nach Setup)
• Vor riskanten Änderungen Kopie speichern
• Breaking Changes an Webhook-Consumern kommunizieren

Observability

• Executions regelmäßig spot-checken
• Alerts bei Error Workflow
• SLAs intern definieren („Lead innerhalb 2 Min in CRM“)

Als Nächstes: KI-Funktionen in n8n — ein Ausblick.