Supressões

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

Configure em:

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 é integrada à Email API da Bird, não uma lista que você mantém à mão. Os provedores de caixa de correio punem remetentes que continuam atingindo endereços mortos e reclamações de spam-traps; a Bird interrompe esses envios para você, automaticamente, no momento em que um destinatário se torna problemático.

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, verifique, adicione e remova supressões programaticamente, para que os seus próprios sistemas fiquem em sincronia.

  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 mexer na lista para que ela funcione; bounces e reclamações suprimem por conta própria. Mas, quando precisar, toda a lista é uma API: adicione um endereço que você já sabe ser inválido, consulte um endereço ou reative um destinatário que se recuperou.

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

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.

Perguntas frequentes sobre supressões

O que é suprimido automaticamente?+
Hard bounces, reclamações de spam e cancelamentos de inscrição. Assim que um destinatário aciona um desses, a Bird o adiciona à sua lista de supressão e o ignora em envios futuros.
Posso remover um endereço da lista de supressão?+
Sim, a supressão é reversível. Se um endereço se recuperar, remova-o da lista pelo dashboard ou pela API e volte a enviar para ele.
Posso adicionar minhas próprias supressões?+
Sim. Adicione endereços manualmente, por exemplo uma lista de endereços inválidos conhecidos que você está importando, e eles serão ignorados como as entradas automáticas.
A supressão se aplica tanto ao email transacional quanto ao de marketing?+
Hard bounces e entradas manuais bloqueiam todos os envios. Reclamações e cancelamentos têm escopo somente de marketing, então uma mensagem transacional como a redefinição de senha ainda chega a quem optou por sair das suas campanhas.
Como testo a supressão sem queimar um endereço real?+
Envie para o endereço de sandbox suppressed@messagebird.dev. Ele faz o curto-circuito exatamente como se o destinatário estivesse na sua lista (rejeitado com recipient_suppressed), sem gravar nada na lista, então é reutilizável.

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: