SuperAPI AI 工具集

twilio-sendgrid-suppressions

营销与增长

查看项目

更新于 10-15 23:41

技能介绍

用途:管理 SendGrid 的邮件抑制(suppression)记录,避免向已退信、举报垃圾邮件或退订的地址发送邮件,从而保护发件人声誉。

主要能力与抑制类型:硬退信(/v3/suppression/bounces,永久投递失败,自动加入);软退信(无管理 API,仅自动重试,反复失败后抑制);封禁(/v3/suppression/blocks,接收服务器临时拒绝);垃圾邮件举报(/v3/suppression/spam_reports);无效邮箱(/v3/suppression/invalid_emails);全局退订(/v3/suppression/unsubscribes);分组退订 ASM(/v3/asm/groups/{id}/suppressions)。

使用方式:通过 REST API 调用,请求头使用 Authorization: Bearer 加 SENDGRID_API_KEY。可列出退信(GET /v3/suppression/bounces)、按邮箱删除退信(DELETE /v3/suppression/bounces/{email})、创建 ASM 分组(POST /v3/asm/groups,含 name 与 description),发送时在 Mail Send 请求中带上 asm.group_id,收件人会看到“管理偏好”链接而非全局退订。自动清理可在 Console > Settings > Mail Settings > Purge Bounces & Blocks 配置软/硬退信自动清除天数(1–3,650 天)。地址允许列表在 Console > Settings > Mail Settings > Address Allow List 配置,可让指定地址或域名绕过所有抑制。

限制与注意:抑制默认全局生效,任一邮件触发退信或举报会抑制该地址的所有后续发送,需用 ASM 分组限定退订范围;删除抑制记录不会修复底层问题,重发硬退信会损害声誉;垃圾邮件举报抑制无法覆盖;不能按域名批量删除,只能按邮箱逐个通过 API 删除。删除抑制记录(尤其垃圾邮件举报)前须与用户确认并记录业务原因;自动清理不应作为强制投递的变通手段;允许列表切勿加入不受控域名(如 gmail.com),也不得用于绕过垃圾邮件举报抑制。

适用场景:邮件发送合规管理、退订偏好分组、退信清理与内部测试地址放行。