Trigger

Jeder Graph beginnt mit genau einem Trigger-Knoten. Ein Trigger führt selbst keine Logik aus, sondern entscheidet lediglich, wann der Rest des Graphen eine neue Ausführung erhält.

Kurzübersicht

1. Ziehen Sie einen Trigger-Knoten auf die Canvas; er ist der erste Knoten und hat keinen Eingangsverbinder.
2. Konfigurieren Sie ihn, falls er Felder benötigt (Rhythmus eines Zeitplans, ein zu überwachender Ordner).
3. Aktivieren Sie die Automatisierung, damit sie auf diesen Trigger zu hören beginnt.
4. Oder überspringen Sie das alles und drücken Sie jederzeit Test, um den Graphen einmalig unabhängig vom Trigger auszuführen.

Ausführliche Referenz

Manuell

Manueller Start hat keine Felder. Er wird vom Test-Button des Builders verwendet: Veröffentlichen Sie den aktuellen Entwurf, dann wird sofort eine Ausführung in die Warteschlange gestellt.

Geplant

Geplant feuert in einem von Ihnen festgelegten Rhythmus.

Feld	Optionen
Häufigkeit	Intervall, Täglich, Wöchentlich oder Cron
Alle (Minuten)	Nur im Intervall-Modus verwendet
Cron-Ausdruck	Nur im Cron-Modus verwendet; ein standardmäßiger 5-Feld-Ausdruck (Minute Stunde Tag des Monats Monat Tag der Woche), z. B. 0 9 * * 1-5 für Werktage um 09:00
Zeitzone	Nur im Cron-Modus verwendet; ein IANA-Name wie Europe/Istanbul. Bleibt das Feld leer, wird der Ausdruck mit der Server-Uhr abgeglichen

Eine aktive geplante Automatisierung wird im Hintergrund in einem wiederkehrenden Zyklus überprüft; Sie müssen die App nicht offen halten. Die Modi Intervall, Täglich und Wöchentlich feuern relativ zur letzten Feuerzeit der Automatisierung. Der Cron-Modus führt einen laufenden „nächste fällige“ Zeiger und holt eine versäumte Minute (bei einem Deploy, Neustart oder einem langsamen Takt) nach, indem er einmal feuert, sobald er sie bemerkt, anstatt sie stillschweigend zu verlieren; er feuert niemals zweimal für dasselbe versäumte Fenster.

Eingehender Webhook

Eingehender Webhook gibt jeder Automatisierung eine eindeutige eingehende URL, /api/workflow/hook/<Automations-ID>, die eine Ausführung startet, wenn sie mit einer GET- oder POST-Anfrage aufgerufen wird. Sie feuert nur, während der Status der Automatisierung „Aktiv“ ist.

Der Builder zeigt oder kopiert diese URL derzeit nicht für Sie; der Inspektor des Knotens hat nur das HMAC-Geheimnisfeld. Um sie zu nutzen, benötigen Sie (oder ein Entwickler in Ihrem Team) die ID der Automatisierung, die Sie aus den Netzwerkanfragen auslesen können, die die App bei geöffnetem Builder bereits tätigt, und kombinieren sie selbst mit dem festen Pfad /api/workflow/hook/.

Design- und Workspace-Ereignisse

Diese feuern, wenn an anderer Stelle in der App etwas passiert. Derzeit ist Design aktualisiert so verdrahtet, dass es automatisch feuert, wenn ein Design gespeichert wird. Die übrigen können jetzt konfiguriert werden; mehr eigene Aktionen der App werden mit ihnen verbunden, wenn diese Oberflächen ausgebaut werden.

Knoten	Feuert, wenn
Design erstellt	Ein neues Design erstellt wird
Design aktualisiert	Ein Design gespeichert wird
Design geteilt	Ein Design geteilt oder veröffentlicht wird
Design heruntergeladen	Ein Design heruntergeladen wird
Teil getaggt	Ein Tag zu einem Teil hinzugefügt wird (optional auf einen Tag gefiltert)
Marke angewendet	Ein Brand Kit auf ein Design angewendet wird
Asset hochgeladen	Eine Datei zur Medienbibliothek hinzugefügt wird
KI-Generierung abgeschlossen	Eine KI-Generierung abgeschlossen ist
Neue Arbeit im Ordner	Ein Projekt zu einem von Ihnen gewählten Ordner hinzugefügt wird

Die Ereignisbrücke

Jeder Trigger-Typ kann auch durch einen generischen, authentifizierten API-Aufruf gestartet werden, der auf Ihren Workspace beschränkt ist: ein triggerType und ein optionaler Payload. So feuert intern der oben genannte Design-Update-Hook, und es steht Ihnen für Ihre eigenen Integrationen zur Verfügung, um auf die gleiche Weise aufzurufen.

Mehrere Automatisierungen, ein Trigger-Typ

Mehr als eine aktive Automatisierung kann denselben Trigger-Typ verwenden. Wenn beispielsweise ein Design gespeichert wird, kann dies jede aktive „Design aktualisiert“-Automatisierung in Ihrem Workspace gleichzeitig starten, jede läuft unabhängig mit eigener Historie.

Wie Sie es verwenden

Schritt-für-Schritt-Anleitung: Ein Cron-Zeitplan für Wochenendmorgen

1. Ziehen Sie einen Geplant-Trigger auf einen leeren Graphen; er muss der einzige Trigger des Graphen sein.
2. Setzen Sie Häufigkeit auf Cron.
3. Geben Sie 0 9 * * 1-5 (09:00, Montag bis Freitag) in das Cron-Ausdrucksfeld ein.
4. Setzen Sie die Zeitzone auf Ihre eigene, z. B. Europe/Istanbul, damit 09:00 Ihren lokalen Morgen bedeutet statt der Server-Uhr.
5. Fügen Sie mindestens einen Aktionsknoten danach hinzu (ein nackter Trigger schlägt bei der Validierung fehl), dann Validieren und Aktivieren.
6. Die erste Aktivierung schaltet den nächsten fälligen Zeitpunkt des Zeitplans scharf, anstatt sofort zu feuern; von da an feuert er jeden passenden Morgen, ohne dass Sie ihn erneut berühren müssen.

Schritt-für-Schritt-Anleitung: Ein signaturgeprüfter Webhook

1. Ziehen Sie einen Eingehender Webhook-Trigger, füllen Sie eine lange zufällige Zeichenfolge als HMAC-Geheimnis ein und bewahren Sie eine Kopie an einem sicheren Ort auf; es gibt keine Möglichkeit, ein vergessenes Geheimnis nachträglich anzuzeigen, nur es durch ein neues zu überschreiben.
2. Fügen Sie mindestens eine Aktion danach hinzu, validieren Sie, dann aktivieren Sie; die eingehende URL akzeptiert nur Aufrufe, sobald der Status der Automatisierung „Aktiv“ ist.
3. Finden Sie die Automations-ID (siehe oben) und geben Sie dem sendenden System die URL /api/workflow/hook/<ID> mit der Anweisung, den rohen JSON-Anforderungstext mit Ihrem Geheimnis zu signieren und als X-Signature: sha256=<hex hmac> zu senden.
4. Wenn das sendende System eine „Testereignis senden“-Funktion hat, nutzen Sie sie; andernfalls senden Sie eine Anfrage von Hand und prüfen Sie die Aktivität-Ansicht auf eine neue Ausführung, anstatt auf ein echtes Ereignis zu warten.

Schritt-für-Schritt-Anleitung: Auslösen eines Triggers aus eigenem Code

1. Jeder Trigger-Typ kann über die generische Ereignisbrücke gestartet werden: ein authentifizierter POST an /api/workflow/events mit einem Body wie { "triggerType": "trigger.asset_uploaded", "payload": { "assetId": "..." } }.
2. Dies ist derselbe Pfad, den der interne Design aktualisiert-Hook der App verwendet, also ein bewährter Weg, um ein Ereignis anzubinden, das der eingebaute Editor noch nicht automatisch feuert.
3. Ein Aufruf feuert jede AKTIVE Automatisierung in Ihrem Workspace, deren Trigger diesem Typ entspricht; jede erhält eine eigene unabhängige Ausführung, die mit Ihrem Payload als Startkontext versehen wird.

Fehlerbehebung

• Das Ereignis meines Triggers ist eingetreten, aber es wurde keine Ausführung gestartet. Derzeit ist nur Design aktualisiert so verdrahtet, dass es automatisch aus der App selbst feuert. Die anderen Design- und Workspace-Ereignis-Trigger sind nach dem Feuern voll funktionsfähig, aber nichts in der App ruft sie derzeit auf, außerhalb Ihrer eigenen Integration über die Ereignisbrücke oben. Nutzen Sie Test, um den Graphen unabhängig vom Trigger auszuführen, während Sie auf diese Verdrahtung warten.
• Die Automatisierung ist Aktiv, aber ein Webhook-Aufruf erhält 404. Bestätigen Sie, dass der Status wirklich Aktiv ist, nicht Pausiert oder Entwurf, da nur eine aktive Automatisierung ihre Webhook-URL auflöst, und überprüfen Sie, ob die ID in der URL exakt ist.
• Ein Webhook-Aufruf erhält 401. Der Trigger hat ein HMAC-Geheimnis konfiguriert, und die Signatur des Aufrufs wurde entweder nicht gesendet oder stimmte nicht überein. Die Signatur wird über den exakten rohen Anforderungstext berechnet, daher wird eine Neuformatierung oder erneute Serialisierung des JSON vor dem Signieren die Prüfung auch dann zerstören, wenn der Inhalt identisch aussieht.
• Das Ereignis feuert, aber es startet nicht jedes Mal eine Ausführung. Überprüfen Sie die Einstellungen der Automatisierung auf ein Debounce-Fenster und das eigene Debounce-Feld des Trigger-Knotens (bei Ereignis-Triggern); eines von beiden verwirft stillschweigend ein Feuer, das in die Abkühlphase nach dem vorherigen fällt.
• Eine geplante Automatisierung wird zu bestimmten Stunden still. Überprüfen Sie die Einstellungen auf Ruhezeiten; ein Trigger, der andernfalls innerhalb dieses Fensters feuern würde (in der eigenen Zeitzone der Automatisierung), wird aufgeschoben, nicht verworfen oder in die Warteschlange gestellt, sodass er nach Ende des Fensters nicht nachträglich feuert.
• Zwei Automatisierungen teilen sich einen Trigger-Typ, und nur eine lief. Das ist zu erwarten, wenn nur eine Aktiv war oder wenn der eigene Tag-/Ordnerfilter des anderen auf dem Trigger-Knoten nicht auf dieses bestimmte Ereignis passte.

Tipps

Ein Trigger pro Graph

Die Validierung markiert einen Graphen mit null Triggern oder mit mehr als einem; behalten Sie genau einen.

Webhooks feuern nur im aktiven Zustand

Ein Aufruf eines eingehenden Webhooks bei einer pausierten Automatisierung oder einem Entwurf wird ignoriert. Aktivieren Sie sie zuerst.

Verwandte Themen

• Einen Workflow erstellen
• Knoten
• Ausführen und Überwachen