Zum Hauptinhalt springen

Webhook-Zustellungsprotokolle

FeedbackPulse bietet eine Webhook-Zustellungsprotokoll-UI, über die Mandanten ihre Webhook-Integrationen überwachen und debuggen können.


Auf Zustellungsprotokolle zugreifen

Navigieren Sie vom Mandanten-Dashboard aus zu /webhooks/logs, um alle Webhook-Zustellungsversuche anzuzeigen.


Protokoll-Liste

Jeder Protokolleintrag in der Liste zeigt die folgenden Informationen:

SpalteBeschreibung
EreignistypDas Webhook-Ereignis, das die Zustellung ausgelöst hat (z. B. submission.created)
URLDer Ziel-Endpunkt, an den die Payload gesendet wurde
HTTP-AntwortcodeDer vom Endpunkt zurückgegebene Antwort-Statuscode
Payload-VorschauEine gekürzte Vorschau der gesendeten Payload
ZeitstempelDatum und Uhrzeit des Zustellungsversuchs

Protokoll-Detailansicht

Klicken Sie auf einen Protokolleintrag, um die vollständigen Anfrage- und Antwortdetails unter /webhooks/logs/{id} anzuzeigen. Die Detailansicht enthält:

  • Vollständige Anfrage-Header und -Payload
  • Vollständige Antwort-Header und -Body
  • Antwortzeit und Status

Filterung

Filtern Sie die Zustellungsprotokoll-Liste anhand folgender Kriterien:

FilterOptionen
EreignistypEinen bestimmten Webhook-Ereignistyp auswählen
AntwortstatusErfolgreich (2xx) oder Fehlgeschlagen (Nicht-2xx und Timeouts)
DatumsbereichStart- und Enddatum für den Zeitraum

Integrationsprobleme debuggen

Die Zustellungsprotokolle sind darauf ausgelegt, Mandanten bei der Fehlerbehebung von Webhook-Integrationsproblemen zu helfen. Häufige Szenarien sind:

  • Nicht-2xx-Antwortcodes — zeigt an, dass der empfangende Endpunkt einen Fehler zurückgegeben hat
  • Timeout-Fehler — der Endpunkt hat nicht rechtzeitig geantwortet
  • Payload-Abweichungen — prüfen, ob die gesendete Payload mit dem entspricht, was der Endpunkt erwartet

Nächste Schritte