Microsoft Azure访客邀请自定义HTML消息及customizedMessageBody配置问题

核心注意事项 #

• 所有写在customizedMessageBody里的HTML内容，要符合JSON字符串的语法规则：如果HTML代码里用到双引号包裹属性值，必须把双引号转义为\"，避免JSON解析失败。
• 不要使用JavaScript、外部样式表、iframe等特殊元素，绝大多数邮件客户端会直接拦截这类内容，推荐使用行内样式设置格式。
• 可以直接使用接口预留的占位符：{0}会自动替换为被邀请人的显示名称，{1}会自动替换为邀请跳转链接，不需要手动拼接。

正确配置示例 #

下面是完整的请求体示例，customizedMessageBody里嵌入了带格式的HTML内容：

{ 
"invitedUserDisplayName": "Invited User", 
"invitedUserEmailAddress": "invited1234@yopmail.com", 
"invitedUserMessageInfo": {
    "messageLanguage": "zh-CN",
    "ccRecipients": [
         {
            "emailAddress": {
                "name": "xyz@yopmail.com",
                "address": "xyz@yopmail.com"
             }
         }
    ],
    "customizedMessageBody": "<html><body><h2>您好 {0}，欢迎加入我们的组织</h2><p>您已经获得了系统访问权限，点击下方链接即可登录：</p><p style=\"color: #2563eb;font-weight: bold;\"><a href=\"{1}\">立即登录</a></p><br><p>如果链接无法点击，您可以复制以下地址到浏览器打开：<br>{1}</p><hr><p>如有使用问题可以联系管理员处理。</p></body></html>"
 },
"sendInvitationMessage": true, 
"inviteRedirectUrl": "https://myapps.microsoft.com" 
}

常见问题排查 #

• 如果邮件收到后没有显示自定义内容：先检查JSON是否转义正确，有没有遗漏的未转义双引号导致请求解析失败。
• 如果样式显示异常：不要使用复杂的CSS选择器，所有样式都用行内style属性写在对应的HTML标签上。

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