Suppressions
Schluss mit dem Versand an Adressen, die dir schaden.
Jeder Bounce, jede Beschwerde und jede Abmeldung fügt den Empfänger automatisch deiner Suppression-Liste hinzu, damit du ihn nicht erneut anschreibst. Suppression ist reversibel, über die API abfragbar und gilt für transaktionale und Marketing-Sends.
import { BirdClient } from "@messagebird/sdk";
import { render } from "@react-email/render";
import { WelcomeEmail } from "./emails/welcome";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const { data, error } = await bird.email.send({
from: "Bird <hello@bird.com>",
to: ["ada@example.com"],
subject: "Your invite is ready",
html: await render(<WelcomeEmail name="Ada" />),
}).safe();
if (error) throw error;
console.log(data.id);
// → "em_2bX91Yk8h..."You can sign in any time at bird.com/login.
Your test API key is on your dashboard, ready to send.
Der größte Hebel für deine Reputation.
Suppression ist in die Bird Email-API eingebaut, keine Liste, die du von Hand pflegst. Mailbox-Provider bestrafen Sender, die immer wieder tote Adressen treffen und Spamtrap-Beschwerden auslösen; Bird stoppt diese Sends für dich, automatisch, sobald ein Empfänger schlecht wird.
Fünf Wege, wie Suppression dich schützt.
Automatisch, reversibel und abfragbar.
- 01
Automatisch bei Bounce + Beschwerde.
Hard Bounces, Spam-Beschwerden und Abmeldungen unterdrücken den Empfänger automatisch. Kein Code nötig.
- 02
Reversibel.
Nichts ist endgültig. Entferne eine Adresse, wenn sie sich erholt, und nimm den Versand wieder auf.
- 03
Manuelle Einträge.
Füge Adressen selbst hinzu: etwa eine bekannte Schlecht-Liste, die du von einem anderen Provider importierst.
- 04
Über die API abfragbar.
Liste Suppressions auf, prüfe sie, füge sie hinzu und entferne sie programmatisch, damit deine eigenen Systeme synchron bleiben.
- 05
Eine Liste, jeder Send.
Suppression gilt für transaktionale und Marketing-Mails, damit eine Kampagne keine Adresse erneut anschreibt, an die gerade eine Quittung gebounct ist.
Standardmäßig automatisch, von dir steuerbar.
Du musst die Liste nie anfassen, damit sie funktioniert; Bounces und Beschwerden unterdrücken von selbst. Aber wenn du es brauchst, ist die ganze Liste eine API: füge eine Adresse hinzu, von der du schon weißt, dass sie schlecht ist, schlage eine nach oder setze einen Empfänger wieder ein, der sich erholt hat.
// Suppress an address you already know is bad.
await bird.email.suppressions.create({ email: "ada@example.com" });
// Look up why an address is on the list.
const { data } = await bird.email.suppressions.list({
email: "ada@example.com",
});
// → [{ reason: "hard_bounce", applies_to: "all", created_at }]
// Reinstate one that recovered.
await bird.email.suppressions.remove("ada@example.com");Vier Gründe, zwei Geltungsbereiche.
Nicht jede Suppression blockiert jeden Send. Ein Empfänger, der sich vom Marketing abgemeldet hat, bekommt trotzdem sein Passwort-Reset: Beschwerden und Abmeldungen gelten nur fürs Marketing, während Hard Bounces und manuelle Einträge alles blockieren.
| Grund | Ausgelöst durch | Blockiert |
|---|---|---|
| hard_bounce | ein permanenter Bounce | alle Mails (transaktional + Marketing) |
| complaint | eine Spam-Beschwerde | nur Marketing |
| unsubscribe | eine Listen- oder One-Click-Abmeldung | nur Marketing |
| manual | du, per API oder Dashboard | alle Mails (transaktional + Marketing) |
Geh tiefer in die Docs.
Lies im Suppressions-Guide nach, wie automatische und manuelle Suppression funktionieren, und im Deliverability-Guide, wie sie ins größere Bild passt.
Suppressions-FAQ
Was wird automatisch unterdrückt?+
Kann ich eine Adresse von der Suppression-Liste entfernen?+
Kann ich eigene Suppressions hinzufügen?+
Gilt Suppression sowohl für transaktionale als auch für Marketing-Email?+
Wie teste ich Suppression, ohne eine echte Adresse zu verbrennen?+
Der Rest der Email-Plattform
Eine API, ein Satz Keys. Entdecke die anderen Funktionen.
Rund 40 % der kommerziellen Email weltweit laufen bereits über Bird.
Transaktionale und Marketing-Email auf einer Infrastruktur, die wir seit einem Jahrzehnt betreiben. Suppression ist eine Funktion der Bird Email-API: Versand, Deliverability, dedizierte IPs und Analytics kommen direkt mit.