FlowModels

Webhooks von FlowModels einrichten

Veröffentlicht am 11. November 2026

Mit Webhooks meldet dir FlowModels Ereignisse von selbst, statt dass deine Anwendung ständig nachfragen muss. Typische Fälle sind eine im Hintergrund fertig gewordene Antwort oder eine Guthabenwarnung. Wir schicken dazu eine signierte Anfrage an eine Adresse deiner Wahl.

Webhook anlegen

  1. Öffne im Dashboard den Punkt Webhooks.
  2. Klicke auf Webhook anlegen.
  3. Trage unter Adresse die URL deines Empfängers ein. Sie muss über https erreichbar sein und darf nicht auf ein internes Ziel zeigen.
  4. Wähle unter Ereignisse mindestens ein Ereignis aus.
  5. Optional: Gib eine Beschreibung ein, damit du später weißt, wofür die Adresse da ist.
  6. Klicke auf Speichern.

Direkt danach zeigen wir dir Dein Signatur-Secret. Kopiere es sofort und hinterlege es in deiner Anwendung, denn es wird genau einmal angezeigt. Schließe das Fenster mit Habe ich kopiert. Pro Team sind bis zu 10 Adressen möglich.

Die Ereignisse

  • response.completed, response.failed, response.cancelled, response.incomplete: Eine im Hintergrund gestartete Antwort ist fertig, fehlgeschlagen, abgebrochen oder unvollständig beendet.
  • credit.threshold: Eine deiner Warnschwellen wurde erreicht.
  • credit.topup_failed: Eine automatische Aufladung ist fehlgeschlagen.
  • webhook_endpoint.deactivated: Eine Webhook-Adresse wurde nach wiederholten Fehlschlägen abgeschaltet.
  • webhook.test: Eine Testzustellung, die du selbst auslöst.

Zustellungen prüfen

Jede Zustellung trägt die Header webhook-id, webhook-timestamp und webhook-signature. Mit deinem Signatur-Secret prüft deine Anwendung, dass die Nachricht wirklich von uns kommt und unterwegs nicht verändert wurde. Wie die Prüfung genau funktioniert, steht in Webhook-Signatur prüfen.

Die Webhook-Liste

In der Liste siehst du zu jeder Adresse die Ereignisse, den Status, die Fehlschläge in Folge und die Letzte Zustellung. Rechts unter Aktionen findest du:

  • Zustellprotokoll öffnen: alle Zustellungen an diese Adresse
  • Testzustellung senden: schickt ein webhook.test-Ereignis, ideal nach dem Einrichten
  • Webhook bearbeiten: Adresse, Ereignisse und Beschreibung ändern
  • Secret rotieren: neues Secret erzeugen
  • Webhook deaktivieren und Webhook reaktivieren
  • Webhook löschen: entfernt die Adresse mit ihrem Zustellprotokoll endgültig

Die Webhook-Liste mit Adresse, Ereignissen, Status und den Aktionen

Das Zustellprotokoll

Das Zustellprotokoll zeigt jede Zustellung mit Zeit, Kennung, Ereignis, Status, Anzahl der Versuche, dem HTTP-Code deines Servers und dem Abschluss. Die übertragenen Inhalte zeigt das Protokoll bewusst nicht.

Das Zustellprotokoll eines Webhooks mit zugestellten und einer fehlgeschlagenen Zustellung

Antwortet dein Server nicht mit einem Erfolgscode, versuchen wir es erneut, mit wachsenden Abständen von etwa einer Minute bis zu einer Stunde und insgesamt bis zu fünfmal. Die Status bedeuten:

  • Offen: Die Zustellung wartet noch.
  • Zugestellt: Dein Server hat erfolgreich geantwortet.
  • Fehlgeschlagen: Der letzte Versuch ging schief, ein weiterer Versuch folgt.
  • Aufgegeben: Alle Versuche sind gescheitert.

Secret rotieren

Klicke auf Secret rotieren und bestätige. Du bekommst ein neues Secret angezeigt, wieder nur einmal. Das bisherige Secret signiert noch 24 Stunden lang mit, sodass du die Umstellung ohne verlorene Zustellung ausrollen kannst. In der Liste steht so lange Altes Secret gültig bis …. Hast du das neue Secret überall eingetragen, kannst du mit Rotation abschließen das alte sofort ungültig machen.

Wenn etwas nicht klappt

  • Deaktiviert, „Automatisch nach mehreren Fehlschlägen deaktiviert“: Nach fünf endgültig gescheiterten Zustellungen in Folge schalten wir die Adresse ab und informieren dich. Behebe das Problem auf deinem Server, klicke auf Webhook reaktivieren und schicke eine Testzustellung.
  • Maximum erreicht: Bei 10 Adressen ist Schluss. Lösche eine Adresse, die du nicht mehr brauchst.
  • Adresse wird abgelehnt: Prüfe, ob sie mit https:// beginnt und öffentlich erreichbar ist.

War dieser Artikel hilfreich?

Zurück zu Webhooks, Endnutzer & MCP