Supressões
Pare de enviar para os endereços que prejudicam você.
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.
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.
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.
- 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.
- 02
Reversível.
Nada é permanente. Remova um endereço se ele se recuperar e volte a enviar para ele.
- 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.
- 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.
- 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.
# 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.
| Motivo | Acionado por | Bloqueia |
|---|---|---|
| hard_bounce | um bounce permanente | todo email (transacional + marketing) |
| complaint | uma reclamação de spam | somente marketing |
| unsubscribe | um cancelamento de inscrição por lista ou com um clique | somente marketing |
| manual | você, via API ou dashboard | todo 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.
O resto da plataforma de Email
Uma API, um conjunto de chaves. Explore os outros recursos.
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.