收件人保护
示例记录
硬退信会抑制所有邮件。投诉会抑制非事务性邮件。退订偏好单独存储。
避免无效地址影响您的收件箱送达率。
反复向无效地址或将营销邮件标记为垃圾邮件的用户发信，会迅速损害您的域名在 Gmail、Outlook 和 Yahoo 的信誉。由于屏蔽功能内置于 Bird Email API，永久退信会自动阻止后续发送，垃圾邮件投诉会停止推广邮件，但不会拦截密码重置或订单确认。当客户询问邮件为何未送达时，您的支持团队可以将拒收追溯到触发它的具体邮件和退信诊断信息。
内置列表清理，无需编写自定义拦截列表代码。
自动保护您的发件人评分，保持事务邮件畅通，并与您的数据库保持同步。
- 01
针对硬退信和投诉的自动保护。
当地址发生硬退信或收件人举报垃圾邮件时，Bird 会立即记录屏蔽，并在重复发送离开平台前将其拦截。临时软退信和邮箱已满导致的延迟会正常重试，不会永久屏蔽该收件人。
- 02
事务邮件仍可送达已退订用户。
新闻通讯退订和垃圾邮件投诉会停止推广活动，但不会拦截事务邮件。退订营销公告的客户仍会收到密码重置、登录验证码和订单收据。
- 03
迁移时导入现有拦截列表。
通过控制台、API 或 CLI 导入您在 SendGrid、Amazon SES、Mailgun 或 Resend 中的现有屏蔽列表，从第一天起就不会再向已知无效地址发信。
- 04
安全地检查并清除已恢复的地址。
当收件人修复了配置错误的域名或 DNS 问题后，请先检查原始退信原因和来源邮件，再删除该记录。即使您清除了退信屏蔽，单独的退订偏好仍保持不变。
- 05
通过 Webhook 和 API 将变更同步到您的应用。
每当创建屏蔽时接收 Webhook 事件，或通过 REST API、SDK、CLI 和 MCP 按邮箱地址或原因查询和筛选记录，让您的 CRM 和内部工具反映最新的收件人状态。
通过 CLI 或 API 排查未送达邮件并管理您的拦截列表。
日常的退信和投诉保护自动运行，无需人工维护。当客户就未送达邮件联系支持，或您的团队从其他服务商迁移时，您可以通过 REST API、SDK 或 Bird CLI 查找地址、按退信或投诉原因筛选记录、添加已知无效地址，或删除已解决的退信。支持工具和 AI 编程助手还可以直接通过 Bird 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
Bird 如何区分投递拦截与营销退订。
永久退信和手动添加的拦截条目会同时阻止事务邮件和营销邮件。垃圾邮件投诉和退订偏好会拦截推广活动，但允许密码重置和收据等关键事务邮件通过。
| 原因 | 触发方式 | 拦截范围 |
|---|---|---|
| 硬退信 | 因地址无效或不存在而永久投递失败 | 拦截事务邮件和营销邮件 |
| 垃圾邮件投诉 | 收件人在邮箱中将邮件标记为垃圾邮件 | 拦截营销邮件；允许事务性收据和重置邮件 |
| 手动屏蔽 | 由您的团队通过控制台、API 或 CLI 添加 | 拦截事务邮件和营销邮件 |
关于邮件抑制的常见问题
哪些收件人会被自动抑制？
退订算是抑制吗？
我可以移除或测试屏蔽记录吗？
规模扩展， 不失控制。
Separate production and sandbox traffic into dedicated workspaces, scope API keys to the exact channels each service or agent needs, and track permission changes in the audit log.