# Warum wurde mein Webhook-Endpunkt deaktiviert?

> Emailit deaktiviert einen Webhook nach 3 Tagen ununterbrochener Zustellfehler. Finden Sie heraus, warum Zustellungen fehlgeschlagen sind, aktivieren Sie den Endpunkt wieder und senden Sie Events erneut.

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?](/de/docs/kb/webhook-signature-mismatch/).
   - 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](/de/docs/api-reference/webhooks/retry-failed/) 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](/de/docs/api-reference/events/list/) 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](/de/docs/webhooks/retries-and-failures/).

## Weiterhin Probleme?

[Kontaktieren Sie den Support](/contact/) oder fragen Sie auf [Discord](https://discord.emailit.com) und nennen Sie die Webhook-ID (`wh_…`) und den Fehlergrund vom Tab **Requests**.

---
Quelle: https://emailit.com/de/docs/kb/webhook-endpoint-disabled/