Supressões

Pare de enviar para os endereços que prejudicam você.

Configure em:
Cursor

Cada bounce, reclamação e cancelamento de inscrição adiciona automaticamente o destinatário à sua lista de supressão, para que você não envie de novo para ele. A supressão é reversível, consultável pela API e se aplica a envios transacionais e de 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..."

A maior alavanca individual sobre a sua reputação.

A supressão está integrada na Bird Email API, não é uma lista que você mantém manualmente. Os provedores de caixa de entrada penalizam remetentes que continuam enviando para endereços inativos e armadilhas de spam; Esses envios são bloqueados automaticamente no momento em que um destinatário se torna inválido.

Cinco maneiras pelas quais a supressão protege você.

Automática, reversível e consultável.

  1. 01

    Automática em bounce + reclamação.

    Hard bounces, reclamações de spam e cancelamentos de inscrição suprimem o destinatário automaticamente. Sem necessidade de código.

  2. 02

    Reversível.

    Nada é permanente. Remova um endereço se ele se recuperar e volte a enviar para ele.

  3. 03

    Entradas manuais.

    Adicione endereços você mesmo: uma lista de endereços inválidos conhecidos que você está importando de outro provedor, por exemplo.

  4. 04

    Consultável via API.

    Liste tudo, filtre por endereço ou motivo, adicione uma entrada ou exclua uma pelo ID do registro, para que seus próprios sistemas permaneçam sincronizados.

  5. 05

    Uma lista, todos os envios.

    A supressão se aplica a email transacional e de marketing, para que uma campanha não possa reenviar para um endereço que um recibo acabou de sofrer bounce.

Automático por padrão, sob o seu controle.

Você nunca precisa tocar na lista para que ela funcione; bounces e reclamações são suprimidos automaticamente. Quando precisar, a lista inteira é uma API: adicione um endereço que você já sabe que é inválido, filtre por endereço ou motivo, ou exclua um registro para reativar um destinatário recuperado. A CLI do Bird cobre as consultas e remoções, e um agente acessa as mesmas duas operações via MCP.

suppressions.sh
bird CLI
# 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

Quatro motivos, dois escopos.

Nem toda supressão bloqueia todo envio. Um destinatário que cancelou a inscrição de marketing ainda recebe a redefinição de senha: reclamações e cancelamentos de inscrição têm escopo de marketing, enquanto hard bounces e adições manuais bloqueiam tudo.

MotivoAcionado porBloqueia
hard_bounceum bounce permanentetodo email (transacional + marketing)
complaintuma reclamação de spamsomente marketing
unsubscribeum cancelamento de inscrição por lista ou com um cliquesomente marketing
manualvocê, via API ou dashboardtodo email (transacional + marketing)

Aprofunde-se na documentação.

Leia como a supressão automática e manual funcionam no guia de supressões, e como ela se encaixa no panorama geral no guia de entregabilidade.

Cerca de 40% do e-mail comercial do mundo já roda na Bird.

Email transacional e de marketing em uma infraestrutura que operamos há uma década. A supressão é uma das capacidades da Bird Email API: envio, entregabilidade, IPs dedicados e analytics vêm junto.

Comece com um canal.
Adicione os outros quando estiver pronto.

Uma chave API de teste é sua imediatamente. A produção é desbloqueada quando você adiciona um método de pagamento e verifica um remetente.

Usa Claude Code, Cursor ou Codex? Copie um prompt de configuração e o seu agente instala o Bird CLI e as skills por si. Escolha o seu:

Cursor