退訂與品牌
退訂依寄件網域各自記錄,因此每個品牌都有自己的名單、退訂頁面與連結主機。
退訂的意思是「不要再寄行銷郵件給我」。BillionSend 會把它記錄在帶有該連結的 Email 所屬的寄件網域上,所以擁有多個品牌的團隊,名單不會混在一起。離開某個品牌的人,仍會收到其他品牌的信。
交易郵件(沒有帶訂閱主題,也不屬於群發的郵件)永遠不受退訂影響。
三種範圍
| 範圍 | 由誰設定 | 停止什麼 |
|---|---|---|
| 網域 | 收件者,使用退訂連結或其郵件用戶端的一鍵按鈕 | 寄出該封 Email 的網域所寄的行銷郵件 |
| 整個團隊 | 你,把聯絡人的 unsubscribed 設為 true(API、控制台或 CSV 匯入) |
團隊所有網域的行銷郵件 |
| 訂閱主題 | 收件者,在退訂頁面上 | 帶有該訂閱主題的郵件 |
收件者自己的退訂,永遠不會改動聯絡人的 unsubscribed 旗標。它會以該網域的一筆記錄儲存,並以 Email 位址作為索引,所以刪除再重新匯入聯絡人後,這筆記錄仍然有效。
群發與訂閱主題寄送,會略過已退出該寄件網域、整個團隊或該訂閱主題的收件者。以這種方式被攔下的單封 Email,最後狀態是 suppressed,原因為 domain_unsubscribed、contact_unsubscribed 或 topic_unsubscribed。
退訂不等於抑制。抑制清單收錄的是曾退信、投訴或由你封鎖的位址,會停止所有 Email,交易郵件也包含在內。退訂只會停止行銷郵件。
退訂頁面
每封群發與訂閱主題的 Email,都帶有一鍵退訂的 List-Unsubscribe 標頭(RFC 8058),以及一個連到託管退訂頁面的連結。在內文中放入 {{{UNSUBSCRIBE_URL}}},它就會變成每位收件者各自的同一個連結。頁面會以收件者的瀏覽器語言開啟(共 14 種語言,備用語言為英文)。除了退出該網域的所有行銷郵件,收件者也可以個別開關各個訂閱主題。
誤按的收件者,可以在確認頁面按重新訂閱。它只會復原該連結造成的退訂。開啟連結的郵件掃描器,永遠不會讓任何人重新訂閱。當你自己設定 unsubscribed: true 時,頁面上不會有重新訂閱按鈕。
每個網域有自己的外觀
頁面的外觀會與寄出該封 Email 的網域一致。每個網域可以設定:
- 品牌名稱、標誌與標誌的圓角,
- 背景、文字與強調色,
- 按鈕上方的文字,以及儲存選擇後顯示的文字,
- 退訂後要開啟的重新導向 URL,用來取代頁面上的訊息。
在控制台中,打開網域並使用品牌分頁,它會預覽結果。你留空的欄位會依序退回團隊的品牌預設值(設定),再退回 BillionSend 的簡潔外觀。頁面只會顯示屬於該網域的內容:它絕不會提到團隊的其他網域,而且只列出綁定到該網域的訂閱主題,以及沒有綁定網域的訂閱主題。
透過 API,則在 PATCH /domains/{id} 的 unsubscribe_page 中傳送這些欄位。null 會清除欄位。標誌在控制台上傳,在 API 中是唯讀。
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 會清除)。它的運作方式與追蹤子網域相同,請見網域。
- 新增網域的 DNS 分頁顯示的 CNAME,指向
cname.billiondns.com,並設為僅限 DNS(Cloudflare 上的灰雲)。 - CNAME 解析後會自動核發憑證,通常在幾分鐘內完成。
unsubscribe_status會從pending變成active,沒有成功時,unsubscribe_error會說明原因。 - 之後新寄出的信件會在連結與
List-Unsubscribe標頭中使用你的主機。在啟用之前,以及出現failed結果(72 小時內未啟用)之後,會使用共用主機。
已經寄出的連結會保留寄出時的主機,所以你之後移除 CNAME,它就會失效。你的子網域只會開啟它自己網域的連結,其他任何連結都會回應 404。
追蹤與退訂可以共用同一個標籤,但分開命名更安全:廣告封鎖器會封鎖追蹤主機,共用同一個名稱會讓退訂連結一起被封鎖。
讀取與變更退訂
GET /contacts/{id} 會回傳 unsubscribed(團隊層級的旗標)與 unsubscribed_domains。在控制台中,聯絡人的頁面會列出兩者,也能讓你移除某個網域的退訂。聯絡人下的退訂分頁會列出所有記錄。
# 列出,最新的在前。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 金鑰,可以記錄退訂。只有擁有者與管理員可以撤回退訂。請見團隊角色。
限制在單一網域的 API 金鑰,只能管理該網域的退訂:其他網域會回傳 403 restricted_api_key。
從 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。
限制
| Free | Starter、Pro、Scale | |
|---|---|---|
| 退訂頁面外觀(標誌、顏色、字型、標誌圓角) | 預設外觀 | 每個網域各自的外觀 |
| 自有退訂子網域 | 否(共用主機) | 是 |
| 頁面上的「Powered by BillionSend」 | 顯示 | 隱藏 |
在 Free 上設定子網域會回傳 403 plan_limit_reached。你可以儲存頁面外觀,但在升級之前,收件者看到的仍是預設外觀。降級後,已儲存的外觀會保留,升級後再次生效,已設定的子網域也會繼續運作。