如何在Outlook Add-In（Office JS）中实现新回复邮件标记集成？

目前Office JS Outlook Add-In仍未提供原生的“新邮件实时到达触发”客户端事件，但可以通过以下两种主流方案实现你的需求：

一、基于Microsoft Graph的后台监听方案（推荐用于全自动同步） #

通过Graph API订阅收件箱的新邮件事件，实现后台自动处理：

• 注册Azure AD应用，申请Mail.ReadWrite等必要权限
• 创建邮件订阅，监听收件箱中messages的created事件，当有新邮件到达时，Graph会推送通知到你的服务端点
• 收到通知后，调用Graph API获取邮件详情，通过自定义扩展属性（singleValueExtendedProperties）为邮件添加isSynced: true标记，避免重复同步
• 后续无论是Add-In还是后台服务，都可以通过该属性筛选未同步邮件

二、基于Office JS的客户端交互触发方案 #

利用客户端的ItemChanged事件，在用户切换查看邮件时检查并处理：

• 在Add-In初始化时绑定ItemChanged事件，当用户选中新邮件时触发逻辑
• 读取邮件的自定义属性判断是否已同步，未同步则执行同步操作并标记
• 代码示例：

Office.initialize = function () {
  Office.context.mailbox.addHandlerAsync(Office.EventType.ItemChanged, handleItemChange);
};

function handleItemChange() {
  const currentItem = Office.context.mailbox.item;
  currentItem.loadCustomPropertiesAsync(result => {
    const customProps = result.value;
    if (!customProps.get('syncedToThirdParty')) {
      // 执行同步到第三方系统的逻辑
      syncMailToThirdParty(currentItem);
      // 标记已同步
      customProps.set('syncedToThirdParty', 'true');
      customProps.saveAsync();
    }
  });
}

补充：辅助标记方式 #

除了自定义属性，还可以给已同步邮件添加自定义类别（比如“已同步至第三方系统”），既方便用户直观识别，也能作为筛选条件辅助同步逻辑。

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