开发Outlook Web Add-in检测指定文件夹每日邮件缺失的求助

核心思路拆解 #

你要做的本质是「定时检查指定Outlook文件夹的新邮件量 + 异常提醒」，结合你擅长C#/VB桌面开发的背景，我们尽量用你熟悉的技术栈降低门槛：用ASP.NET Core做后端处理Graph API调用（不用写复杂JS），Outlook Add-in负责触发定时任务和展示提醒，把Web开发的复杂度降到最低。

落地步骤（适配桌面开发者） #

1. 搭建基础项目 #

在VS2022里创建「Office Add-in」项目，选择Outlook类型，模板选「Command Line」（不需要复杂任务窗格，聚焦后台逻辑）。创建后重点关注两个文件：manifest.xml（插件配置）、commands.js（命令/后台任务逻辑）。

2. 配置Azure AD应用与权限 #

要调用Graph API必须先注册应用：

• 登录Azure门户，创建「应用注册」，选择「账户在任何组织目录和个人Microsoft账户」（适配企业和个人邮箱）
• 生成客户端密钥，记录客户端ID、租户ID、客户端密钥
• 在「API权限」里添加Microsoft Graph的Mail.Read权限（委托权限，因为要访问当前用户的邮箱），并完成管理员同意（企业环境）

3. 用C# Graph SDK写邮件检查逻辑 #

新建一个ASP.NET Core Web API项目（和Add-in项目放同一解决方案），用NuGet安装Microsoft.Graph和Microsoft.Identity.Client，写接口实现文件夹检查：

[ApiController]
[Route("api/[controller]")]
public class MailCheckController : ControllerBase
{
    private readonly IGraphServiceClient _graphClient;

    public MailCheckController(IGraphServiceClient graphClient)
    {
        _graphClient = graphClient;
    }

    [HttpGet("CheckFolder")]
    public async Task<IActionResult> CheckFolder(string folderId)
    {
        // 检查过去24小时内的新邮件
        var twentyFourHoursAgo = DateTimeOffset.UtcNow.AddHours(-24);
        var messages = await _graphClient.Me.MailFolders[folderId].Messages
            .Request()
            .Filter($"ReceivedDateTime ge {twentyFourHoursAgo:o}")
            .GetAsync();

        return Ok(new { HasNewMail = messages.Count > 0 });
    }
}

在Program.cs里配置Graph客户端：

builder.Services.AddSingleton<IGraphServiceClient>(sp =>
{
    var clientId = builder.Configuration["AzureAd:ClientId"];
    var tenantId = builder.Configuration["AzureAd:TenantId"];
    var clientSecret = builder.Configuration["AzureAd:ClientSecret"];

    var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
    return new GraphServiceClient(credential);
});

4. 配置Outlook Add-in定时后台任务 #

修改manifest.xml，添加后台任务配置，设置每天固定时间触发：

<VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
    <BackgroundTasks>
      <Task xsi:type="Timer" id="DailyMailCheck">
        <Trigger>
          <TimerTrigger recurrence="daily" startTime="09:00:00" />
        </Trigger>
        <Execution>
          <FunctionName>checkMailFolder</FunctionName>
        </Execution>
      </Task>
    </BackgroundTasks>
    <!-- 其他原有配置 -->
  </VersionOverrides>
</VersionOverrides>

5. 前端JS实现触发检查与提醒 #

在commands.js里写后台任务逻辑，调用你的Web API，异常时弹出通知：

function checkMailFolder(event) {
    // 这里替换成你要监控的文件夹ID（可以让用户在插件配置里设置，或者硬编码测试）
    const folderId = "your-folder-id";
    // 调用后端接口
    fetch("https://your-api-url/api/MailCheck/CheckFolder?folderId=" + folderId)
        .then(response => response.json())
        .then(data => {
            if (!data.HasNewMail) {
                // 弹出Outlook通知
                Office.context.mailbox.item.notificationMessages.addAsync(
                    "MailAlert",
                    {
                        type: Office.MailboxEnums.ItemNotificationMessageType.InformationalMessage,
                        message: "⚠️ 今日未收到指定文件夹邮件，请检查！",
                        icon: "Icon.80x80",
                        persistent: true
                    }
                );
                // 可选：创建Outlook任务
                createAlertTask();
            }
            // 标记任务完成
            event.completed();
        })
        .catch(error => {
            console.error(error);
            event.completed();
        });
}

function createAlertTask() {
    Office.context.mailbox.makeEwsRequestAsync(
        `<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
           <soap:Body>
             <CreateItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages" MessageDisposition="SaveOnly">
               <Items>
                 <Task xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
                   <Subject>邮件监控异常：指定文件夹无新邮件</Subject>
                   <Body BodyType="HTML">今日未收到指定文件夹的邮件，请确认邮件流是否正常。</Body>
                   <StartDate>${new Date().toISOString().split('T')[0]}</StartDate>
                   <DueDate>${new Date().toISOString().split('T')[0]}</DueDate>
                   <Status>NotStarted</Status>
                 </Task>
               </Items>
             </CreateItem>
           </soap:Body>
         </soap:Envelope>`,
        function (result) {
            console.log("任务创建结果：", result);
        }
    );
}

// 注册后台任务
Office.actions.associate("checkMailFolder", checkMailFolder);

关键注意事项 #

• 文件夹ID获取：可以在插件里加一个配置功能，让用户选择要监控的文件夹，通过Office.context.mailbox.getFolderAsync获取ID，避免硬编码
• 后台任务调试：用Office Dev Tools（浏览器插件）调试后台任务，需要开启「Enable background task debugging」选项
• 权限限制：企业环境下需要管理员同意Graph权限，否则普通用户无法使用；个人邮箱可以直接授权
• API调用频率：Graph API有调用限制，每日检查一次完全在额度内
• 部署：Web API需要部署到公网（比如Azure App Service），Outlook Add-in需要上传到App Source或者企业内部部署

内容的提问来源于stack exchange，提问作者jérémie Courbat