Zustellungen

Für Webhooks gibt es eine Zustellhistorie. In der WebApp sehen Sie diese auf der Detailseite eines Webhooks im Abschnitt „Deliveries“.

Statuswerte

• PENDING: Wartet auf Versand
• PROCESSING: Wird gerade versendet
• RETRY: Wird erneut versucht (nach einer Wartezeit)
• DONE: Erfolgreich zugestellt (HTTP 2xx)
• FAILED: Dauerhaft fehlgeschlagen

Retry-Verhalten

intraOnline versucht Zustellungen automatisch erneut, wenn ein Fehler wahrscheinlich vorübergehend ist. Das ist typischerweise der Fall bei:

• HTTP 429
• HTTP 5xx
• Netzwerkfehlern/Timeouts

In der Regel wird nicht erneut versucht bei:

• HTTP 4xx (außer 429)
• Konfigurations- oder Template-Fehler (z. B. ungültiges JSON im Template)

Es werden mehrere Versuche unternommen. Die Wartezeit steigt dabei mit jedem Versuch an. Nach mehreren erfolglosen Zustellungen wird endgültig abgebrochen.

Idempotenz / Deduplizierung

Durch Retries kann derselbe Webhook-Call mehrfach bei Ihnen ankommen. Implementieren Sie Ihren Empfänger daher idempotent.

Empfehlung:

• Nutzen Sie X-Event-Id als eindeutigen Schlüssel, um doppelte Zustellungen zu erkennen.

Aufbewahrung

Zustellungen werden automatisch nach einer gewissen Zeit bereinigt und nicht unbegrenzt aufbewahrt.

Typische Fehlerbilder

• HTTP 401/403: Authentifizierung/Token im Header fehlt oder ist ungültig
• HTTP 404: URL oder Pfad falsch
• HTTP 415: Content-Type wird vom Empfänger nicht akzeptiert
• Template/config error: Template nutzt nicht erlaubte Variablen oder rendert ungültiges JSON (bei JSON-Format)
• url host is not allowed / resolves to a private IP: Ziel-URL verstößt gegen die Sicherheitsprüfung (SSRF-Schutz)