Skip to content

13. Troubleshooting ​

Nach Symptom und API-Fehlercode.

Ziel ​

Ihr findet zu einem konkreten Symptom oder API-Fehlercode direkt die richtige Stelle im Handbuch.

Voraussetzung ​

Keine — dieses Kapitel ist zum gezielten Nachschlagen gedacht.

Nach HTTP-Status ​

StatusBedeutungWeiter mit
401API-Key fehlt, ist ungültig, abgelaufen oder widerrufenKapitel 4
404 (bei GET /v1/message/{id})Nachricht existiert nicht oder gehört einem anderen MandantenKapitel 4
409 dispatch_capacity_unavailableKein Kontingent frei, accept_hold=false gesetzt; retryable: trueKapitel 6
422Validierungsfehler — die Antwort nennt das betroffene FeldKapitel 4/5

Nach Nachrichtenstatus ​

Status + CodeBedeutungWer handelt
held + paced:tageskontingent / paced:zieldomain-anteilTageskontingent ausgeschöpftläuft automatisch weiter — Kapitel 6
held + gated:receiver-redEmpfänger-Gate rotihr, Fallback prüfen — Kapitel 8
held + transport_holdeigene Störung bei Host UniverseHost Universe, bereits informiert — Kapitel 8
deferredvorübergehender Zustellfehler (Soft Bounce), Empfängerserver versucht automatisch erneutkeine Aktion nötig — Kapitel 7
bounced + adressbezogener Code (z. B. Adresse unbekannt)Adresse wird automatisch gesperrtkeine Aktion nötig — Kapitel 7
bounced + Authentifizierungsfehler beim Empfängereigene SPF/DKIM/DMARC-Einrichtung prüfenihr — Kapitel 3
complainedEmpfänger hat "Als Spam melden" geklicktUrsache/Häufigkeit im Stream prüfen — Kapitel 5/7

Webhook kommt nicht an ​

  1. Antwortet euer Endpunkt mit 2xx innerhalb kurzer Zeit? Nur dann gilt die Zustellung als erfolgreich (Kapitel 10).
  2. Ist das Event in der Webhook-Konfiguration überhaupt abonniert?
  3. Nach einer Secret-Rotation: prüft sowohl X-Dispatch-Signature als auch — innerhalb der 7-Tage-Übergangsfrist — X-Dispatch-Signature-Previous (Kapitel 10).

Ergebnis ​

Ihr findet zu einem konkreten Fehler schnell die richtige Ursache und die passende Kapitelstelle für die Lösung.

Host Universe Dispatch