E-Mail-Status vereinfachen
E-Mail-Status sind einer der wichtigsten Bestandteile der API – sie zeigen Ihnen genau, wo sich eine E-Mail in ihrem Lebenszyklus befindet. Im Laufe der Zeit wuchs unser ursprünglicher Status-Satz organisch und wurde verwirrend: Was ist der Unterschied zwischen error und softfail? Ist held dasselbe wie pending? Wir haben beschlossen, das zu bereinigen.
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 zukünftige Zustellung geplant |
| delivered | 🟢 | An den Mail-Server 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 veraltet. So werden sie den neuen zugeordnet:
| Alter Status (veraltet) | Neuer Status |
|---|---|
pending | accepted oder scheduled |
sent | delivered |
held | (entfernt) |
hold_cancelled | (entfernt) |
softfail | attempted |
hardfail | bounced |
opened | loaded |
error | failed |
delayed | (entfernt) |
processed | (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 werden keine alten Status-Namen in E-Mail- oder Zustellungsdatensätzen sehen, unabhängig davon, wann sie erstellt wurden.
Der einzige Ort, an dem alte Status-Namen noch erscheinen 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 Status-Werte, mit denen sie erstellt wurden.
Falls Sie in Ihrem Code nach Status-Werten filtern oder diese abgleichen, aktualisieren Sie Ihre Integrationen, um die neuen Namen zu verwenden.
Blog
Die neuesten Nachrichten und Updates, direkt von Emailit.
Bleiben Sie auf dem Laufenden mit den neuesten Artikeln aus dem Emailit Blog.
