抑制名单与退订

抑制名单记录的是不能再接收邮件的地址。每封邮件发送前，都会把每个收件人与它比对。被抑制的收件人会被拒绝：HTTP API 会在 rejected 中返回它，SMTP 则响应 550 5.7.1 Recipient is on a suppression list。被抑制的收件人不计入你的额度。

#抑制范围

每条记录还有一个原因：

#分类

一条记录可以作用于所有邮件，也可以只作用于某个分类。收件人如果从一封分类为 newsletter 的邮件中退订，就不会再收到该发信流的 newsletter 邮件，但仍会收到 order 等其他分类的邮件。没有分类的记录会拦截发往该地址的所有邮件。

#在控制台管理名单

打开发信流，进入 抑制名单 标签页。这里会列出账号级和发信流级的记录，包括 范围、原因、类别（全部 表示所有分类）和时间。你可以按邮箱、原因和范围筛选。

全局记录只有在搜索完整邮箱地址时才会列出，并标记为 只读。

添加地址：

1. 点击 添加，打开 添加到抑制名单。
2. 填写地址，每行一个，每次最多 1,000 个。
3. 在 范围 中选择 本流 或 整个账号。
4. 如有需要，展开 高级，在 仅拦截该类别 中填写分类。
5. 点击 确定。

要移除某条记录，点击该行的 移除 并确认。移除后即可再次向该地址发信。

你也可以通过抑制名单 API 管理发信流级记录。

#营销发信流的退订

营销发信流始终带有可用的退订方式，且无法关闭。

#通信地址

营销发信流通过 HTTP API 发信之前，必须在 营销设置 标签页填写 发件人实体地址，即你公司的实际地址。未填写前，API 会以 postal_address_required 拒绝邮件，概览 标签页也会显示提醒。

#每封营销邮件会添加的内容

这两个邮件头都在 DKIM 签名范围内。Gmail、Outlook 等邮件应用会据此显示自带的退订按钮，收件人一键即可退订。

#退订页面

页脚链接会打开一个页面，显示收件人的地址（如果邮件有分类，也会显示分类），以及 确认退订 / Unsubscribe 按钮。仅打开链接并不会退订，因此邮件过滤器中的链接扫描器不会误把收件人退订。收件人必须点击按钮。

退订之后：

• 该地址会以 unsubscribe 原因和邮件的分类加入发信流的抑制名单。如果邮件没有分类，该发信流发往这个地址的所有邮件都会被拦截。
• 邮件的 unsubscribed_at 会被设置，并发送一个 unsubscribed Webhook 事件。

#营销邮件的分类

在 营销设置 标签页的 邮件类别 中，可以列出你的邮件分类：点击 添加类别，填写代码（字母、数字、.、_、-）和 显示名称，然后点击 保存。每封邮件都带上对应的 category（HTTP API）或 X-Yeap-Category 邮件头（SMTP），这样收件人就能只退订某一类邮件，继续接收其他邮件。

同一标签页还有 打开追踪 和 点击追踪 开关，用于设置未指定 track_opens 或 track_clicks 的邮件的默认行为。

#交易发信流

交易发信流不会添加退订邮件头或页脚，因为密码重置、收据这类邮件是收件人必须收到的。交易发信流只用于收件人在使用你的服务过程中预期会收到的邮件。新闻通讯和促销邮件应使用营销发信流。

#相关文档

• SMTP 与 HTTP API
• 事件与 Webhook
• 限额、沙箱与合规