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

抑制列表

BillionSend 不会再次发信的地址清单,用来保护你的发信信誉。

抑制列表保存不应再发邮件的地址,避免你反复给曾经退信或把你标记为垃圾邮件的地址发信。它保护你的信誉和你的 发送限制。在控制台的 联系人 → 抑制列表 中可以找到它。

地址如何进入列表

  • 硬退信。 接收服务器永久拒绝了该地址。软退信不计入。
  • 投诉。 收件人把一封邮件标记为垃圾邮件。
  • 无效地址。 深度 名单验证 发现该地址没有对应的邮箱。
  • 邮箱已满。 联系人的邮箱两次报告已满,两次间隔 1 到 30 天。
  • 手动添加。 你在控制台中或通过 API 添加。

退信和投诉会自动添加。列表按团队划分,每个地址只有一条记录。它描述的是地址,而不是品牌:一个不存在的地址,无论你的哪个域名给它发信,都是同一个事实。

点击退订的收件人不会被加到这里。这种选择会记录为对退订链接所在邮件的发信域名的 退订,只会停止营销邮件。抑制列表则会停止发往该地址的所有邮件,包括事务邮件。

它的作用

  • 每一次发送 都会跳过被抑制的收件人:POST /emails、SMTP 中继、订阅主题发送和群发都是如此。他们会从 to、cc 和 bcc 中移除。
  • 如果所有收件人都被抑制, 发送会被拒绝,返回 422 all_recipients_suppressed。SMTP 中继返回 550。当 POST /emails 的收件人因此被清空时,BillionSend 会保留一条状态为 suppressed 且没有内容的记录,它不计入你的发送量,并会发送 email.suppressed Webhook。
  • 在等待的邮件 会在发出时再次检查,所以已定时的邮件会跳过在此期间被抑制的地址。
  • 群发 会跳过被抑制的联系人。

对列表的每一次变更,都会发送 suppression.added 或 suppression.removed Webhook。

查看与移除

控制台会列出每个地址,以及它的原因和日期。收件人的退订在单独的标签页中,每条都带有对应的域名。

你可以移除一个地址以恢复发送。只在确定原因已经解决时才这样做,例如一个邮箱一直存在,只是被配置错误的服务器拒收。该地址在下一次退信或投诉时会再次被抑制。

API

SDK 把 /suppressions 接口作为 suppressions.* 调用。每条记录的格式是 { id, email, origin, source_id, created_at }。origin 是 bounce、complaint 或 manual,source_id 是其退信或投诉产生了这条记录的那封邮件。

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 列出记录,最新的在前,可以按来源筛选。
  • GET /suppressions/{id} 和 DELETE /suppressions/{id} 接受记录 id 或邮箱地址。
  • POST /suppressions 添加一个地址。可选的 origin(bounce、complaint 或 manual,默认 manual)可以让你把其他服务商的退信和投诉历史迁移过来。添加已在列表中的地址会返回它已有的记录。
  • POST /suppressions/batch/add(带 { "emails": [...] })和 POST /suppressions/batch/remove(带 { "emails": [...] } 或 { "ids": [...] })每次调用最多接受 1,000 个地址。

移除记录需要由所有者或管理员创建的密钥。参见 团队角色。

如果某个地址的个人数据已被你擦除,它仍会阻止发送,但会从列表和按邮箱的查询中隐藏。仍然可以通过它的 id 访问,此时邮箱显示为 "[erased]"。

Amazon SES 与你的团队

Amazon SES 为你的团队保存一份自己的抑制列表,与其他团队的列表相互独立:你的邮件产生的退信,不会阻止其他团队给同一个地址发邮件。SES 会自己把退信和投诉加入其中。你在这里移除一个地址,几秒钟后它也会在那里被移除。SES 因它的列表而拒绝的发送,会显示为永久退信,子类型为 OnTenantSuppressionList。

如果你的退信率或投诉率升得太高,SES 可能会暂停你的团队。所有者会收到一封邮件,其中附有 SES 给出的原因,你的邮件会被暂扣而不是失败,SES 重新启用发送后会发出。参见 发送限制。

这个页面有帮助吗?