Nachrichtenstatus
| Status | Bedeutung | Credit |
|---|---|---|
| queued | Angenommen, wartet auf den Versand | reserviert |
| sending | Wird gerendert und an den Anbieter übergeben | reserviert |
| sent | Der Anbieter hat sie angenommen | verbraucht |
| delivered | Der Anbieter hat die Zustellung an den Server des Empfängers bestätigt (erfordert Webhooks) | verbraucht |
| bounced | Der Server des Empfängers hat sie abgelehnt; bei Hard Bounces landet die Adresse auf der Sperrliste | verbraucht |
| complained | Der Empfänger hat sie als Spam markiert; die Adresse wird gesperrt | verbraucht |
| failed | Dauerhafter Fehler, oder vorübergehende Fehler haben alle Wiederholungen aufgebraucht | erstattet (nicht, wenn ein eigener SMTP-Server die Nachricht womöglich schon erhalten hat oder wenn ungewöhnlich viele Sendungen der Organisation fehlschlagen) |
| held | Wartet in der Warteschlange zurückgehaltener E-Mails auf Credits | noch keiner |
| held_service_error | Wartet darauf, dass ein defekter E-Mail-Dienst repariert wird | erstattet, bei Freigabe erneut reserviert |
| discarded | Aus der Warteschlange entfernt – die Haltedauer ist abgelaufen oder jemand hat sie manuell verworfen | keiner |
Beim Senden liefert die API queued oder held. Alles Weitere sehen Sie über
getStatus() / GET /v1/messages/:id, im Verlauf oder über history() im Node-SDK.
Typische Abläufe
Abschnitt betitelt „Typische Abläufe“queued → sending → sent → deliveredqueued → sending → sent → bouncedqueued → sending → (Wiederholung …) → sentqueued → sending → (Umschaltung auf Ersatzdienst) → sentqueued → sending → failedheld → (Credits aufgeladen) → queued → sending → sentheld → (Haltedauer abgelaufen) → discardedqueued → sending → (Authentifizierungsfehler, kein Ersatzdienst) → held_service_error → (Dienst repariert) → queued → …Ereignisse im Zeitverlauf
Abschnitt betitelt „Ereignisse im Zeitverlauf“Jede Nachricht hat einen Zeitverlauf mit Ereignissen und Zeitstempeln. Die Detailansicht im Verlauf des Dashboards zeigt sie mit diesen Bezeichnungen:
| Ereignis | Bezeichnung im Verlauf | Bedeutung |
|---|---|---|
held |
Zurückgehalten | In der Warteschlange zurückgehaltener E-Mails gespeichert |
released |
Freigegeben | Aus der Warteschlange freigegeben |
queued |
In Warteschlange | Wartet auf den Versand |
sending |
Wird gesendet | An den Anbieter übergeben |
sent |
Gesendet | Der Anbieter hat sie angenommen |
failover |
Auf Ersatzdienst umgeschaltet | Der primäre Dienst ist ausgefallen, der Ersatzdienst wurde verwendet |
retry |
Neuer Versuch geplant | Vorübergehender Fehler, ein weiterer Versuch folgt |
auto_reply |
Automatische Antwort erstellt | Zu dieser Nachricht wurde eine automatische Antwort erstellt |
delivered |
Zugestellt | Zustellung per Webhook bestätigt |
bounced |
Unzustellbar | Hard Bounce (Status bounced) oder Soft Bounce (nur Ereignis, der Anbieter versucht es weiter) |
complained |
Als Spam markiert | Der Empfänger hat sich beschwert |
opened / clicked |
Geöffnet / Link angeklickt | Öffnungs- und Klick-Tracking des Anbieters |
failed |
Fehlgeschlagen | Dauerhafter Fehler |
refunded |
Credit erstattet | Der reservierte Credit ging an sein Guthaben zurück |
discarded |
Verworfen | Aus der Warteschlange entfernt |
opened und clicked sind Ereignisse, keine Status – eine zugestellte Nachricht, die geöffnet
wurde, bleibt delivered. Das Öffnungs-Tracking hängt vom Anbieter ab und davon, ob der Empfänger
Bilder lädt; betrachten Sie es daher als Schätzung.
Aufbewahrung
Abschnitt betitelt „Aufbewahrung“Nachrichten und ihr gerenderter Inhalt werden so lange aufbewahrt, wie es der Verlaufszeitraum des Tarifs vorsieht, mit dem sie gesendet wurden (7 bis 180 Tage, siehe Tarife), und danach gelöscht.