Flow-Trigger: Webhook

Wann wird ein Webhook-Flow ausgelöst?

Sobald ein externes System eine HTTP-Anfrage mit Event-Daten an Keaz sendet. Diese Anfrage enthält einen strukturierten Payload — zum Beispiel eine Nutzer-ID, einen Event-Typ und die Details, die zum Ereignis gehören. Keaz liest den Payload und startet den Flow, den du für dieses Event definiert hast.

Der Ablauf:

1. Das externe System erkennt das Event.
2. Es sendet den Webhook an Keaz.
3. Keaz empfängt die Daten.
4. Der passende Flow startet.

Der Trigger ist vollständig eventbasiert und funktioniert unabhängig davon, ob der Kontakt gerade aktiv ist. Das Event kommt an, der Flow läuft.

Wie richte ich den Trigger ein?

1. Unter Flows einen Flow erstellen.
2. Den Block Starting point anklicken.
3. Rechts das Trigger Event Webhook auswählen.
4. Die Integration des externen Systems konfigurieren.
5. Speichern.

Schritt 4 unterscheidet sich je System, weil jedes Tool seine ausgehenden Webhooks anders beschreibt. Bei einer ungewöhnlichen Anbindung geht unser Support-Team das mit dir durch.

Welche Systeme und Events kann ich anbinden?

Jedes System, das eine HTTP-Anfrage senden kann — ein Shop, ein CRM, ein Payment-Anbieter, dein eigenes Backend. Weil du das Event selbst definierst, ist der Trigger nicht auf eine feste Liste beschränkt. Events, die Händler an uns senden:

• ein Kauf-Event oder ein Versandstatus-Update
• eine bestätigte oder fehlgeschlagene Zahlung
• ein Account, der in deinem System erstellt wurde
• ein Termin, der in deinem Buchungstool gebucht wurde
• eine Statusänderung oder ein Update in deinem CRM

So kommt auch ein Offline-Event auf WhatsApp. Was am Ladentisch, im Lager oder in einem Backoffice-Tool passiert, wird zur Nachricht — solange das System, das es kennt, einen Webhook senden kann.

Für Bestellungen aus einem verbundenen Shop brauchst du keinen Webhook — nimm dafür den Trigger Contact Purchase. Und für Reaktivierung auf Basis von Daten, die Keaz schon hat, gibt es Smart Activation. Webhook ist für die Events, die diese beiden nicht abdecken.

Was kann ich mit den Daten aus dem Webhook machen?

Der Payload ist nicht nur ein Startsignal, er ist Inhalt. Weil die Anfrage deine eigenen Felder mitbringt, kann die Nachricht benennen, was tatsächlich passiert ist — die Bestellung, die rausgegangen ist, der Termin, der gebucht wurde, die Zahlung, die fehlgeschlagen ist — statt eine allgemeine Benachrichtigung zu sein. Genau das lässt einen Webhook-Flow wie einen Teil deines Produkts wirken und nicht wie einen Newsletter.

Warum automatisieren statt manuell nachfassen?

• Die Nachricht geht raus, wenn das Event passiert — nicht, wenn jemand es bemerkt
• Manuelle Schritte verschwinden aus dem Prozess, statt nur verteilt zu werden
• Jede Business-Logik kann den Trigger steuern — derselbe Mechanismus skaliert von einem Use Case auf zwanzig
• Trigger bleiben präzise steuerbar, obwohl sie außerhalb von Keaz entstehen
• Online- und Offline-Events landen im selben Kanal

Was muss vorher eingerichtet sein?

1. Ein System, das beim Eintreten des Events eine HTTP-Anfrage senden kann und weiß, zu welchem Kontakt das Event gehört.
2. Der Kontakt existiert in Keaz und lässt sich dem Payload zuordnen.
3. Der Kontakt hat ein gültiges Opt-in. Ein Webhook belegt, dass ein Event passiert ist — nicht, dass du darüber schreiben darfst. Opt-in-Level erklärt, was auf welchem Level erlaubt ist, und WhatsApp-Opt-in DSGVO-konform einsammeln zeigt, wie du diese Einwilligung einholst.