使用 Amazon Pinpoint 向电子邮件添加取消订阅标头 - Amazon Pinpoint

终止支持通知： AWS 将于 2026 年 10 月 30 日终止对亚马逊 Pinpoint 的支持。2026 年 10 月 30 日之后，您将不再能够访问 Amazon Pinpoint 控制台或 Amazon Pinpoint 资源（端点、分段、活动、旅程和分析）。有关更多信息，请参阅 Amazon Pinpoint 终止支持。注意： APIs 与短信相关、语音、移动推送、OTP 和电话号码验证不受此更改的影响，并受 AWS 最终用户消息的支持。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 Amazon Pinpoint 向电子邮件添加取消订阅标头

注意

如果要发送来自活动或旅程的电子邮件，则必须先设置电子邮件编排发送角色，然后才能使用电子邮件标头。要直接发送电子邮件，您必须拥有 ses:SendEmail 和 ses:SendRawEmail 的权限。有关更多信息，请参阅《Amazon Pinpoint 用户指南》中的创建电子邮件编排发送角色。

在电子邮件中包含取消订阅链接是一项最佳实践，并且在一些国家/地区是法律所要求的。要添加一键取消订阅链接，请添加以下标头：

  1. 将标头名称设置为 List-Unsubscribe，将值设置为您的取消订阅链接。该链接必须支持 HTTP POST 请求，才能处理收件人的取消订阅请求。

  2. 将标头名称设置为 List-Unsubscribe-Post，将值设置为 List-Unsubscribe=One-Click。

最多可向电子邮件消息添加 15 个标头。有关支持的标头列表，请参阅《Amazon Simple Email Service 开发人员指南》中的 Amazon SES 标头字段。

以下示例说明如何使用 AWS Command Line Interface 发送包含取消订阅标头的电子邮件。有关配置 AWS CLI 的更多信息，请参阅《AWS Command Line Interface 用户指南》中的配置 AWS CLI。

在以下命令中，请执行以下操作：

  • 将 AppId 替换为您的应用程序 ID。

  • 将 richard_roe@example.com 替换为收件人的电子邮件地址。

  • 将 https://example.com/unsub 替换为您的取消订阅链接。

  • 将 example123456 替换为收件人的唯一标识符。

aws pinpoint send-messages --application-id AppId --message-request '{
 "Addresses": {
   "richard_roe@example.com": {
     "ChannelType": "EMAIL"
   }
 },
 "MessageConfiguration": {
   "EmailMessage": {
     "Substitutions": {
       "url": [
         "https://example.com/unsub"
       ],
        "id1": [
          "/example123456"
        ]
     },
     "SimpleEmail": {
       "TextPart": {
         "Data": "Sample email message with an subscribe header",
         "Charset": "UTF-8"
       },
       "Subject": {
         "Data": "Hello",
         "Charset": "UTF-8"
       },
       "Headers": [
         {
           "Name": "List-Unsubscribe",
           "Value": "{{url}}{{id1}}"
         },
         {
           "Name": "List-Unsubscribe-Post",
           "Value": "List-Unsubscribe=One-Click"
         }
       ]
     }
   }
 }
}'