Webhook Protokolle und Fehlerbehebung¶
Protokolle¶
Zammad zeigt einen Verlauf der letzten Webhook-Ereignisse, der Ihnen hilft, Interaktionen mit Diensten von Drittanbietern zu überwachen und zu beheben. Sie können diese unter Aktuellste Protokolle in den Webhook-Einstellungen finden.
Jeder Protokolleintrag enthält Details über die Webhook-Anfrage und -Antwort, so dass Sie Probleme beheben können. Wenn Sie auf einen Link klicken, wird ein Dialog mit den folgenden Informationen geöffnet:
Richtung: Immer
out, was auf ausgehende Anfragen von Zammad hinweist.URL: Die Ziel-URL, an die Zammad die Anfrage gesendet hat.
Methode: Immer
POST.Status: Der vom angesprochenen Server empfangene HTTP-Statuscode. Eine erfolgreiche Anfrage liefert einen
2xxCode.Anfrage: Zeigt die Header der HTTP-Anfrage und die Nutzdaten an, die Zammad gesendet hat.
Antwort: Zeigt die Header der Antwort des angesprochenen Servers an.
Erstellt am: Der Zeitstempel, zu dem Zammad die Anfrage gesendet hat.
Debuggen von Webhook-Problemen¶
Wenn ein Webhook fehlschlägt (z.B. einen 4xx oder 5xx Statuscode als Antwort erhält), überprüfen Sie die Anfrage- und Antwortdetails, um das Problem zu diagnostizieren. Häufige Ursachen sind falsche URLs, Authentifizierungsfehler oder serverseitige Fehler.
Bevor Sie Webhooks in der Produktion einsetzen, können Sie Testwerkzeuge verwenden, um Anfragen zu prüfen und zu debuggen. Wenn Sie dies tun, achten Sie darauf, dass Sie keine sensiblen oder persönlichen Daten enthalten sind.
Die folgenden Tools/Dienste könnten hilfreich sein:
Beeceptor: Ein kostenloses Tool, um Webhook-Anfragen in Echtzeit zu erfassen und zu überprüfen. Richten Sie einen temporären Endpunkt ein, um die Nutzdaten-Struktur und Header zu überprüfen.
Webhook.site: Eine weitere nützliche Alternative für die Protokollierung und das Debugging von Echtzeit-Anfragen.