Suppressies

Stop met mailen naar de adressen die je schaden.

Ingesteld in:

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.

welcome.tsx
200 · 1.2s
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..."

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.

  1. 01

    Automatisch bij bounce + klacht.

    Hard bounces, spamklachten en uitschrijvingen onderdrukken de ontvanger automatisch. Geen code nodig.

  2. 02

    Omkeerbaar.

    Niets is definitief. Verwijder een adres als het herstelt, en hervat het verzenden ernaartoe.

  3. 03

    Handmatige invoer.

    Voeg zelf adressen toe: bijvoorbeeld een lijst met bekende slechte adressen die je importeert van een andere provider.

  4. 04

    Opvraagbaar via API.

    Lijst opvragen, controleren, toevoegen en verwijderen van suppressies kan programmatisch, zodat je eigen systemen gesynchroniseerd blijven.

  5. 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.

suppressions.ts
200
// 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.

RedenGeactiveerd doorBlokkeert
hard_bounceeen permanente bouncealle mail (transactioneel + marketing)
complainteen spamklachtalleen marketing
unsubscribeeen afmelding via een lijst of met één klikalleen marketing
manualjij, via API of dashboardalle 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?+
Harde bounces, spamklachten en afmeldingen. Zodra een ontvanger een van deze veroorzaakt, voegt Bird ze toe aan je suppressielijst en slaat ze over bij toekomstige verzendingen.
Kan ik een adres van de suppressielijst verwijderen?+
Ja, onderdrukking is omkeerbaar. Als een adres herstelt, verwijder het dan via het dashboard of de API uit de lijst en hervat het verzenden ernaartoe.
Kan ik mijn eigen suppressies toevoegen?+
Ja. Voeg adressen handmatig toe, bijvoorbeeld een lijst met bekende slechte adressen die je importeert, en ze worden net als automatische vermeldingen overgeslagen.
Geldt suppressie voor zowel transactionele als marketing-e-mail?+
Hard bounces en handmatige invoeren blokkeren elke verzending. Klachten en afmeldingen gelden alleen voor marketing, dus een transactioneel bericht zoals een wachtwoordherstel bereikt nog steeds iemand die zich voor je campagnes heeft afgemeld.
Hoe test ik onderdrukking zonder een echt adres te verbranden?+
Stuur naar het sandbox-adres suppressed@messagebird.dev. Het reageert precies alsof de ontvanger op je lijst stond (geweigerd met recipient_suppressed), zonder iets naar de lijst te schrijven, dus het is herbruikbaar.

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.

Begin met één kanaal.
Voeg de rest toe wanneer je er klaar voor bent.

Een test-API-key is direct beschikbaar. Productietoegang wordt ontgrendeld zodra je een betaalmethode toevoegt en een afzender verifieert.

Gebruik je Claude Code, Cursor of Codex? Kopieer een setup-prompt en je agent installeert de Bird CLI en skills voor je. Kies de jouwe: