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 u handmatig bijhoudt. Mailboxproviders straffen afzenders die dode adressen en spamval-klachten blijven raken; die verzendingen worden automatisch voor u gestopt zodra een ontvanger ongeldig 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.
Bekijk de volledige lijst, filter op adres of reden, voeg een vermelding toe of verwijder er een op basis van het record-id, zodat uw 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.
U hoeft de lijst nooit aan te raken om hem te laten werken; bounces en klachten worden automatisch onderdrukt. Wanneer u dat wel nodig heeft, is de hele lijst een API: voeg een adres toe waarvan u al weet dat het ongeldig is, filter op adres of reden, of verwijder een record om een herstelde ontvanger opnieuw te activeren. De Bird CLI dekt het uitlezen en verwijderen, en een agent bereikt dezelfde twee via MCP.
# Look up why an address is on the list.
$ bird email suppressions list --email ada@example.com \
| jq -c '.data[] | {id, reason, applies_to}'
{"id":"sup_01krdgeqcxet5s7t44vh8rt9mg","reason":"hard_bounce",
"applies_to":"all"}
# Reinstate one that recovered, by record id.
$ bird email suppressions remove sup_01krdgeqcxet5s7t44vh8rt9mg --yes
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.
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.