Was passiert, wenn Webhooks gesendet wurden, aber nicht zugestellt werden konnten? – URBANTZ | SUPPORT

Manchmal können Webhooks nicht an den konfigurierten Endpunkt zugestellt werden. Hier erfahren Sie, was dagegen getan werden kann. Wenn ein Webhook eingerichtet wird, erwartet man, dass Informationen basierend auf bestimmten Auslösern von Urbantz an ein anderes System gesendet werden. Aus verschiedenen Gründen kann der empfangende Endpunkt nicht verfügbar sein, und Webhooks können nicht empfangen und verarbeitet werden.

Zwei Optionen helfen dabei, die Auswirkungen einer Endpunkt-Nichtverfügbarkeit zu minimieren: E-Mail-Benachrichtigungen und der System Monitor. Dieser Artikel konzentriert sich auf die E-Mail-Option. Übersicht

Einrichtung
E-Mail-Inhalt
Webhook-Wiederholungsmechanismus
Webhook-Wiedergabe

1. Einrichtung

Bei der Einrichtung von Webhooks sehen Sie einen Schalter, der, wenn aktiviert, die Eingabe einer E-Mail-Adresse ermöglicht, an die Benachrichtigungen über Webhook-Fehler gesendet werden sollen.

Eine E-Mail wird gesendet, wenn wir nach einem ersten Versuch, einen Webhook zu senden, und zwei weiteren Wiederholungsversuchen den Webhook nicht erfolgreich zustellen konnten (= insgesamt 3 Versuche).
Um Spam an die E-Mail-Adresse zu vermeiden, werden E-Mails nicht in Echtzeit versendet. Wir bündeln die erhaltenen Rückmeldungen und senden alle 5 Minuten eine E-Mail (sofern innerhalb dieses 5-Minuten-Zeitraums erfolglose Versuche stattgefunden haben).

2. E-Mail-Inhalt

Die E-Mail enthält folgende Informationen:

Endpunkt: die URL, an die der Webhook gesendet werden sollte
Erfolglose Payloads (Anzahl): wie viele Payloads nicht erfolgreich gesendet werden konnten
Aufgetretene Fehler: Statuscodes und Fehlermeldungen, die uns vom Endpunkt zurückgegeben wurden
Anhang: die Payload(s) im JSON-Format

Dank dieser E-Mails können Sie die fehlenden Informationen in das zu aktualisierende System hochladen und das Problem beheben, mit dem der Endpunkt konfrontiert ist.

3. Webhook-Wiederholungsmechanismus

Wenn ein Webhook nicht gesendet werden kann, wiederholt unser System den Versuch automatisch bis zu 9 Mal. Nur Webhooks, die nach allen 9 Wiederholungsversuchen weiterhin fehlgeschlagen sind, werden auf unserer Seite gespeichert. Der letzte Wiederholungsversuch erfolgt 4 Stunden nach dem ersten Versuch. Es gibt kein striktes SLA für die Webhook-Zustellung.

4. Webhook-Wiedergabe

Wenn Webhooks in Ihrem System fehlschlagen und der Ausfall länger als das 4-stündige Wiederholungsfenster andauert, verbleiben diese Webhooks im Status „fehlgeschlagen" und werden nicht automatisch erneut gesendet.

Sie können jedoch eine Wiedergabe dieser Webhooks bei Urbantz anfordern, und unsere Teams werden sie für Sie erneut senden. Bitte beachten Sie Folgendes:

Dies ist eine kostenpflichtige Leistung. Um eine Anfrage einzureichen, wenden Sie sich bitte an unser Support-Team, das intern mit dem Engineering koordiniert. Sie müssen die erneut zu sendenden Daten klar angeben (zum Beispiel: fehlgeschlagene task-Update-Webhooks, die zwischen 13:00 und 17:00 Uhr MEZ gesendet wurden).

Wir empfehlen, so viele Details wie möglich anzugeben, um eine schnelle und präzise Wiedergabe sicherzustellen.