---
title: 抑制清單
description: BillionSend 不會再寄信的位址清單，用來保護你的寄件信譽。
seo:
  title: Email 抑制清單
ai:
  exclude: true
---

抑制清單收錄不應再寄信的位址，讓你不會一再寄給曾經退信或把你標為垃圾郵件的位址。它能保護你的信譽與你的[寄送限制](/docs/zh-hant/concepts/sending-limits)。在控制台的**聯絡人 → 抑制清單**可以找到它。

## 位址如何進入清單

- **硬退信。** 收件伺服器永久拒絕了這個位址。軟退信不算。
- **投訴。** 收件者把某封 Email 標記為垃圾郵件。
- **無效位址。** 深度[名單驗證](/docs/zh-hant/concepts/verification)發現那裡沒有任何信箱會回應。
- **信箱已滿。** 聯絡人的信箱在相隔 1 到 30 天的兩次寄送中都回報已滿。
- **手動。** 你在控制台或透過 API 加入的位址。

退信與投訴會自動加入。這份清單以團隊為單位，每個位址只有一筆。它描述的是位址本身，而不是某個品牌：不存在的位址，不管你哪個網域去寄，都是同一個事實。

收件者按下退訂時，不會被加到這裡。這個選擇會記錄成對該連結所在 Email 的網域的[退訂](/docs/zh-hant/concepts/unsubscribes)，並且只會停止行銷郵件。抑制清單則會停止寄給該位址的所有 Email，包含交易郵件。

## 作用

- **每一次傳送**都會略過被抑制的收件者：`POST /emails`、SMTP relay、訂閱主題寄送與群發都一樣。他們會從 `to`、`cc` 與 `bcc` 中移除。
- **所有收件者都被抑制時**，寄送會被拒絕，回傳 `422 all_recipients_suppressed`。SMTP relay 會回應 `550`。當 `POST /emails` 因此被清空時，BillionSend 會保留一筆狀態為 `suppressed`、沒有內容的記錄，它不計入你的用量，並會發出 `email.suppressed` [Webhook](/docs/zh-hant/concepts/webhooks)。
- **等待中的信件**在寄出時會再檢查一次，所以已排程的 Email 會略過這段期間才被抑制的位址。
- **群發**會略過被抑制的聯絡人。

清單的每次變更都會發出 `suppression.added` 或 `suppression.removed` Webhook。

## 檢視與移除

控制台會列出每個位址及其原因與日期。收件者的退訂則在另一個分頁，每一筆都附有網域。

你可以移除位址以恢復寄送。只有在確定原因已排除時才這樣做，例如信箱一直存在，卻被設定錯誤的伺服器拒收。該位址在下一次退信或投訴時，會再次被抑制。

## API

SDK 把 `/suppressions` 端點呼叫為 `suppressions.*`。每一筆為 `{ id, email, origin, source_id, created_at }`。`origin` 是 `bounce`、`complaint` 或 `manual`，`source_id` 則是因退信或投訴而建立這筆記錄的 Email。

```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` 列出記錄，最新的在前，可選擇依 origin 篩選。
- `GET /suppressions/{id}` 與 `DELETE /suppressions/{id}` 可以填記錄 id 或 Email 位址。
- `POST /suppressions` 新增位址。可選的 `origin`（`bounce`、`complaint` 或 `manual`，預設 `manual`）讓你把另一家服務商的退信與投訴歷史帶過來。新增已在清單上的位址時，會回傳既有的那一筆。
- `POST /suppressions/batch/add`（帶 `{ "emails": [...] }`）與 `POST /suppressions/batch/remove`（帶 `{ "emails": [...] }` 或 `{ "ids": [...] }`）每次呼叫最多可處理 1,000 個位址。

移除記錄需要由擁有者或管理員建立的金鑰。請見[團隊角色](/docs/zh-hant/team-roles)。

已清除個人資料的位址仍會繼續阻擋寄送，但會從清單與依 Email 的查詢中隱藏。它仍可用 id 取得，此時 Email 顯示為 `"[erased]"`。

## Amazon SES 與你的團隊

Amazon SES 為你的團隊保有獨立的抑制清單，與其他團隊的清單分開：你的信件退信，不會擋住其他團隊寄給同一位址的信。SES 會自行把退信與投訴加進去。你在這裡移除位址後，幾秒後也會從那裡移除。被 SES 因其清單而拒絕的寄送，會顯示為永久退信，子類型為 `OnTenantSuppressionList`。

如果你的退信率或投訴率攀升過高，SES 可能暫停你的團隊。擁有者會收到附有 SES 所述原因的通知信，你的信件會被擱置而不是失敗，等 SES 重新啟用寄送後就會寄出。請見[寄送限制](/docs/zh-hant/concepts/sending-limits)。
