SendGrid多收件人动态模板邮件：如何复用单份动态模板数据？

要实现隐藏收件人彼此邮箱且仅设置一次全局动态模板数据，核心是利用SendGrid的全局模板数据继承机制，具体操作如下：

核心逻辑 #

当使用Personalization为每个收件人单独配置收件信息时，只要不为单个Personalization设置dynamic_template_data，它就会自动继承邮件对象（Mail实例）上设置的全局dynamic_template_data。这样既保证了收件人彼此不可见，又无需重复编写相同的模板数据。

代码示例（Python） #

from sendgrid import SendGridAPIClient
from sendgrid.helpers.mail import Mail, Personalization, To

# 初始化邮件基础信息
message = Mail(
    from_email='你的发件邮箱@example.com',
    subject='统一邮件主题'
)

# 设置全局动态模板数据（所有收件人共用）
message.dynamic_template_data = {
    'greeting': '各位用户',
    'content': '这是所有收件人都会看到的统一内容',
    'button_text': '点击查看详情',
    'footer': '如有疑问请联系客服'
}

# 指定你的SendGrid动态模板ID
message.template_id = '你的模板ID'

# 批量添加收件人，每个收件人对应一个独立的Personalization
recipients = [
    {'name': '张三', 'email': 'zhangsan@example.com'},
    {'name': '李四', 'email': 'lisi@example.com'},
    {'name': '王五', 'email': 'wangwu@example.com'}
]

for rec in recipients:
    # 创建个性化配置对象
    personalization = Personalization()
    # 仅添加收件人信息，不设置单独的模板数据
    personalization.add_to(To(email=rec['email'], name=rec['name']))
    message.add_personalization(personalization)

# 发送邮件
try:
    sg_client = SendGridAPIClient('你的SendGrid API密钥')
    response = sg_client.send(message)
    print(f"发送成功，状态码: {response.status_code}")
except Exception as e:
    print(f"发送失败: {str(e)}")

关键注意事项 #

1. 不要混用两种模板数据设置方式：如果给某个Personalization单独设置了dynamic_template_data，它会覆盖全局对应键的内容；如果全局没有该键，则会新增。若不需要个性化内容，绝对不要给单个Personalization设置模板数据。
2. 模板变量匹配：确保模板中的变量名（如{{greeting}}）和全局dynamic_template_data的键完全一致，否则会出现数据缺失。
3. 避免使用is_multiple=True：该参数会将所有收件人放在同一个To字段中，导致彼此可见，不符合你的需求。

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