Suppressions

Cessez d'envoyer aux adresses qui vous nuisent.

Configuré en :

Chaque rejet, plainte et désabonnement ajoute automatiquement le destinataire à votre liste de suppression, vous ne lui réécrivez donc pas. La suppression est réversible, interrogeable via l'API, et s'applique aux envois transactionnels comme marketing.

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

Le plus puissant levier sur votre réputation.

La suppression est intégrée à l<hub>API Email de Bird</hub>, et non une liste que vous maintenez à la main. Les fournisseurs de messagerie sanctionnent les expéditeurs qui continuent de viser des adresses mortes et déclenchent des plaintes de spam-traps ; Bird interrompt ces envois pour vous, automatiquement, dès quun destinataire devient problématique.

Cinq façons dont la suppression vous protège.

Automatique, réversible et interrogeable.

  1. 01

    Automatique en cas de rejet et de plainte.

    Les rejets définitifs, les plaintes pour spam et les désabonnements suppriment automatiquement le destinataire. Aucun code requis.

  2. 02

    Réversible.

    Rien n'est définitif. Retirez une adresse si elle redevient valide et reprenez l'envoi.

  3. 03

    Entrées manuelles.

    Ajoutez vous-même des adresses : par exemple une liste d'adresses défaillantes connues que vous importez depuis un autre fournisseur.

  4. 04

    Interrogeable via l'API.

    Listez, vérifiez, ajoutez et retirez des suppressions par programmation, pour que vos propres systèmes restent synchronisés.

  5. 05

    Une seule liste, tous les envois.

    La suppression s'applique aux e-mails transactionnels comme marketing, ainsi une campagne ne peut pas réécrire à une adresse qu'un reçu vient de faire rejeter.

Automatique par défaut, sous votre contrôle.

Vous n'avez jamais besoin de toucher à la liste pour qu'elle fonctionne ; les rejets et les plaintes la suppriment d'eux-mêmes. Mais quand vous en avez besoin, toute la liste est une API : ajoutez une adresse que vous savez déjà défaillante, recherchez-en une, ou réintégrez un destinataire redevenu valide.

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");

Quatre motifs, deux portées.

Toutes les suppressions ne bloquent pas tous les envois. Un destinataire désabonné du marketing reçoit quand même sa réinitialisation de mot de passe : les plaintes et les désabonnements se limitent au marketing, tandis que les rejets définitifs et les ajouts manuels bloquent tout.

MotifDéclenché parBloque
hard_bounceun rejet définitiftous les e-mails (transactionnels + marketing)
complaintune plainte pour spammarketing uniquement
unsubscribeun désabonnement via une liste ou en un clicmarketing uniquement
manualvous, via l'API ou le tableau de bordtous les e-mails (transactionnels + marketing)

Allez plus loin dans la documentation.

Découvrez le fonctionnement de la suppression automatique et manuelle dans le guide des suppressions, et comment elle s'inscrit dans la vue d'ensemble dans le guide de délivrabilité.

FAQ sur les suppressions

Qu'est-ce qui est supprimé automatiquement ?+
Les rejets définitifs, plaintes de spam et désabonnements. Dès qu'un destinataire déclenche l'un d'eux, Bird l'ajoute à votre liste de suppression et l'ignore lors des envois ultérieurs.
Puis-je retirer une adresse de la liste de suppression ?+
Oui, la suppression est réversible. Si une adresse redevient valide, retirez-la de la liste via le dashboard ou l'API et reprenez l'envoi.
Puis-je ajouter mes propres suppressions ?+
Oui. Ajoutez des adresses manuellement, par exemple une liste d'adresses défaillantes connues que vous importez, et elles seront ignorées exactement comme les entrées automatiques.
La suppression s'applique-t-elle à la fois aux e-mails transactionnels et marketing ?+
Les rejets définitifs et les entrées manuelles bloquent chaque envoi. Les plaintes et les désabonnements ont une portée marketing uniquement : ainsi, un message transactionnel comme une réinitialisation de mot de passe atteint encore une personne qui s'est désinscrite de vos campagnes.
Comment tester la suppression sans griller une vraie adresse ?+
Envoyez à l'adresse sandbox suppressed@messagebird.dev. Elle se comporte exactement comme si le destinataire figurait sur votre liste (rejet avec recipient_suppressed), sans rien écrire dans la liste, ce qui la rend réutilisable.

Environ 40 % des e-mails commerciaux mondiaux reposent déjà sur Bird.

E-mails transactionnels et marketing sur une infrastructure que nous exploitons depuis dix ans. La suppression est l'une des fonctionnalités de l'API Email de Bird : l'envoi, la délivrabilité, les IP dédiées et les analytics sont inclus.

Commencez avec un seul canal.
Ajoutez les autres quand vous êtes prêt.

Une clé API de test est disponible immédiatement. L'accès production se débloque dès que vous ajoutez un moyen de paiement et vérifiez un expéditeur.

Vous utilisez Claude Code, Cursor ou Codex ? Copiez un prompt de configuration et votre agent installe la CLI Bird et les compétences pour vous. Choisissez le vôtre :