Warum wurde mein Webhook-Endpunkt deaktiviert?

Dieser Artikel erklärt, warum Emailit keine Events mehr an einen Webhook sendet, wie Sie den zugrunde liegenden Fehler finden und wie Sie verpasste Events nachholen.

Symptome

• Sie haben eine E-Mail von Emailit erhalten, dass Ihr Webhook fehlschlägt, und später eine, dass er deaktiviert wurde.
• Der Webhook wird unter Email API›Webhooks als deaktiviert angezeigt, und neue Events erreichen Ihren Endpunkt nicht mehr.
• Der Tab Requests auf der Seite des Webhooks listet Anfragen mit dem Status Failed und vielen Versuchen auf.

Ursache

Emailit wertet jede 2xx-Antwort als Erfolg. Alles andere zählt als Fehler, darunter:

• 4xx- oder 5xx-Statuscodes, etwa durch Signaturprüfungen oder Abstürze.
• Keine Antwort innerhalb von 30 Sekunden.
• Weiterleitungen. Emailit folgt 301 oder 302 nicht. Eine http://-URL, die auf https:// weiterleitet, oder ein fehlender abschließender Schrägstrich schlägt daher jedes Mal fehl.
• DNS-, TLS-Zertifikats- oder Verbindungsfehler.

Fehlgeschlagene Anfragen werden nach 5 Minuten, 30 Minuten, 2 Stunden, 5 Stunden und danach alle 12 Stunden wiederholt, bis zu 11 Versuche. Emailit benachrichtigt den Workspace-Inhaber per E-Mail, wenn eine Anfrage zum dritten Mal fehlschlägt. Schlägt der Endpunkt 3 Tage lang ohne erfolgreiche Zustellung weiter fehl, wird der Webhook deaktiviert und der Inhaber erhält eine weitere E-Mail.

Solange ein Webhook deaktiviert ist, werden keine neuen Events für ihn in die Warteschlange gestellt.

Lösung

1. Fehler finden. Öffnen Sie den Webhook und wählen Sie den Tab Requests. Öffnen Sie eine fehlgeschlagene Anfrage, um Failure reason, Status code und den Antwort-Body Ihres Endpunkts zu sehen.

2. Endpunkt korrigieren. Häufige Korrekturen:

   • Verwenden Sie die endgültige URL mit https:// und dem genauen Pfad, damit keine Weiterleitung stattfindet.
   • Geben Sie schnell 200 zurück und erledigen Sie langsame Arbeit in einem Hintergrundjob, damit Sie unter 30 Sekunden bleiben.
   • Korrigieren Sie die Signaturprüfung. Siehe Warum stimmt meine Webhook-Signatur nicht überein?.
   • Lassen Sie die Anfragen von Emailit durch Ihre Firewall, Ihre WAF oder Ihren Bot-Schutz.

3. Testen. Wählen Sie Send test, wählen Sie einen Event-Typ und prüfen Sie, ob der Dialog einen 2xx-Status zeigt.

4. Wieder aktivieren und erneut senden. Wählen Sie Retry failed. Damit werden alle fehlgeschlagenen Anfragen der letzten 7 Tage erneut in die Warteschlange gestellt und der Webhook wieder aktiviert. Sie können auch Enable webhook wählen oder Fehlgeschlagene Anfragen wiederholen aufrufen.

5. Events aus der deaktivierten Zeit nachholen. Events, die erstellt wurden, während der Webhook deaktiviert war, wurden nicht in die Warteschlange gestellt. Rufen Sie sie mit Events auflisten ab und filtern Sie nach type und created_at.

Machen Sie Ihren Handler robust, indem Sie ihn mithilfe des Felds event_id idempotent gestalten, denn ein wiederholter Batch kann zweimal ankommen. Siehe Wiederholungen und Fehlschläge.

Weiterhin Probleme?

Kontaktieren Sie den Support oder fragen Sie auf Discord und nennen Sie die Webhook-ID (wh_…) und den Fehlergrund vom Tab Requests.