Öffne zuerst Webhooks im Dashboard: Jede Zustellung zeigt die HTTP-Antwort oder den Fehler, den wir bekommen haben. Die meisten Probleme sind einer der folgenden Fälle.
Es wird gar nichts gesendet
Das Projekt hat keine Webhook-URL. Trag sie in den Projekteinstellungen ein; wir senden nur an die Adresse, die im Projekt gespeichert ist.
Zustellungen schlagen fehl
- Keine öffentliche https-Adresse. Reines http, lokale Adressen und private Netze werden abgelehnt.
- Weiterleitungen. Wir folgen ihnen nicht. Nutze die endgültige Adresse, inklusive des richtigen www und Schrägstrichs am Ende.
- Blockiert durch Firewall oder Bot-Schutz. Lass unsere POST-Anfragen auf diesem Pfad durch.
- Falsche Antwort. Nur ein 2xx-Status zählt. Antworte innerhalb weniger Sekunden und erledige langsame Arbeit danach.
- Dein Code stürzt ab. Sieh im Fehlerlog deines Servers zur Zeit der fehlgeschlagenen Zustellung nach.
Die Signatur passt nicht
- Nutze das Webhook-Signing-Secret, nicht das API-Secret.
- Berechne sie über den rohen Body, genau so wie er ankommt, vor jedem Parsen.
- Nachdem du ein neues Webhook-Secret erzeugt hast, aktualisiere deinen Server.
Wiederholungen und Warnungen
Fehlgeschlagene Zustellungen werden etwa zwei Tage lang wiederholt. Nach drei Fehlschlägen in Folge bei Live-Events erhält der Projektinhaber eine einzige E-Mail; nach der nächsten erfolgreichen Zustellung ist die Warnung wieder scharf.
Behoben?
Klicke unter Webhooks bei den fehlgeschlagenen Zustellungen auf Erneut senden oder auf der Projektseite auf test.ping senden, um den Endpunkt zu prüfen. Kommst du nicht weiter? Kontaktiere uns über die Kontaktseite mit der Zustellungs-ID.