Skip to content

7. Bounces, Suppression, Re-Opt-in ​

One-Click-Abmeldung und Präferenzen.

Ziel ​

Ihr versteht den Unterschied zwischen Hard- und Soft-Bounce, wie Dispatch Empfänger automatisch sperrt, wie sich Empfänger selbst abmelden, und wie ihr eine Sperre gezielt wieder aufhebt.

Voraussetzung ​

Ein eingerichteter Kanal (Kapitel 3).

Hard- und Soft-Bounce ​

  • Hard Bounce (SMTP-Fehlerklasse 5xx) — endgültiger Fehler, z. B. Adresse existiert nicht. Nur adressbezogene Codes (Adresse unbekannt oder Mailbox nicht verfügbar) lösen automatisch eine Suppression aus, andere dauerhafte Fehler (z. B. Absenderauthentifizierung beim Empfänger abgelehnt) sperren die Adresse nicht automatisch — hier lohnt ein Blick in Kapitel 3.
  • Soft Bounce (SMTP-Fehlerklasse 4xx) — vorübergehender Fehler, z. B. Postfach voll. Dispatch versucht automatisch erneut zuzustellen, es entsteht keine Suppression. Für den Warmup zählen Soft Bounces nicht als Bounce, sondern nur gegen die Zustellrate (Kapitel 6).
  • Held — noch gar nicht zugestellt, wartet auf freies Kontingent oder ein Empfänger-Gate (Kapitel 8). Kein Bounce, kein Fehler.

Suppression ​

Eine gesperrte Adresse bekommt keine weiteren Nachrichten in dem betroffenen Umfang. Drei Umfänge:

  • Gesamter Mandant — Adresse bekommt gar keine Nachrichten mehr von euch.
  • Stream / Liste — Adresse ist nur für einen bestimmten Stream gesperrt (z. B. den Newsletter), andere Streams (z. B. Transaktionsmails) sind nicht betroffen.
  • Einzelkampagne — historischer, nur noch lesbarer Umfang.

Verwaltung im Kundenbereich unter Suppression (Mandant): Liste ansehen, Eintrag anlegen, und über Sperre aufheben einen Eintrag entfernen — die Adresse kann sich danach erneut über euren regulären Anmeldeprozess eintragen (Double-Opt-in bleibt bei euch als Absender-Anwendung).

Präferenzen selbst bauen: Dispatch bietet keinen eigenen Präferenz-Center für eure Empfänger. Der Stream-Umfang ist aber genau der Baustein dafür — eure Anwendung kann für jeden Stream einzeln POST/DELETE /v1/suppressions aufrufen und so eine eigene Präferenzseite ("nur noch Angebote, kein Newsletter mehr") anbieten, ohne dass eine Abmeldung gleich den gesamten Mandanten betrifft.

One-Click-Abmeldung (RFC 8058) ​

Jede von Dispatch versendete Nachricht trägt automatisch die List-Unsubscribe-Header nach RFC 8058 — Empfänger-Postfächer (Gmail, Outlook u. a.) zeigen darüber eine eigene "Abmelden"-Schaltfläche, unabhängig von einem Abmeldelink im Mailtext selbst.

Klickt ein Empfänger darauf, ruft sein Mailprogramm POST /v1/unsubscribe/{token} auf (ein pro Nachricht eindeutiger Token, kein Login nötig). Dispatch legt daraufhin automatisch einen Suppression-Eintrag an (Umfang: der betroffene Stream, sonst gesamter Mandant) und löst den Webhook unsubscribe.created aus. Dispatch verschickt selbst keine Bestätigungsmail — falls ihr eine anzeigen wollt, übernimmt das eure Anwendung anhand des Webhooks.

Eigene Suppression-Verwaltung per API ​

  • POST /v1/suppressions — Adresse selbst sperren (z. B. nach einer Abmeldung außerhalb von Dispatch, etwa telefonisch).
  • DELETE /v1/suppressions — eigene Sperre aufheben (Re-Opt-in). Hebt ausschließlich eine zuvor über euch oder One-Click gesetzte Sperre auf, niemals eine globale, providerseitige Sperre.
  • POST /v1/suppression/check — vor dem Versand prüfen, ob eine Adresse gesperrt ist.

Ergebnis ​

Ihr könnt Bounces einordnen, Suppression verwalten und wisst, wie die automatische Abmeldung funktioniert. Weiter mit Kapitel 8 für Zustellstatus und Provider-Gates.

Host Universe Dispatch