Externer Trigger
Zweck
Das External Trigger‑Element fungiert als Webhook und generiert eine eindeutige URL, die von externen Anwendungen aufgerufen werden kann, um einen Flow zu starten. Wenn eine HTTP-Anfrage an diese URL gesendet wird, wird automatisch eine neue Flow‑Ausführung gestartet.
Dies ist die primäre Methode zur Integration mit externen Systemen, die in Echtzeit Daten an die Plattform senden und eine Automatisierung auslösen müssen.
Anwendungsfälle:
Starten eines Flows, wenn eine neue Bestellung in einem externen E‑Commerce‑System wie Shopify oder Magento aufgegeben wird.
Auslösen eines Prozesses, wenn ein Formular auf deiner Website abgesendet wird.
Erstellen eines neuen Kontakts, wenn ein Lead in einem externen CRM erfasst wird.
Praktische Anwendungshinweise
Webhook, kein Standard‑Schritt: Dies ist ein Auslöser‑Element und muss das erste Element in einem Flow sein. Es kann nicht als Aktionsschritt verwendet werden.
Sicherheit: Der Auth‑Typ ist sicherer und wird für Produktionsumgebungen oder beim Umgang mit sensiblen Daten empfohlen. Der Token‑Typ ist praktisch für einfachere Integrationen oder für interne Dienste, die die vollständige URL schützen können.
Daten senden: Die externe Anwendung muss Daten als JSON‑Body einer HTTP‑POST‑Anfrage senden. Andere Methoden (wie GET) oder Datenformate (wie form‑urlencoded) werden von diesem Auslöser nicht unterstützt.
Testen: Du kannst Tools wie Postman oder Insomnia verwenden, um deinen External Trigger zu testen, indem du eine JSON‑Payload an die generierte URL sendest.
Konfigurationsoptionen
Die Konfiguration dieses Elements konzentriert sich auf die Einrichtung des sicheren URL‑Endpunkts.
Typ
Beschreibung: Die Authentifizierungsmethode, die für den Aufruf der Webhook‑URL erforderlich ist.
Token: Die URL enthält ein eindeutiges, geheimes Token. Diese Methode ist einfacher, da jeder mit der vollständigen URL den Flow auslösen kann. Du kannst mehrere vorkonfigurierte Tokens auswählen, um mehrere Auslöser‑URLs für einen einzigen Flow zu generieren.
Auth: Erfordert einen standardmäßigen Authentifizierungsprozess. Die externe Anwendung muss sich zuerst bei der API der Plattform anmelden, um ein temporäres Bearer‑Token zu erhalten, das dann im Header der Anfrage an die Webhook‑URL enthalten sein muss.
Eingabeformat: Auswahl aus der Dropdown‑Liste.
Beispielwert: Token
Token
Beschreibung: Wähle ein oder mehrere vorkonfigurierte Flow Tokens aus, um sichere Auslöser‑URLs zu generieren. Jedes ausgewählte Token erzeugt eine eindeutige URL. Dieses Feld erscheint nur, wenn der Typ Token ist.
Eingabeformat: Auswahl aus der Mehrfachauswahlliste.
Url
Beschreibung: Ein schreibgeschütztes Feld, das die generierte(n) Webhook‑URL(s) anzeigt, nachdem du den Auslösertyp konfiguriert hast. Dies ist die URL, die du dem externen System zur Verfügung stellen musst.
Eingabeformat: Schreibgeschützter Text.
Code
Beschreibung: Ein schreibgeschützter Code‑Block, der Beispiel‑PHP‑cURL‑Code bereitstellt, der zeigt, wie eine gültige HTTP‑Anfrage an die generierte Webhook‑URL gesendet wird. Der Beispielcode ändert sich je nach ausgewähltem Authentifizierungs‑Typ.
Eingabeformat: Schreibgeschützter Code‑Block.
Eingabe-/Ausgabe‑Erwartungen
Eingabe: Dieses Element ist ein Auslöser. Seine Eingabe ist der Body der HTTP‑POST‑Anfrage, die an die Webhook‑URL gesendet wird. Die Plattform erwartet, dass dieser Body im JSON‑Format vorliegt.
Ausgabe: Die JSON‑Daten aus dem Body der HTTP‑Anfrage werden zum anfänglichen Satz von Variablen, die in der Flow‑Ausführung verfügbar sind. Wenn beispielsweise ein externes System {"customer_id": 456, "product": "abc"} sendet, kannst du die Variablen {{customer_id}} und {{product}} sofort im nächsten Schritt verwenden.
War das hilfreich?