Technik4 Min. Lesezeit
Einfachere E-Mail-Status
Wir haben die alten E-Mail-Status durch ein klareres und einheitlicheres System ersetzt. Hier erfahren Sie, was sich geändert hat und wie die neuen Status den bisherigen entsprechen.
GVonGeorge
E-Mail-Status sind einer der wichtigsten Bestandteile der API – sie zeigen Ihnen genau, wo sich eine E-Mail in ihrem Lebenszyklus befindet. Mit der Zeit ist unser ursprünglicher Satz an Status organisch gewachsen und unübersichtlich geworden: Was ist der Unterschied zwischen error und softfail? Ist held dasselbe wie pending? Wir haben beschlossen aufzuräumen.
Die neuen Status
Wir haben jetzt 12 eindeutige Status, jeder mit einer klaren Bedeutung und Farbe:
Status | Farbe | Beschreibung |
|---|---|---|
accepted | 🟡 | Zur Zustellung angenommen |
scheduled | 🟡 | Für eine spätere Zustellung geplant |
delivered | 🟢 | An den Mailserver des Empfängers zugestellt |
bounced | 🔴 | Dauerhaft fehlgeschlagen (Hard Bounce) |
attempted | 🟠 | Zustellung versucht, aber vorübergehend fehlgeschlagen |
failed | 🔴 | Zustellung aufgrund eines spezifischen Fehlers fehlgeschlagen |
rejected | 🔴 | Zunächst angenommen, dann abgelehnt |
loaded | 🔵 | E-Mail-Inhalt wurde geladen (Öffnungs-Tracking) |
clicked | 🟣 | Ein Link in der E-Mail wurde angeklickt |
suppressed | ⚪ | Empfänger steht auf der Sperrliste |
received | 🟢 | Eingehende E-Mail wurde angenommen |
complained | 🔴 | Eine Spam-Beschwerde wurde registriert |
Was sich gegenüber den alten Status geändert hat
Die alten Status sind abgekündigt. So werden sie den neuen zugeordnet:
Alter Status (abgekündigt) | Neuer Status |
|---|---|
|
|
|
|
| (entfernt) |
| (entfernt) |
|
|
|
|
|
|
|
|
| (entfernt) |
| (entfernt) |
Die umbenannten Status sind aussagekräftiger: loaded macht deutlich, dass wir das Laden des E-Mail-Inhalts verfolgen (nicht zwangsläufig das Öffnen durch einen Menschen), attempted ist weniger mehrdeutig als softfail, und bounced wird allgemein verstanden.
Rückwärtskompatibilität
Alle bestehenden E-Mails und ihre Zustellungen wurden auf die neuen Status migriert. Sie sehen in E-Mail- und Zustelldatensätzen keine alten Statusnamen mehr, unabhängig davon, wann sie erstellt wurden.
Der einzige Ort, an dem alte Statusnamen noch auftauchen können, sind bereits ausgelöste Events und Webhook-Anfragen, die vor dieser Änderung gesendet wurden. Diese historischen Payloads sind unveränderlich und behalten die ursprünglichen Statuswerte, mit denen sie erstellt wurden.
Falls Sie in Ihrem Code nach Statuswerten filtern oder auf sie prüfen, stellen Sie Ihre Integrationen auf die neuen Namen um.
