Flow per Webhook starten
Der Auslöser Webhook startet einen Flow, wenn ein fremdes System eine Anfrage schickt. Damit binden Sie ApptiveGrid an beliebige andere Werkzeuge an.
Nicht mit ausgehenden Webhooks verwechseln
| Richtung | Wo eingerichtet |
|---|---|
| Fremdsystem → ApptiveGrid | Flow-Auslöser Webhook — diese Seite |
| ApptiveGrid → Fremdsystem | Webhooks in den Space-Einstellungen |
Einrichten
- Legen Sie einen neuen Flow an.
- Wählen Sie im Reiter Auslöser den Eintrag Webhook.
- Öffnen Sie den Schritt — dort steht die Adresse.
Der Abschnitt heißt Link zum Starten des Flows:
Um den Flow zu starten, senden Sie eine POST-Request an die folgende URL:
Daten übergeben
POST-Request senden
Senden Sie Daten im JSON-Format per POST-Request an den obigen Link, um den Flow zu starten.
Die übergebenen JSON-Daten stehen allen folgenden Schritten zur Verfügung. → Daten zwischen Schritten
In einem fremden System eintragen
Als Webhook verwenden
Tragen Sie die URL als Webhook bei anderen Services ein. Dadurch wird der Workflow automatisch gestartet, wenn der entsprechende Service den Webhook auslöst.
Praktisch überall dort, wo ein Dienst „Webhook-URL" abfragt — Formulardienste, Shopsysteme, Zahlungsanbieter, Automatisierungsplattformen, Überwachungswerkzeuge.
Testen
Webhook testen
Sie können den Webhook testen, indem Sie einen Beispiel-JSON-Payload senden:
Tragen Sie unter JSON-Payload Beispieldaten ein und klicken Sie Jetzt testen.
Mit echten Daten testen
Nehmen Sie als Beispiel-Payload möglichst genau das, was das fremde System tatsächlich schickt. Viele Dienste zeigen in ihrer Oberfläche ein Beispiel — kopieren Sie es hierher.
Sonst bauen Sie den Flow gegen eine ausgedachte Struktur und er scheitert beim ersten echten Aufruf.
Alternativ steht im Editor Mit Test-Daten starten zur Verfügung: Gib Beipiel-Daten an.
Sicherheit
Die Webhook-URL ist ein Zugang
Wer die Adresse kennt, kann den Flow starten — beliebig oft. Es gibt keine zusätzliche Prüfung, wer die Anfrage schickt.
Behandeln Sie sie wie ein Passwort:
- nicht in öffentliche Repositories
- nicht in Chats oder auf Folien
- nur im Zielsystem hinterlegen
Bedenken Sie, was der Flow tut
Ein Flow, der Einträge anlegt oder E-Mails verschickt, tut das bei jedem Aufruf. Gelangt die URL in falsche Hände oder ruft ein fehlerhaftes System sie wiederholt auf, entstehen entsprechend viele Vorgänge.
Prüfen Sie im Verlauf regelmäßig, ob die Anzahl der Ausführungen plausibel ist.
Alle aktiven Zugänge eines Space stehen unter Externe Links im Überblick — der Typ heißt dort Flow starten.
Nicht mehr benötigte Webhooks entfernen
Ein Webhook bleibt aktiv, solange der Flow existiert — auch wenn das anbindende System längst abgeschaltet ist. Gehen Sie die Links-Übersicht regelmäßig durch.
Typische Anwendungen
| Anwendung | Ablauf |
|---|---|
| Bestellung aus einem Shop übernehmen | Shop ruft Webhook, Flow legt Eintrag an |
| Formular eines Fremdanbieters verarbeiten | Dienst ruft Webhook, Flow verteilt die Daten |
| Störungsmeldung aus einem Überwachungssystem | System ruft Webhook, Flow benachrichtigt und protokolliert |
| Nächtlicher Import aus einem anderen System | Skript ruft Webhook mit Daten |
Keine zeitgesteuerte Auslösung
ApptiveGrid kennt keinen Auslöser „jeden Tag um 8 Uhr". Wollen Sie einen Flow regelmäßig starten, muss ein externes System die Webhook-URL zum gewünschten Zeitpunkt aufrufen.
Der Schritt Warten hilft dabei nicht: Er misst ab dem Erreichen des Schritts, nicht bis zu einem festen Zeitpunkt. → Router und Parallel