Spring框架下实现Outlook接收Teams会议邀请推送通知的方案咨询

首先明确：你需要的Teams会议邀请通知本质是iCalendar（.ics）格式的特殊日历事件，不属于普通SMTP邮件，因此普通Spring Boot邮件发送的逻辑无法直接复用，以下是两种可落地的实现思路：

1. 推荐方案：对接Microsoft Graph Java SDK #

该方案是微软官方支持的标准实现，稳定性最高，不会出现格式不兼容的问题。

前置准备 #

• 在Azure门户注册企业应用，配置Calendars.ReadWrite、Mail.Send的API权限，获取租户ID、客户端ID、客户端密钥

依赖引入 #

Maven坐标示例：

<dependency>
    <groupId>com.microsoft.graph</groupId>
    <artifactId>microsoft-graph</artifactId>
    <version>6.3.0</version>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.11.1</version>
</dependency>

核心逻辑 #

• 用Azure身份认证类构造Graph客户端，后台服务场景推荐使用ClientSecretCredential做认证
• 构造Event事件对象，必填配置项：
  • 设置isOnlineMeeting为true
  • 设置onlineMeetingProvider为teamsForBusiness
  • 填写参会人列表、会议起止时间、会议主题等基础信息
• 调用graphClient.users("{组织者邮箱}").events().post(event)接口创建会议，微软服务会自动生成Teams会议链接，并给所有参会人推送Outlook日历通知，直接显示在Outlook右侧日历下方的通知栏，同时同步到Teams的会议邀请列表。

2. 轻量方案：iCalendar格式封装+SMTP发送 #

不需要对接微软云接口，适合轻量内部场景使用。

核心逻辑 #

• 构造符合RFC5545标准的iCalendar格式内容，添加微软专属扩展字段标记Teams会议属性，示例格式：

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Microsoft Corporation//Outlook 16.0 MIMEDIR//EN
METHOD:REQUEST
BEGIN:VEVENT
UID:自定义唯一事件ID
DTSTART:20240601T090000Z
DTEND:20240601T100000Z
SUMMARY:测试Teams会议
ATTENDEE;ROLE=REQ-PARTICIPANT;CN=张三:mailto:zhangsan@example.com
ORGANIZER;CN=李四:mailto:lisi@example.com
X-MS-OLK-ONLINEMEETINGJOINURL:https://teams.microsoft.com/l/meetup-join/xxx
END:VEVENT
END:VCALENDAR

• 用Spring Boot自带的JavaMailSender发送邮件，注意要把邮件的Content-Type设置为text/calendar; method=REQUEST，不要把ics作为普通附件发送，否则Outlook不会自动识别为会议邀请
• 发送成功后Exchange服务会自动解析ics内容，将会议推送到参会人的Outlook侧栏日历通知中。

注意事项 #

• 必须使用企业版Microsoft 365/Outlook账号，个人Outlook账号不支持Teams会议的推送权限
• 使用Graph SDK时注意区分委托权限和应用权限：用户触发的发送场景用委托权限，后台定时自动发送的场景用应用权限
• iCalendar格式中的时间必须转换为UTC时区，否则会出现Outlook显示时间偏差的问题

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