跳到内容
Esc
↑↓导航↵打开⌘J预览
本页内容

抑制清單

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.suppressed Webhook。
  • 等待中的信件在寄出時會再檢查一次,所以已排程的 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 重新啟用寄送後就會寄出。請見寄送限制。

这个页面有帮助吗?