如何从Excel Add In调用邮件功能？本地Outlook与Graph API方案咨询

嘿，这个需求我刚好有过相关实践，咱们一步步来拆解最优方案：

一、优先选择：调用本地Outlook填充内容（完全可行） #

这绝对是体验最好的方案，既没有内容长度限制，又复用了用户熟悉的Outlook界面，用户确认后发送即可，完全不需要额外的认证或UI开发。分两种Add-in类型来说：

1. 桌面版Excel的VSTO Add-in（.NET技术栈） #

直接利用Outlook的Interop组件就能实现，代码非常直观：

using Microsoft.Office.Interop.Outlook;

// 初始化Outlook应用
var outlookApp = new Application();
// 创建新邮件项
var mailItem = outlookApp.CreateItem(OlItemType.olMailItem);

// 填充邮件内容
mailItem.To = "target@example.com";
mailItem.Subject = "来自Excel Add-in的导出邮件";
// 支持HTML格式，你可以直接把Excel内容转成HTML填入
mailItem.HTMLBody = "<h3>Excel导出数据</h3><p>这里放你的邮件正文...</p>";

// 弹出Outlook邮件窗口让用户确认发送（true表示模态窗口，用户操作完才返回）
mailItem.Display(true);

这种方式完全本地运行，没有网络依赖，内容大小不受任何限制。

2. Web版Excel Add-in（跨平台，JS/TS技术栈） #

可以通过outlook:协议调用本地Outlook，比普通mailto:支持更大的内容量，且参数更丰富：

// 编码邮件内容（支持HTML）
const encodedBody = encodeURIComponent("<h3>Excel导出内容</h3><p>这里可以放大量HTML格式的内容...</p>");
// 构造Outlook协议链接
const outlookMailUrl = `outlook:mail?to=target@example.com&subject=Excel导出邮件&body=${encodedBody}`;
// 打开链接唤起本地Outlook
window.open(outlookMailUrl);

如果是Windows平台上的Web Add-in，还可以通过Office.js的更深层API直接和桌面Outlook交互，不过上述协议方式已经能覆盖绝大多数场景。

二、备选方案：Microsoft Graph API 简化实现 #

如果因为跨平台限制（比如Mac上的Web Add-in唤起Outlook有问题）必须用Graph API，那可以通过以下方式简化开发：

1. 复用Office.js内置认证，跳过手动OAuth流程 #

Excel Web Add-in自带Office.context.auth.getAccessTokenAsync方法，能直接获取访问Graph API的令牌，不需要自己搭建登录页面或处理OAuth跳转：

// 获取Graph API访问令牌
Office.context.auth.getAccessTokenAsync({ allowSignInPrompt: true }, (result) => {
  if (result.status === "succeeded") {
    const accessToken = result.value;
    // 后续用这个令牌调用Graph API即可
  }
});

记得在Add-in的manifest文件中声明Mail.Send或Mail.ReadWrite的权限，用户首次使用时只需要授权一次。

2. 复用Outlook原生UI，跳过自定义邮件编辑界面 #

不要自己开发邮件编辑器！可以用Graph API创建邮件草稿，然后用outlook:协议打开这个草稿，让用户在Outlook里确认编辑后发送：

// 假设已经拿到accessToken
fetch("https://graph.microsoft.com/v1.0/me/messages", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${accessToken}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    subject: "Excel导出邮件",
    toRecipients: [{ emailAddress: { address: "target@example.com" } }],
    body: { content: "<h3>Excel导出数据</h3><p>正文内容...</p>", contentType: "HTML" }
  })
})
.then(res => res.json())
.then(draftMail => {
  // 用outlook协议打开草稿邮件
  window.open(`outlook:messageid/${draftMail.id}`);
});

这种方式既利用了Graph API的跨平台能力，又让用户在熟悉的Outlook界面里完成确认，完全不需要自己开发邮件编辑UI。

3. 权限简化：用委托权限而非应用权限 #

优先选择委托权限（比如Mail.Send），用户只需要用自己的Microsoft账号登录授权即可，不需要企业管理员审批，大幅简化部署和使用流程。

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