---
title: 抑制列表
description: BillionSend 不会再次发信的地址清单，用来保护你的发信信誉。
seo:
  title: 邮件抑制列表
ai:
  exclude: true
---

抑制列表保存不应再发邮件的地址，避免你反复给曾经退信或把你标记为垃圾邮件的地址发信。它保护你的信誉和你的 [发送限制](/docs/zh-hans/concepts/sending-limits)。在控制台的 **联系人 → 抑制列表** 中可以找到它。

## 地址如何进入列表

- **硬退信。** 接收服务器永久拒绝了该地址。软退信不计入。
- **投诉。** 收件人把一封邮件标记为垃圾邮件。
- **无效地址。** 深度 [名单验证](/docs/zh-hans/concepts/verification) 发现该地址没有对应的邮箱。
- **邮箱已满。** 联系人的邮箱两次报告已满，两次间隔 1 到 30 天。
- **手动添加。** 你在控制台中或通过 API 添加。

退信和投诉会自动添加。列表按团队划分，每个地址只有一条记录。它描述的是地址，而不是品牌：一个不存在的地址，无论你的哪个域名给它发信，都是同一个事实。

点击退订的收件人不会被加到这里。这种选择会记录为对退订链接所在邮件的发信域名的 [退订](/docs/zh-hans/concepts/unsubscribes)，只会停止营销邮件。抑制列表则会停止发往该地址的所有邮件，包括事务邮件。

## 它的作用

- **每一次发送** 都会跳过被抑制的收件人：`POST /emails`、SMTP 中继、订阅主题发送和群发都是如此。他们会从 `to`、`cc` 和 `bcc` 中移除。
- **如果所有收件人都被抑制，** 发送会被拒绝，返回 `422 all_recipients_suppressed`。SMTP 中继返回 `550`。当 `POST /emails` 的收件人因此被清空时，BillionSend 会保留一条状态为 `suppressed` 且没有内容的记录，它不计入你的发送量，并会发送 `email.suppressed` [Webhook](/docs/zh-hans/concepts/webhooks)。
- **在等待的邮件** 会在发出时再次检查，所以已定时的邮件会跳过在此期间被抑制的地址。
- **群发** 会跳过被抑制的联系人。

对列表的每一次变更，都会发送 `suppression.added` 或 `suppression.removed` Webhook。

## 查看与移除

控制台会列出每个地址，以及它的原因和日期。收件人的退订在单独的标签页中，每条都带有对应的域名。

你可以移除一个地址以恢复发送。只在确定原因已经解决时才这样做，例如一个邮箱一直存在，只是被配置错误的服务器拒收。该地址在下一次退信或投诉时会再次被抑制。

## API

SDK 把 `/suppressions` 接口作为 `suppressions.*` 调用。每条记录的格式是 `{ id, email, origin, source_id, created_at }`。`origin` 是 `bounce`、`complaint` 或 `manual`，`source_id` 是其退信或投诉产生了这条记录的那封邮件。

```bash
curl -X POST https://api.billionsend.com/suppressions \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "user@example.org" }'
```

- `GET /suppressions?origin=bounce` 列出记录，最新的在前，可以按来源筛选。
- `GET /suppressions/{id}` 和 `DELETE /suppressions/{id}` 接受记录 id 或邮箱地址。
- `POST /suppressions` 添加一个地址。可选的 `origin`（`bounce`、`complaint` 或 `manual`，默认 `manual`）可以让你把其他服务商的退信和投诉历史迁移过来。添加已在列表中的地址会返回它已有的记录。
- `POST /suppressions/batch/add`（带 `{ "emails": [...] }`）和 `POST /suppressions/batch/remove`（带 `{ "emails": [...] }` 或 `{ "ids": [...] }`）每次调用最多接受 1,000 个地址。

移除记录需要由所有者或管理员创建的密钥。参见 [团队角色](/docs/zh-hans/team-roles)。

如果某个地址的个人数据已被你擦除，它仍会阻止发送，但会从列表和按邮箱的查询中隐藏。仍然可以通过它的 id 访问，此时邮箱显示为 `"[erased]"`。

## Amazon SES 与你的团队

Amazon SES 为你的团队保存一份自己的抑制列表，与其他团队的列表相互独立：你的邮件产生的退信，不会阻止其他团队给同一个地址发邮件。SES 会自己把退信和投诉加入其中。你在这里移除一个地址，几秒钟后它也会在那里被移除。SES 因它的列表而拒绝的发送，会显示为永久退信，子类型为 `OnTenantSuppressionList`。

如果你的退信率或投诉率升得太高，SES 可能会暂停你的团队。所有者会收到一封邮件，其中附有 SES 给出的原因，你的邮件会被暂扣而不是失败，SES 重新启用发送后会发出。参见 [发送限制](/docs/zh-hans/concepts/sending-limits)。
