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 é 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.
- 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, verifique, adicione e remova supressões programaticamente, para que os seus próprios sistemas fiquem em sincronia.
- 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.
// 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.
| 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.
Perguntas frequentes sobre supressões
O que é suprimido automaticamente?+
Posso remover um endereço da lista de supressão?+
Posso adicionar minhas próprias supressões?+
A supressão se aplica tanto ao email transacional quanto ao de marketing?+
Como testo a supressão sem queimar um endereço real?+
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.