---
title: 退訂與品牌
description: 退訂依寄件網域各自記錄，因此每個品牌都有自己的名單、退訂頁面與連結主機。
seo:
  title: 依網域設定的一鍵退訂
ai:
  exclude: true
---

退訂的意思是「不要再寄行銷郵件給我」。BillionSend 會把它記錄在帶有該連結的 Email 所屬的寄件網域上，所以擁有多個品牌的團隊，名單不會混在一起。離開某個品牌的人，仍會收到其他品牌的信。

交易郵件（沒有帶[訂閱主題](/docs/zh-hant/concepts/topics)，也不屬於[群發](/docs/zh-hant/concepts/broadcasts)的郵件）永遠不受退訂影響。

## 三種範圍

| 範圍 | 由誰設定 | 停止什麼 |
| --- | --- | --- |
| 網域 | 收件者，使用退訂連結或其郵件用戶端的一鍵按鈕 | 寄出該封 Email 的網域所寄的行銷郵件 |
| 整個團隊 | 你，把聯絡人的 `unsubscribed` 設為 `true`（API、控制台或 CSV 匯入） | 團隊所有網域的行銷郵件 |
| 訂閱主題 | 收件者，在退訂頁面上 | 帶有該[訂閱主題](/docs/zh-hant/concepts/topics)的郵件 |

收件者自己的退訂，永遠不會改動聯絡人的 `unsubscribed` 旗標。它會以該網域的一筆記錄儲存，並以 Email 位址作為索引，所以刪除再重新匯入聯絡人後，這筆記錄仍然有效。

群發與訂閱主題寄送，會略過已退出該寄件網域、整個團隊或該訂閱主題的收件者。以這種方式被攔下的單封 Email，最後狀態是 `suppressed`，原因為 `domain_unsubscribed`、`contact_unsubscribed` 或 `topic_unsubscribed`。

退訂不等於[抑制](/docs/zh-hant/concepts/suppressions)。抑制清單收錄的是曾退信、投訴或由你封鎖的位址，會停止所有 Email，交易郵件也包含在內。退訂只會停止行銷郵件。

## 退訂頁面

每封群發與訂閱主題的 Email，都帶有一鍵退訂的 `List-Unsubscribe` 標頭（RFC 8058），以及一個連到託管退訂頁面的連結。在內文中放入 `{{{UNSUBSCRIBE_URL}}}`，它就會變成每位收件者各自的同一個連結。頁面會以收件者的瀏覽器語言開啟（共 14 種語言，備用語言為英文）。除了退出該網域的所有行銷郵件，收件者也可以個別開關各個訂閱主題。

誤按的收件者，可以在確認頁面按**重新訂閱**。它只會復原該連結造成的退訂。開啟連結的郵件掃描器，永遠不會讓任何人重新訂閱。當你自己設定 `unsubscribed: true` 時，頁面上不會有重新訂閱按鈕。

### 每個網域有自己的外觀

頁面的外觀會與寄出該封 Email 的網域一致。每個網域可以設定：

- 品牌名稱、標誌與標誌的圓角，
- 背景、文字與強調色，
- 按鈕上方的文字，以及儲存選擇後顯示的文字，
- 退訂後要開啟的重新導向 URL，用來取代頁面上的訊息。

在控制台中，打開網域並使用**品牌**分頁，它會預覽結果。你留空的欄位會依序退回團隊的**品牌預設值**（設定），再退回 BillionSend 的簡潔外觀。頁面只會顯示屬於該網域的內容：它絕不會提到團隊的其他網域，而且只列出綁定到該網域的訂閱主題，以及沒有綁定網域的訂閱主題。

透過 API，則在 `PATCH /domains/{id}` 的 `unsubscribe_page` 中傳送這些欄位。`null` 會清除欄位。標誌在控制台上傳，在 API 中是唯讀。

```sh
curl -X PATCH "https://api.billionsend.com/domains/$DOMAIN_ID" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{
    "unsubscribe_page": {
      "brand_name": "Acme",
      "message": "Sorry to see you go. Unsubscribe from Acme emails?",
      "success_message": "You are unsubscribed from Acme.",
      "accent_color": "#0a7d5a",
      "logo_radius": "rounded"
    }
  }'
```

在 Email 之外產生的連結，例如 `POST /contacts/{id}/preferences-link` 傳回的連結，會開啟團隊的預設頁面，在那裡退訂會讓聯絡人退出所有網域。

### 你自己的退訂子網域

預設情況下，連結會在 BillionSend 的主機上開啟。想在你自己的網域上開啟，請在網域的**連結**分頁為它設定退訂子網域，或對 `POST /domains` 或 `PATCH /domains/{id}` 使用 `unsubscribe_subdomain`（標籤，例如用 `unsubscribe` 代表 `unsubscribe.yourdomain.com`；`null` 會清除）。它的運作方式與追蹤子網域相同，請見[網域](/docs/zh-hant/concepts/domains)。

1. 新增網域的 **DNS** 分頁顯示的 CNAME，指向 `cname.billiondns.com`，並設為僅限 DNS（Cloudflare 上的灰雲）。
2. CNAME 解析後會自動核發憑證，通常在幾分鐘內完成。`unsubscribe_status` 會從 `pending` 變成 `active`，沒有成功時，`unsubscribe_error` 會說明原因。
3. 之後新寄出的信件會在連結與 `List-Unsubscribe` 標頭中使用你的主機。在啟用之前，以及出現 `failed` 結果（72 小時內未啟用）之後，會使用共用主機。

已經寄出的連結會保留寄出時的主機，所以你之後移除 CNAME，它就會失效。你的子網域只會開啟它自己網域的連結，其他任何連結都會回應 `404`。

追蹤與退訂可以共用同一個標籤，但分開命名更安全：廣告封鎖器會封鎖追蹤主機，共用同一個名稱會讓退訂連結一起被封鎖。

## 讀取與變更退訂

`GET /contacts/{id}` 會回傳 `unsubscribed`（團隊層級的旗標）與 `unsubscribed_domains`。在控制台中，聯絡人的頁面會列出兩者，也能讓你移除某個網域的退訂。聯絡人下的**退訂**分頁會列出所有記錄。

```sh
# 列出，最新的在前。domain_id 可縮小到單一網域。
curl "https://api.billionsend.com/unsubscribes?domain_id=$DOMAIN_ID" \
  -H "Authorization: Bearer bs_..."

# 記錄對單一網域的退訂（省略 domain_id 代表所有網域）
curl -X POST "https://api.billionsend.com/unsubscribes" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.org", "domain_id": "'"$DOMAIN_ID"'" }'

# 移除一筆記錄
curl -X DELETE "https://api.billionsend.com/unsubscribes/$UNSUBSCRIBE_ID" \
  -H "Authorization: Bearer bs_..."
```

`domain_id` 與 `domain` 都是 `null` 的記錄，代表該位址退出所有網域。`POST` 具有冪等性：已存在的記錄會原樣回傳。相同的呼叫也有對應的 MCP 工具：`list_unsubscribes`、`add_unsubscribe` 與 `delete_unsubscribe`。

各項操作解除的範圍：

- 帶有 `unsubscribed: false` 的 `PATCH /contacts/{id}` 只會解除團隊層級的退訂。特定網域的退訂會保留。
- `DELETE /unsubscribes/{id}` 只移除那一筆記錄。

如果你刪除網域後，又用同一個名稱重新新增，該網域收件者的退訂會再次生效。

### 誰可以變更

擁有者、管理員與行銷成員，以及具備完整權限的 API 金鑰，可以記錄退訂。只有擁有者與管理員可以撤回退訂。請見[團隊角色](/docs/zh-hant/team-roles)。

限制在單一網域的 API 金鑰，只能管理該網域的退訂：其他網域會回傳 `403 restricted_api_key`。

## 從 CSV 匯入名單

要把另一家服務商的退訂名單帶過來，請在控制台打開**聯絡人 → 退訂**，選擇**匯入 CSV**。

```csv
email,domain
ada@example.com,
grace@example.com,news.example.org
alan@example.com,*
```

- `email` 為必填。`domain` 為選填。標題列也是選填。
- `domain` 是你的其中一個網域，會把退訂限制在它所寄的信件上。`*` 代表所有網域。空白的儲存格會使用你在對話框中選擇的**預設網域**。
- 網域不明或位址無效的資料列會被略過。

對話框會顯示新增了多少筆退訂、有多少筆已經存在，以及資料列被略過的原因。同一個檔案匯入兩次也很安全。

## 事件

收件者退訂時會觸發 `contact.unsubscribed`，其中 `source` 為 `hosted_page` 或 `one_click`，並附上 `domain_id` 與 `domain_name`（團隊層級的退訂兩者都是 `null`）。撤回退訂會觸發 `contact.resubscribed`。請見 [Webhook](/docs/zh-hant/concepts/webhooks)。

## 限制

| | Free | Starter、Pro、Scale |
| --- | --- | --- |
| 退訂頁面外觀（標誌、顏色、字型、標誌圓角） | 預設外觀 | 每個網域各自的外觀 |
| 自有退訂子網域 | 否（共用主機） | 是 |
| 頁面上的「Powered by BillionSend」 | 顯示 | 隱藏 |

在 Free 上設定子網域會回傳 `403 plan_limit_reached`。你可以儲存頁面外觀，但在升級之前，收件者看到的仍是預設外觀。降級後，已儲存的外觀會保留，升級後再次生效，已設定的子網域也會繼續運作。
