使用V3 Mail Send API发送带超链接邮件的Request Body应如何配置？

核心配置要求 #

• 必须在请求体的content数组中加入type为text/html的内容块，仅用text/plain纯文本内容无法插入可点击的超链接
• 在HTML内容块的value字段中，直接使用标准HTML <a> 标签定义超链接即可，格式为<a href="完整链接地址">链接展示文本</a>

完整请求体参考示例 #

{
  "personalizations": [
    {
      "to": [
        {
          "email": "recipient@example.com",
          "name": "收件人名称"
        }
      ],
      "subject": "带超链接的测试邮件"
    }
  ],
  "from": {
    "email": "sender@example.com",
    "name": "发件人名称"
  },
  "content": [
    {
      "type": "text/plain",
      "value": "这是纯文本 fallback 内容，若收件邮箱不支持HTML，链接将直接展示：https://你的目标链接地址"
    },
    {
      "type": "text/html",
      "value": "<p>您好，这是测试邮件内容，点击即可跳转：<a href=\"https://你的目标链接地址\">点击访问目标页面</a></p>"
    }
  ]
}

注意事项 #

• 超链接的href属性必须填写带协议前缀的完整地址（如https://开头），不要使用相对路径，避免邮箱客户端识别异常
• 建议同时保留text/plain和text/html两类内容，兼容所有邮箱客户端的展示需求
• 若需要开启超链接点击统计，无需修改HTML中的链接代码，直接在API请求中开启对应追踪配置即可，系统会自动替换链接为追踪链路

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