抑制清單
BillionSend 不會再寄信的位址清單,用來保護你的寄件信譽。
抑制清單收錄不應再寄信的位址,讓你不會一再寄給曾經退信或把你標為垃圾郵件的位址。它能保護你的信譽與你的寄送限制。在控制台的聯絡人 → 抑制清單可以找到它。
位址如何進入清單
- 硬退信。 收件伺服器永久拒絕了這個位址。軟退信不算。
- 投訴。 收件者把某封 Email 標記為垃圾郵件。
- 無效位址。 深度名單驗證發現那裡沒有任何信箱會回應。
- 信箱已滿。 聯絡人的信箱在相隔 1 到 30 天的兩次寄送中都回報已滿。
- 手動。 你在控制台或透過 API 加入的位址。
退信與投訴會自動加入。這份清單以團隊為單位,每個位址只有一筆。它描述的是位址本身,而不是某個品牌:不存在的位址,不管你哪個網域去寄,都是同一個事實。
收件者按下退訂時,不會被加到這裡。這個選擇會記錄成對該連結所在 Email 的網域的退訂,並且只會停止行銷郵件。抑制清單則會停止寄給該位址的所有 Email,包含交易郵件。
作用
- 每一次傳送都會略過被抑制的收件者:
POST /emails、SMTP relay、訂閱主題寄送與群發都一樣。他們會從to、cc與bcc中移除。 - 所有收件者都被抑制時,寄送會被拒絕,回傳
422 all_recipients_suppressed。SMTP relay 會回應550。當POST /emails因此被清空時,BillionSend 會保留一筆狀態為suppressed、沒有內容的記錄,它不計入你的用量,並會發出email.suppressedWebhook。 - 等待中的信件在寄出時會再檢查一次,所以已排程的 Email 會略過這段期間才被抑制的位址。
- 群發會略過被抑制的聯絡人。
清單的每次變更都會發出 suppression.added 或 suppression.removed Webhook。
檢視與移除
控制台會列出每個位址及其原因與日期。收件者的退訂則在另一個分頁,每一筆都附有網域。
你可以移除位址以恢復寄送。只有在確定原因已排除時才這樣做,例如信箱一直存在,卻被設定錯誤的伺服器拒收。該位址在下一次退信或投訴時,會再次被抑制。
API
SDK 把 /suppressions 端點呼叫為 suppressions.*。每一筆為 { id, email, origin, source_id, created_at }。origin 是 bounce、complaint 或 manual,source_id 則是因退信或投訴而建立這筆記錄的 Email。
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 個位址。
移除記錄需要由擁有者或管理員建立的金鑰。請見團隊角色。
已清除個人資料的位址仍會繼續阻擋寄送,但會從清單與依 Email 的查詢中隱藏。它仍可用 id 取得,此時 Email 顯示為 "[erased]"。
Amazon SES 與你的團隊
Amazon SES 為你的團隊保有獨立的抑制清單,與其他團隊的清單分開:你的信件退信,不會擋住其他團隊寄給同一位址的信。SES 會自行把退信與投訴加進去。你在這裡移除位址後,幾秒後也會從那裡移除。被 SES 因其清單而拒絕的寄送,會顯示為永久退信,子類型為 OnTenantSuppressionList。
如果你的退信率或投訴率攀升過高,SES 可能暫停你的團隊。擁有者會收到附有 SES 所述原因的通知信,你的信件會被擱置而不是失敗,等 SES 重新啟用寄送後就會寄出。請見寄送限制。