WorkspacesProductionSandbox
Delivery agent
API key · Customer operations teamALAlex Lee AdminPermissions updated
收件人保护
示例记录
硬退信会抑制所有邮件。投诉会抑制非事务性邮件。退订偏好单独存储。
抑制功能内置于 Bird Email API 中。硬退信记录会阻止向无效地址发送邮件,投诉记录会阻止非事务性邮件。您可以查看拒绝原因和触发消息,了解收件人被拒绝的原因。
自动、可撤销、可查询。
退信 + 投诉时自动触发。
硬退信和垃圾邮件投诉会自动创建抑制记录。退订请求显示在偏好设置中。
可撤销。
移除抑制前请先调查原因。其他阻止记录和退订偏好仍然有效。
手动添加条目。
你也可以自行添加地址:比如从其他服务商导入的一份已知无效地址清单。
可通过 API 查询。
查看完整列表、按地址或原因筛选、添加条目,或通过记录 ID 删除条目,让您的系统始终保持同步。
类别感知检查。
硬退信和手动抑制会阻止所有类别的邮件。投诉会阻止非事务性邮件。收件人的偏好会单独检查。
无需手动操作,列表即可自动生效;退信和投诉会自动触发抑制。当您确实需要操作时,整个列表就是一个 API:添加已知的无效地址、按地址或原因筛选,或删除记录以恢复已修复的收件人。Bird CLI 支持读取和删除操作,AI 代理也可通过 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
硬退信和手动条目会阻止所有邮件。投诉会阻止非事务性邮件。退订会创建单独的偏好记录;移除抑制不会清除该偏好。
| 原因 | 触发方式 | 拦截范围 |
|---|---|---|
| hard_bounce | 永久性退信 | 所有邮件(事务性 + 营销) |
| complaint | 垃圾邮件投诉 | 仅营销邮件 |
| manual | 由你通过 API 或仪表盘操作 | 所有邮件(事务性 + 营销) |
在工作区中组织团队,控制 API 访问权限,通过审计日志追踪变更。