抑制

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

开始使用阅读抑制指南

适用于：

CursorCopied!

每一次退信、投诉和退订都会自动将该收件人加入你的抑制列表，让你不再向其发信。抑制可撤销，可通过 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 中，无需手动维护列表。邮箱服务商会惩罚持续发送到无效地址和垃圾邮件投诉地址的发件人；当收件人地址失效的那一刻，这些发送会自动为您拦截。

抑制保护你的五种方式。

自动、可撤销、可查询。

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

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

无需手动操作，列表即可自动生效；退信和投诉会自动触发抑制。当您确实需要操作时，整个列表就是一个 API：添加已知的无效地址、按地址或原因筛选，或删除记录以恢复已修复的收件人。Bird CLI 支持读取和删除操作，AI 代理也可通过 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

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

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

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

在文档中深入了解。

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

Email 平台的其余功能

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

发送事务性和营销邮件、模板及批量发送。模板存储的、带版本控制的邮件模板，在发送时为每位收件人进行个性化处理。送达率身份验证、IP 预热、抑制以及按服务商维度的可见性。分析按邮箱服务商、域名和 IP 维度的投递与互动指标。专用 IP托管式专用 IP 和 IP 池，自动预热。发送域名自动生成 DNS 记录、DKIM 签名以及持续重新验证。群发营销活动：起草、定向受众、排期并发送。受众你的联系人，以及你从 broadcast 中定向的受众。Email API 概览完整的 Email API：发送、送达率、IP、抑制、分析和 broadcasts。

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

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

探索 Email 平台开始使用

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