E-Mail-Unterdrückung

Der E-Mail-Kanal der Vonage Messages API verfügt über eine automatische Sperrfunktion, die standardmäßig für alle Kunden aktiviert ist. Die Sperrfunktion stellt sicher, dass E-Mail-Adressen, die als ungültig oder beschwerdeanfällig identifiziert wurden, in die Sperrliste aufgenommen werden und keine weiteren Nachrichten mehr an diese Adressen zugestellt werden. Jede blockierte Zustellung wird als Zustellereignis mit dem Fehlercode „abgelehnt“ gemeldet. 2003, wodurch Ihre Absenderreputation gewahrt bleibt und jedem Empfänger genaue Statusaktualisierungen bereitgestellt werden.

Warum Unterdrückung eine Rolle spielt

Das Versenden von E-Mails an ungültige oder beschwerdeanfällige Adressen schadet Ihrer Absenderreputation bei Internetdienstanbietern und E-Mail-Anbietern. Eine verschlechterte Reputation führt dazu, dass legitime E-Mails als Spam markiert oder gänzlich blockiert werden.

Die Unterdrückungsfunktion schützt davor, indem sie:

  • Verhindern, dass Zustellversuche an bekanntermaßen ungültige Adressen erfolgen, bevor sie die Internetdienstanbieter erreichen.
  • Automatische Erfassung neuer ungültiger Adressen, sobald diese durch Zustellrückmeldungen ermittelt werden.
  • So wird sichergestellt, dass Sie auch bei unterdrückten Empfängern weiterhin einen korrekten Zustellstatus erhalten und es nicht zu einem stillen Fehler kommt.

So funktioniert die Unterdrückung

Die Unterdrückung erfolgt in zwei Richtungen: Zum einen werden vor dem Versand die bestehenden Unterdrückungen überprüft, zum anderen werden auf Grundlage der Zustellrückmeldungen neue Adressen zur Unterdrückungsliste hinzugefügt.

Unterdrückung vor dem Senden überprüfen

Jedes Mal, wenn ein E-Mail-Versandauftrag eingeht, werden alle Empfänger (An, CC und BCC) anhand der Sperrliste überprüft, bevor die E-Mail an den Provider übermittelt wird. Dies geschieht automatisch, ohne dass eine Konfiguration des Accounts erforderlich ist.

Es gibt drei mögliche Ergebnisse:

Szenario A – Es werden keine Empfänger ausgeblendet

Alle Empfänger sind korrekt angegeben. Die E-Mail wird wie gewohnt versendet, und Sie erhalten eine ID-Meldung des Anbieters, die den Versand bestätigt.

Szenario B – Einige Empfänger werden ausgeblendet (teilweise Ausblendung)

Ein oder mehrere Empfänger stehen auf der Sperrliste, aber mindestens einer ist nicht gesperrt.

  • Die unterdrückten Empfänger werden aus der Zustellung entfernt.
  • Die E-Mail wird an die verbleibenden aktiven Empfänger gesendet.
  • Für jeden gesperrten Empfänger wird ein Unterdrückungsereignis veröffentlicht — mit Fehlercode abgelehnt 2003 — so sehen Sie für jeden Empfänger den genauen Zustellstatus, auch für diejenigen, an die keine Sendung verschickt wurde.
  • Sie erhalten dieselbe Anbieter-Nachrichten-ID, die sowohl die gesendeten als auch die unterdrückten Empfänger umfasst.

Szenario C – Alle Empfänger werden ausgeblendet

Alle Empfänger in den Feldern „An“, „CC“ und „BCC“ stehen auf der Unterdrückungsliste.

  • Die E-Mail wird nicht versendet.
  • Für jeden Empfänger wird ein Unterdrückungsereignis veröffentlicht — mit Fehlercode abgelehnt 2003.
  • Sie erhalten eine gültige Anbieter-Nachrichten-ID, die von einer echten Sendung nicht zu unterscheiden ist, sodass Ihre Systeme die Nachricht wie gewohnt nachverfolgen können.

Adressen zur Sperrliste hinzufügen

Der E-Mail-Anbieter sendet Zustellungsrückmeldungen (Bounces und Beschwerden) an die Vonage-E-Mail-Engine zurück. Diese Ereignisse werden verarbeitet, um die Sperrliste auf dem neuesten Stand zu halten.

Zu welcher Art von Sperrliste eine Adresse hinzugefügt wird, hängt von dem eingegangenen Ereignis ab:

Art der Veranstaltung Umfang der Unterdrückung Zur Unterdrückungsliste hinzugefügt
Hard Bounce Weltweit Ja
Beschwerde / SPAM-Meldung Pro Account + Identität Ja
Sonstige Beanstandungen (Virenerkennung, Korrekturen bei Nicht-Spam, DKIM-Fehler) K.A. Nein

Übersicht über die Unterdrückungsarten

Die folgende Tabelle ordnet die Zustellungsrückmeldungen der Anbieter den Fehlercodes der Vonage Messages API zu und gibt an, ob das Ereignis zu einer Unterdrückung führt.

Sprungart Vonage-Fehlercode Beschreibung Status Fehlercode Zur Unterdrückungsliste hinzugefügt
Hard Bounce RECIPIENT_BLOCKED Die Adresse steht auf der Sperrliste der Plattform. Abgelehnt 2003 Ja (global)
Hard Bounce RECIPIENT_MISSING Die E-Mail-Adresse existiert nicht Abgelehnt 1170 Ja (global)
Hard Bounce ACCOUNT_BLOCKED Die Adresse steht auf der Sperrliste dieses Accounts. Abgelehnt 2003 Ja (global)
Weicher Bounce MAILBOX_FULL Das Postfach des Empfängers ist vorübergehend voll Abgelehnt 1180 Nein
Weicher Bounce CONTENT_TOO_LARGE Die Nachricht war zu groß, um übermittelt zu werden Abgelehnt 2002 Nein
Weicher Bounce ATTACHMENT_REJECTED Der Anhang wurde vom empfangenden Server abgelehnt Abgelehnt 1382 Nein
Weicher Bounce GATEWAY_TIMEOUT Zeitüberschreitung bei der Übertragung – Warten auf den empfangenden Server Abgelehnt 1230 Nein
Weicher Bounce CONTENT_REJECTED Der Inhalt wurde vom empfangenden Server abgelehnt Abgelehnt 1282 Nein
Hard Bounce UNKNOWN Nicht klassifizierter Bounce Abgelehnt 1330 Ja (global)
Beschwerde USER_SPAM_REPORT Der Empfänger hat die E-Mail als Spam markiert Nicht gesendet K.A. Ja (pro Account + Identität)
Beschwerde OTHER_FEEDBACK Allgemeines Feedback zu Beschwerden Abgelehnt - Ja (pro Account + Identität)
Beschwerde FRAUD_ALERT E-Mail als möglicher Betrugsversuch markiert Abgelehnt 2001 Nein
Beschwerde AUTH_FAILURE DKIM / Problem mit der E-Mail-Authentifizierung Abgelehnt 1484 Nein
Beschwerde NOT_SPAM_CORRECTION Der Empfänger hat eine falsche Einstufung als Spam korrigiert K.A. K.A. Nein
Beschwerde VIRUS_DETECTED E-Mail wurde als virenbehaftet markiert Abgelehnt 1282 Nein

Anmerkung: Vonage sendet abgelehnte Ereignisse stets mit einem Fehlercode an Ihren Webhook. 2003 für jeden unterdrückten E-Mail-Versand.

Zustellstatus für aus dem Verteiler entfernte Empfänger

Wenn ein Empfänger unterdrückt wird, generiert die E-Mail-Engine ein synthetisches Bounce- oder Beschwerde-Ereignis, das dem Format eines echten Provider-Ereignisses entspricht. Das bedeutet:

  • Nachgelagerte Systeme (beispielsweise der E-Mail-Konnektor und Webhooks) erhalten für jeden Empfänger eine korrekt formatierte Statusmeldung, unabhängig davon, ob die E-Mail tatsächlich gesendet wurde oder nicht.
  • Sie können den gesamten Verlauf jeder Nachricht nachverfolgen, ohne dass für unterdrückte Fälle besondere Maßnahmen erforderlich sind.