outlook调用ews或smtp发送邮件无法激活 @ 提及功能解决方法

在使用程序通过smtp或ews api推送邮件时，直接在文本中输入“@姓名”往往会被系统识别为普通静态文本。这是因为outlook的 @mentions（提及）功能并非简单的字符匹配，而是需要在邮件对象的元数据中包含特定的实体属性。传统的smtp协议由于缺乏对这些现代交互实体的支持，无法直接触发outlook收件箱中的提及筛选器或姓名高亮效果。

一、 为什么ews和smtp难以实现提及功能

提及功能的本质是在邮件的html正文中嵌入特定的实体标记，并同步在邮件头的扩展属性中注册该联系人。

协议限制：smtp是一种古老的传输协议，它只负责传递邮件正文，不具备与exchange深度交互以创建“提及实体”的能力。

ews的局限性：虽然ews可以处理较复杂的邮件属性，但微软并未针对ews公开专门用于构建 @mention对象的官方文档或简单接口，这导致通过ews手动构造包含提及实体的xml请求极其困难且容易出错。

二、 解决方案：转向microsoft graph api

如果要实现原生的 @mention效果（即收件人能看到高亮的姓名，且邮件列表显示提及图标），最直接且受官方支持的手段是使用microsoft graph api。

构造提及对象：在发送邮件的json请求体中，需要显式定义一个 mentions 集合。

代码示例：使用graph rest api发送包含提及的消息逻辑：

{
"message": {
"subject": "项目进度跟进",
"body": {
  "contentType": "HTML",
  "content": "请查看附件内容，@张三 确认后请回复。"
},
"toRecipients": [
  { "emailAddress": { "address": "zhangsan@company.com" } }
],
"mentions": [
  {
    "mentioned": {
      "name": "张三",
      "address": "zhangsan@company.com"
    },
    "clientReference": "mention_1"
  }
]
}
}

通过这种方式发送，outlook客户端会自动将正文中的文本与mentions数组匹配，从而激活交互功能。

三、 针对ews/smtp的折中降维方案

如果生产环境强制要求使用smtp或ews且无法切换到graph api，可以采用“视觉模拟”的方式提升用户体验，虽然这无法触发系统的“提及筛选”功能。

html链接模拟：在邮件正文中使用锚点标签模拟提及样式，让其看起来像是一个被提及的联系人。

<a href="mailto:zhangsan@company.com">@张三</a>

这种做法虽然在底层逻辑上依然是“静态文本”，但通过颜色和背景色的处理，可以引导用户在outlook视觉层面上获得一致的体验。