房间邮箱解析问题

这是一篇面向 房间日历 功能的专项排障文档。如果您还没有完成日历服务连接或房间绑定，请先阅读 房间日历。

这篇文章讨论的是房间邮箱的处理规则，不是 Microsoft 365 的授权方式。即使客户租户已经完成了应用授权，房间邮箱仍然可能裁剪主题或正文，从而影响 VCA 解析。

如果您在 VCA 的房间日历中遇到以下问题：

• 会议主题被显示为“组织者姓名”，而不是原始会议主题。
• Zoom 可以正常识别，但飞书、钉钉、腾讯会议无法解析。
• 房间邮箱中的会议正文为空，或者只剩下一段空白 HTML。

通常不是 VCA 解析器本身出错，而是 Microsoft 365 的房间资源邮箱在自动接受会议时，把主题和正文做了隐私裁剪。

为什么会出现这个问题

Microsoft 365 的房间邮箱默认可能启用了以下处理规则：

• AddOrganizerToSubject = $true
• DeleteSubject = $true
• DeleteComments = $true

这会带来两个直接结果：

1. 房间邮箱里的会议主题被替换成组织者姓名。
2. 房间邮箱里的会议正文被删除。

对于 Zoom，这种问题有时不明显，因为 Zoom 的加入链接经常会同时写入 location 字段。
但飞书、钉钉、腾讯会议的加入链接通常主要保存在会议正文中。正文一旦被删除，VCA 就无法从房间邮箱副本中解析出这些会议的入会信息。

适用场景

本文适用于以下情况：

• 您使用的是 Microsoft 365 / Exchange Online 房间资源邮箱。
• 您已经在 VCA Cloud 中完成了房间日历连接。
• 您希望 VCA 在房间屏幕或控制器上正确显示会议主题，并解析第三方会议链接。

修复思路

根因修复不是修改 VCA，而是修改 房间邮箱的 Calendar Processing 设置，让房间邮箱保留会议主题和正文。

推荐配置如下：

Set-CalendarProcessing -Identity "[email protected]" `
  -AutomateProcessing AutoAccept `
  -AddOrganizerToSubject $false `
  -DeleteSubject $false `
  -DeleteComments $false `
  -ProcessExternalMeetingMessages $true `
  -RemovePrivateProperty $false

操作前准备

在开始前，请确认：

• 您拥有 Microsoft 365 全局管理员或 Exchange 管理员权限。
• 您知道要修改的房间邮箱地址，例如 [email protected]。
• 您的电脑可以连接到 Exchange Online PowerShell。

Windows 上在哪里打开 Exchange Online PowerShell

很多用户会以为需要单独安装一个叫 “Exchange Online PowerShell” 的程序。
实际上，在 Windows 上您只需要打开 PowerShell 或 Windows Terminal，然后在里面加载 Exchange Online 模块即可。

推荐操作方式：

1. 打开 Windows 开始菜单。
2. 搜索 PowerShell 或 Windows Terminal。
3. 打开后直接执行本文下面的命令。

如果系统提示您不允许执行脚本，可以先执行：

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

然后再继续安装和连接 Exchange Online。

操作步骤

Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser

Connect-ExchangeOnline -UserPrincipalName your-[email protected]

修改后如何验证

建议按下面的顺序验证：

1. 新建一条新的飞书、钉钉或腾讯会议邀请，并邀请对应的房间邮箱。
2. 等待房间邮箱自动接受该会议。
3. 在 VCA 中检查：
   • 会议主题是否显示为真实主题，而不是组织者姓名。
   • 房间日历是否能识别出第三方会议类型。
   • 是否可以正确显示或解析加入链接。

重要说明

旧会议可能不会自动恢复

即使您已经修改了 CalendarProcessing 配置，之前已经被房间邮箱处理过的历史会议，不一定会自动恢复原主题和正文。

最稳妥的方式是：

• 新建一条新的测试会议验证。
• 如果必须验证旧会议，请尝试重新发送邀请，或删除后重新创建。

为什么 Zoom 有时看起来是正常的

这并不代表房间邮箱没有被裁剪。

在很多场景里，Zoom 的加入链接会同时写入 location 字段，因此即使正文被删除，VCA 仍然可能从 location 中解析到 Zoom 链接。
而飞书、钉钉、腾讯会议通常更依赖正文中的邀请内容，所以更容易受到 DeleteComments 的影响。

为什么要尽量保留房间邮箱副本

VCA 只能解析房间邮箱事件里实际保留下来的内容。
如果房间邮箱已经把主题或正文裁剪掉，VCA 可用于解析的信息也会变少。

因此，推荐始终优先修复房间邮箱自身的配置。

参考资料