Suppressies
Stop met mailen naar de adressen die je schaden.
Elke bounce, klacht en afmelding voegt de ontvanger automatisch toe aan je suppressielijst, zodat je ze niet opnieuw mailt. Suppressie is omkeerbaar, opvraagbaar via de API en geldt over transactionele en marketingverzendingen heen.
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.
De grootste hefboom op je reputatie.
Suppressie is ingebouwd in de Bird Email API, geen lijst die je handmatig bijhoudt. Mailboxproviders straffen afzenders die dode adressen en spamtrap-klachten blijven raken; Bird stopt die verzendingen voor je, automatisch, op het moment dat een ontvanger slecht wordt.
Vijf manieren waarop suppressie je beschermt.
Automatisch, omkeerbaar en opvraagbaar.
- 01
Automatisch bij bounce + klacht.
Hard bounces, spamklachten en uitschrijvingen onderdrukken de ontvanger automatisch. Geen code nodig.
- 02
Omkeerbaar.
Niets is definitief. Verwijder een adres als het herstelt, en hervat het verzenden ernaartoe.
- 03
Handmatige invoer.
Voeg zelf adressen toe: bijvoorbeeld een lijst met bekende slechte adressen die je importeert van een andere provider.
- 04
Opvraagbaar via API.
Lijst opvragen, controleren, toevoegen en verwijderen van suppressies kan programmatisch, zodat je eigen systemen gesynchroniseerd blijven.
- 05
Eén lijst, elke verzending.
Suppressie geldt over transactionele en marketingmail heen, zodat een campagne een adres dat zojuist een ontvangstbevestiging bouncede niet opnieuw kan mailen.
Standaard automatisch, volledig onder jouw controle.
Je hoeft de lijst nooit aan te raken om hem te laten werken; bounces en klachten onderdrukken vanzelf. Maar wanneer het nodig is, is de hele lijst een API: voeg een adres toe waarvan je al weet dat het slecht is, zoek er een op, of herstel een ontvanger die hersteld is.
// 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 redenen, twee scopes.
Niet elke onderdrukking blokkeert elke verzending. Een ontvanger die zich heeft uitgeschreven voor marketing krijgt nog steeds zijn wachtwoordreset: klachten en uitschrijvingen gelden alleen voor marketing, terwijl hard bounces en handmatige toevoegingen alles blokkeren.
| Reden | Geactiveerd door | Blokkeert |
|---|---|---|
| hard_bounce | een permanente bounce | alle mail (transactioneel + marketing) |
| complaint | een spamklacht | alleen marketing |
| unsubscribe | een afmelding via een lijst of met één klik | alleen marketing |
| manual | jij, via API of dashboard | alle mail (transactioneel + marketing) |
Verdiep je in de documentatie.
Lees hoe automatische en handmatige suppressie werken in de suppressiegids, en hoe het in het grotere geheel past in de deliverability-gids.
Suppressies FAQ
Wat wordt automatisch onderdrukt?+
Kan ik een adres van de suppressielijst verwijderen?+
Kan ik mijn eigen suppressies toevoegen?+
Geldt suppressie voor zowel transactionele als marketing-e-mail?+
Hoe test ik onderdrukking zonder een echt adres te verbranden?+
De rest van het Email-platform
Één API, één set keys. Verken de andere mogelijkheden.
Ongeveer 40% van 's werelds commerciële e-mail draait al op Bird.
Transactionele en marketingmail op infrastructuur die we al tien jaar draaien. Onderdrukking is één onderdeel van de Bird Email API: verzending, deliverability, dedicated IP's en analytics horen er allemaal bij.