抑制

停止向伤害你的地址发信。

适用于：

每一次退信、投诉和退订都会自动将该收件人加入你的抑制列表，让你不再向其发信。抑制可撤销，可通过 API 查询，并涵盖事务性和营销发送。

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

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

影响你声誉的最大单一杠杆。

抑制内建于 Bird Email API，而非你手动维护的列表。邮箱服务商会惩罚那些不断发往死地址并引发垃圾邮件陷阱投诉的发件人；Bird 会在收件人变坏的那一刻，自动为你停止这些发送。

抑制保护你的五种方式。

自动、可撤销、可查询。

01
退信 + 投诉时自动触发。
硬退信、垃圾邮件投诉和退订会自动抑制对应收件人。无需编写任何代码。
02
可撤销。
没有什么是永久的。如果某个地址恢复正常，可将其移除并恢复向其发信。
03
手动添加条目。
你也可以自行添加地址：比如从其他服务商导入的一份已知无效地址清单。
04
可通过 API 查询。
以编程方式列出、检查、添加和移除抑制项，让你自己的系统保持同步。
05
一份列表，覆盖每次发送。
抑制涵盖事务性和营销邮件，因此营销活动不会重新发往一个收据邮件刚刚退信的地址。

默认自动运行，掌控权在你手中。

无需你手动维护这份清单，它也能正常工作；退信和投诉会自行触发抑制。但在你需要时，整个清单都是一个 API：添加一个你已知无效的地址、查询某个地址，或恢复一个已恢复正常的收件人。

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

四种原因，两种作用范围。

并非每条抑制都会拦截每次发送。一个退订了营销邮件的收件人仍会收到密码重置邮件：投诉和退订仅作用于营销邮件，而硬退信和手动添加会拦截所有邮件。

原因	触发方式	拦截范围
hard_bounce	永久性退信	所有邮件（事务性 + 营销）
complaint	垃圾邮件投诉	仅营销邮件
unsubscribe	列表退订或一键退订	仅营销邮件
manual	由你通过 API 或仪表盘操作	所有邮件（事务性 + 营销）

在文档中深入了解。

在抑制指南中了解自动和手动抑制的工作原理，并在送达率指南中了解它如何融入全局。

抑制常见问题

哪些会被自动抑制？+

硬退信、垃圾邮件投诉和退订。一旦收件人触发其中之一，Bird 就会将其加入你的抑制列表，并在后续发送中跳过该地址。

我可以从抑制列表中移除某个地址吗？+

是的，抑制是可逆的。如果某个地址恢复正常，可通过 dashboard 或 API 将其从清单中移除，并恢复向其发信。

我可以添加自己的抑制项吗？+

可以。手动添加地址，例如你正在导入的一份已知无效清单，它们会像自动添加的条目一样被跳过。

抑制对事务性和营销邮件都适用吗？+

硬退信和手动添加会拦截所有发送。投诉和退订仅作用于营销邮件，因此像密码重置这样的事务性邮件，依然能送达那些已退出你营销活动的收件人。

如何测试抑制功能而不浪费一个真实地址？+

向沙盒地址 suppressed@messagebird.dev 发送邮件。它会完全像该收件人在你的清单中一样直接短路（以 recipient_suppressed 拒绝），且不会向清单写入任何内容，因此可以重复使用。

Email 平台的其余功能

一套 API，一组密钥。探索其他能力。

发送事务性和营销邮件、模板及批量发送。送达率身份验证、IP 预热、抑制和黑名单监控。分析按域名、按 ISP、按 IP 的送达与互动指标。专用 IP托管式专用 IP 和 IP 池，自动预热。发送域名域名验证、DKIM/SPF/DMARC 签名以及 DMARC 监控。群发营销活动：起草、定向受众、排期并发送。受众你的联系人，以及你从 broadcast 中定向的受众。Email API 概览完整的 Email API：发送、送达率、IP、抑制、分析和 broadcasts。

全球约 40% 的商业邮件已在 Bird 上运行。

在我们已运营十年的基础设施上发送事务性邮件和营销邮件。抑制只是 Bird Email API 的一项能力：发送、送达率、专用 IP 和分析功能一并提供。

探索 Email 平台开始使用

停止向 伤害你的地址发信。