Sperrungen verwalten

Diese Anleitung behandelt alle Aufgaben rund um die Sperrliste: Einträge finden, einzeln oder aus einer CSV-Datei hinzufügen, exportieren, entfernen und die automatische Sperrung steuern. Wie Sperrungen funktionieren, erfahren Sie unter Sperrungen.

Voraussetzungen

• Jedes Mitglied des Workspaces kann die Liste in der Weboberfläche verwalten. Um die Einstellungen der automatischen Sperrung zu ändern, müssen Sie Admin sein.
• Verwenden Sie für die API einen API-Schlüssel mit Full Access.

Liste ansehen und filtern

curl -G https://api.emailit.com/v2/suppressions \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "type.exact=complaint" \
  --data-urlencode "limit=100"

Sperrung hinzufügen

curl https://api.emailit.com/v2/suppressions \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "type": "unsubscribe",
    "reason": "Opted out by phone",
    "keep_until": "2027-01-01T00:00:00Z"
  }'

CSV-Datei importieren

Nutzen Sie einen Import, um eine Sperrliste von einem anderen Anbieter zu übernehmen oder viele Adressen auf einmal hinzuzufügen.

1. Datei vorbereiten. Verwenden Sie eine .csv-Datei mit den Spalten email, type und reason:

   suppressions.csv

   email,type,reason
   ada@example.com,bounce,Hard bounce at previous provider
   grace@example.com,unsubscribe,Unsubscribed in 2025
   alan@example.com,,Requested removal

   • email ist erforderlich. type und reason sind optional.
   • Ein leerer oder unbekannter type wird zu recipient.
   • Die Kopfzeile ist optional. Ohne sie liest Emailit die Spalten in der Reihenfolge email, type, reason.
   • Die Datei muss kleiner als 8 MB sein und darf höchstens 10.000 Zeilen haben.

2. Datei hochladen. Wählen Sie unter Email API›Suppressions Import und wählen Sie dann die Datei aus oder ziehen Sie sie auf Select a file or drag it here.

3. Ergebnis prüfen. Emailit fügt neue Einträge hinzu und überspringt Adressen, die bereits eine Sperrung desselben Typs haben. Zeilen mit ungültigen E-Mail-Adressen werden übersprungen.

Bei mehr als 10.000 Adressen teilen Sie die Datei auf. Um aus Code zu importieren, rufen Sie Sperrung erstellen für jede Adresse auf.

Liste exportieren

1. Auswahl eingrenzen. Durchsuchen oder filtern Sie die Liste unter Email API›Suppressions nach Bedarf. Der Export enthält nur, was angezeigt wird.

2. Exportieren. Wählen Sie Export und dann im Popover erneut Export. Emailit lädt suppressions.csv herunter.

Die Datei hat die Spalten email, type, reason und created_at und enthält bis zu 10.000 Zeilen.

Sperrungen löschen

Wenn Sie eine Sperrung löschen, kann Emailit wieder an die Adresse senden. Stellen Sie sicher, dass die Adresse gültig ist und die Person Ihre E-Mails möchte, sonst kann der nächste Versand bouncen oder eine Beschwerde auslösen.

curl https://api.emailit.com/v2/suppressions/sup_4Lm8Qr2Tz6Wk \
  -X DELETE \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Automatische Sperrung konfigurieren

Emailit setzt Adressen, die bouncen oder Beschwerden auslösen, automatisch auf die Liste. Bei Pro und Business können Admins das ändern.

1. Einstellungen öffnen. Öffnen Sie Workspace›Settings und wählen Sie den Tab Suppressions.

2. Aktivieren oder deaktivieren. Verwenden Sie Enable automatic suppression.

3. Auswählen, was gesperrt wird. Wählen Sie unter Suppress on Bounces and Complaints (Standardwert), Bounces only oder Complaints only.

In den Tarifen Pay as you go und Custom ist die automatische Sperrung für Bounces und Beschwerden immer aktiv. Die Bedienelemente zeigen das Badge Pro und lassen sich nicht ändern. Mitglieder, die keine Admins sind, können die Einstellungen ansehen, aber nicht ändern. Wann genau Emailit eine Adresse sperrt, erfahren Sie unter Bounces und Beschwerden.

Gesperrte E-Mails erneut senden

Eine Nachricht, die durch eine Sperrung blockiert wurde, bleibt suppressed, auch nachdem Sie die Sperrung gelöscht haben. So senden Sie sie:

1. Sperrung löschen für die Adresse, wie oben beschrieben. Sonst wird auch das erneute Senden gesperrt.

2. E-Mail erneut senden. Öffnen Sie sie unter Email API›Emails und wählen Sie Retry oder rufen Sie E-Mail erneut senden auf.

Erneutes Senden erstellt eine neue E-Mail mit demselben Inhalt und einer neuen ID und kostet Credits wie jeder andere Versand. Sie können E-Mails erneut senden, die bis zu 30 Tage alt sind, solange ihr Inhalt noch innerhalb Ihres Zeitraums für die Datenaufbewahrung liegt.

Siehe auch