Documentation Index
Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
Use this file to discover all available pages before exploring further.
Häufige Probleme und Lösungen
Workflow wird nicht ausgelöst
Symptome: Ihr Workflow wird nicht ausgeführt, wenn Sie es erwarten. Mögliche Ursachen:- Workflow nicht aktiviert: Stellen Sie sicher, dass der Workflow auf “Active” und nicht auf “Draft” gesetzt ist
- Trigger-Bedingungen nicht erfüllt: Überprüfen Sie, ob der Trigger Ihrem erwarteten Ereignis entspricht
- Feld nicht überwacht: Bei “Record is Updated”-Triggern stellen Sie sicher, dass das betreffende Feld überwacht wird
- Berechtigungen: Prüfen Sie, ob Sie die Berechtigung haben, Workflows auszuführen
- Überprüfen Sie den Workflow-Status in der Workflow-Liste
- Testen Sie mit der spezifischen Aktion, von der Sie erwarten, dass sie ihn auslöst
- Überprüfen Sie die Trigger-Konfiguration
- Wenden Sie sich wegen der Berechtigungen an Ihren Administrator
Workflow-Trigger zu früh (leere Felder)
Symptome: Beim manuellen Erstellen eines Datensatzes in der UI wird Ihr Workflow ausgelöst, bevor Sie alle Felder ausfüllen konnten. Der Workflow läuft mit überwiegend leeren Feldwerten. Warum das passiert: Twenty speichert alles in Echtzeit — es gibt keinen separaten “edit”- vs. “read”-Modus. Wenn Sie einen Datensatz erstellen, wird er sofort gespeichert und löst das Ereignis “Record is created” aus, bevor Sie weitere Felder ausfüllen können. Wann “Record is created” gut funktioniert:- Über API-Aufrufe erstellte Datensätze (Felder werden in einer einzigen Anfrage befüllt)
- Über Import erstellte Datensätze
- Automatisches Erstellen von Datensätzen aus anderen Workflows
- Der Workflow wird ausgelöst, nachdem der Benutzer das Ausfüllen und Speichern der Felder abgeschlossen hat
- Sie erhalten die vollständigen Daten statt leerer Werte
Fehlgeschlagene Aktionen
Symptome: Der Workflow wird ausgeführt, aber einige Aktionen schlagen fehl. Mögliche Ursachen:- Fehlende Daten: Erforderliche Felder sind leer
- Ungültige Verweise: Variablen aus vorherigen Schritten existieren nicht
- API-Fehler: Externe Dienste liefern Fehler zurück
- Berechtigungsprobleme: Die Aktion erfordert Berechtigungen, die Sie nicht haben
- Überprüfen Sie die Details der Workflow-Ausführung auf Fehlermeldungen
- Stellen Sie sicher, dass alle Pflichtfelder Werte haben
- Testen Sie die API-Verbindungen separat
- Überprüfen Sie die Rollenberechtigungen
Fehler bei HTTP-Anfragen
Symptome: HTTP-Request-Aktionen schlagen fehl oder liefern unerwartete Ergebnisse. Häufige Fehlercodes:- 400: Ungültige Anfrage - überprüfen Sie das Format des Request-Body
- 401: Nicht autorisiert - überprüfen Sie den API-Schlüssel
- 403: Verboten - überprüfen Sie die API-Berechtigungen
- 404: Nicht gefunden - überprüfen Sie die Endpunkt-URL
- 429: Zu viele Anfragen - implementieren Sie eine Ratenbegrenzung
- 500: Serverfehler - Problem mit dem externen Dienst
- Überprüfen Sie die API-Endpunkt-URL
- Überprüfen Sie die Authentifizierungs-Header
- Testen Sie den API-Aufruf zunächst außerhalb von Twenty
- Fügen Sie Fehlerbehandlung in Code-Aktionen hinzu
Fehler in Code-Aktionen
Symptome: JavaScript-Code wird nicht ausgeführt. Häufige Probleme:- Syntaxfehler: Tippfehler oder ungültiges JavaScript
- Undefinierte Variablen: Verweise auf Variablen, die nicht existieren
- Typfehler: Operationen auf falschen Datentypen
- Timeouts: Code benötigt zu lange zur Ausführung
- Verwenden Sie die integrierte Validierung des Code-Editors
- Testen Sie die Code-Logik zuerst in einer JavaScript-Konsole
- Fügen Sie console.log-Anweisungen zum Debuggen hinzu
- Vereinfachen Sie komplexe Operationen
E-Mail wird nicht gesendet
Symptome: Die Aktion “Send Email” liefert keine E-Mails aus. Mögliche Ursachen:- Kein E-Mail-Konto verbunden: Prüfen Sie Settings → Accounts
- Ungültige E-Mail-Adresse: Die E-Mail-Adresse des Empfängers ist fehlerhaft
- Sendelimits: Ratenbegrenzung des E-Mail-Anbieters erreicht
- Spamfilter: E-Mails werden blockiert
- Überprüfen Sie die Verbindung des E-Mail-Kontos
- Validieren Sie die E-Mail-Adressen der Empfänger
- Überprüfen Sie die Limits des E-Mail-Anbieters
- Überprüfen Sie den E-Mail-Inhalt auf Spam-Auslöser
Workflows debuggen
Workflow-Läufe verwenden
- Gehen Sie zum Workflow-Editor
- Öffnen Sie das Panel Runs
- Finden Sie den fehlgeschlagenen Lauf
- Klicken Sie, um die Details Schritt für Schritt zu sehen
- Überprüfen Sie Fehlermeldungen und Ausgabedaten
Einzelschritte testen
- Für Code-Aktionen verwenden Sie die Schaltfläche Test
- Für HTTP-Anfragen testen Sie den Endpunkt separat
- Erstellen Sie Testdatensätze, um Workflows auszulösen
- Verwenden Sie manuelle Trigger für kontrollierte Tests
Häufige Debugging-Muster
Logging hinzufügen: Verwenden Sie Code-Aktionen, um Zwischenwerte zum Debuggen zu protokollieren. Schritte isolieren: Testen Sie jeden Schritt unabhängig, um Fehler zu identifizieren. Datenfluss prüfen: Stellen Sie sicher, dass jeder Schritt die erwarteten Eingabedaten erhält.Bewährte Verfahren zur Vermeidung von Problemen
Vor der Aktivierung
- Testen Sie im Entwurfsmodus gründlich
- Validieren Sie alle API-Verbindungen
- Überprüfen Sie die Trigger-Bedingungen sorgfältig
- Dokumentieren Sie das erwartete Verhalten
Während der Entwicklung
- Verwenden Sie aussagekräftige Schrittnamen
- Fügen Sie Kommentare in Code-Aktionen hinzu
- Testen Sie mit realistischen Daten
- Planen Sie für Randfälle
Nach der Aktivierung
- Überwachen Sie die ersten Läufe genau
- Richten Sie Benachrichtigungen für Fehler ein
- Überprüfen Sie den Ausführungsverlauf regelmäßig
- Halten Sie Workflows nach Möglichkeit einfach