如何配置SendGrid退订链接，避免邮箱被加入退订列表？

问题 #

使用SendGrid发送邮件简报，希望借助其订阅追踪功能提供带验证的退订URL、自动生成包含mailto方式的List-Unsubscribe头，同时通过退订webhook在自有数据库中跟踪用户退订状态。但目前SendGrid在触发webhook的同时，会将退订用户加入自身全局退订/抑制列表，导致自有数据库与SendGrid的订阅状态不同步（比如用户在应用内重新订阅后，SendGrid仍会拒绝向该用户发送邮件）。需要让SendGrid仅作为退订代理，触发webhook但不将用户加入其抑制列表。

解决方案 #

只需在邮件发送配置中添加特定参数，即可阻止SendGrid将退订用户加入全局抑制列表，同时保留webhook触发和订阅追踪的核心功能：

1. 修改邮件发送代码的trackingSettings.subscription_tracking配置，新增suppress_suppression: true参数。该参数会告知SendGrid，当用户点击退订链接或通过mailto方式退订时，仅触发退订webhook事件，不将邮箱添加到自身抑制列表。

修改后的发送邮件代码如下：

// Sending a newsletter

import * as sgMail from '@sendgrid/mail';
sgMail.send({
  customArgs: {
    newsletter_id: 'cats',
  },
  to: 'foo@bar.com',
  from: 'me@app.com',
  trackingSettings: {
    subscription_tracking: {
      enable: true,
      substitution_tag: '--unsubscribe--',
      suppress_suppression: true // 新增：阻止SendGrid将用户加入抑制列表
    },
  },
  html: '<a href="--unsubscribe--">Click here to unsubscribe</a>'
});

2. 现有webhook代码无需修改，它仍能正常接收unsubscribe事件并将退订记录写入自有数据库。

额外注意：若之前已有用户被加入SendGrid抑制列表，需手动或通过API批量移除这些用户，避免影响后续邮件发送。

内容的提问来源于stack exchange，提问作者jameshfisher