使用 Graph API 获取会议脚本和录制内容
现在可以将应用配置为在会议后方案中提取Microsoft Teams 会议脚本和录制内容。 你的应用可以使用 Microsoft Graph REST API 访问和提取为事先安排的 Teams 会议生成的脚本和录制。
下面是使用 图形 API 提取会议脚本和录制的一些用例:
用例 | 脚本和录制 API 如何提供帮助... |
---|---|
需要获取脚本和录制内容,以便从销售垂直的多个会议中捕获有意义的见解。 跟踪所有会议以及手动检索会议脚本和录制内容既耗时又效率低下。 会议结束后,你需要检查所有这些会议中的对话,以获取有用的信息。 | 在应用中使用 Graph API 提取会议脚本和录制内容会自动从与你的目的相关的所有会议中检索它们。 你的应用可以接收会议通知,并在会议结束后生成脚本和录制内容时获取脚本和录制内容。 然后,此数据可用于获取: • 聚合见解和智能分析 • 新的潜在顾客和亮点 • 会议跟进和摘要 |
作为人力资源计划,你将召开一个集思广益的会议,以了解和提高员工的健康状况和工作效率。 必须持续做笔记来提供会议后摘要可能会妨碍想法流,并且可能不会捕获所有有价值的建议。 会话结束后,需要分析讨论以收集数据点以进行规划改进。 | 使用应用中的 Graph API 在会议后提取脚本和录制内容,使你和参与者能够完全专注于讨论。 会议脚本和录制内容可用于: • 参与度和情绪分析 • 列出任务或问题 • 后续会议和通知 |
领先科技公司的销售人员必须与客户联系并达成交易。 由于通过 Teams 和 Outlook 日历安排了许多会议,因此参加所有通话并随时了解讨论和最新更新至关重要。 | 可以创建具有以下功能的应用: • 使用 Teams 或 Outlook 日历安排会议时通知你。 • 允许应用为这些会议设置 AutoRecording=true 。 • 将机器人添加为会议参与者,以显示一个横幅,指示正在录制会议,并且应用将使用该内容进行分析。 • 允许应用访问会议录制和脚本。 • 允许应用无需管理员批准 OnlineMeetingRecording.Read.All 权限,因为获取这些权限的管理员批准可能很耗时。 下面是展示此用例方案 的示例应用 。 |
可以使用 Graph API 提取会议脚本和/或录制内容。
注意
用于提取会议脚本和录制内容的 API 是按流量计费的 API。 有关详细信息,请参阅 会议 API 的付款模型。
若要提取特定会议的脚本和录制内容,请执行以下操作:
配置Microsoft Entra ID访问脚本和录制的权限
你的应用必须具有提取脚本和录制所需的权限。 它可以使用组织范围内的应用程序权限或特定于资源的同意来访问和提取 Teams 会议的脚本和录制内容, (RSC) 特定会议的应用程序权限。
使用组织范围的应用程序权限
可以将应用配置为访问整个租户的会议脚本和录制内容。 在这种情况下,会议组织者无需在 Teams 会议聊天中安装应用。 当管理员授权组织范围的应用程序权限时,你的应用可以读取和访问租户中所有会议的脚本和录制内容。
有关可授予应用的组织范围应用程序权限的详细信息,请参阅 联机会议权限。
使用特定于会议的 RSC 应用程序权限
如果希望应用仅提取安装它的 Teams 会议的脚本和录制内容,请为应用配置特定于会议的 RSC 权限。 授权用户可以在会议聊天中安装应用。 会议结束后,应用可以进行 API 调用,以获取该会议的脚本和录制内容。
有关特定于会议的 RSC 权限的详细信息,请参阅 聊天或会议的 RSC 权限。
当脚本或录制内容可用时收到通知
配置权限后,将应用配置为接收脚本和录制可用事件或所有相关会议事件的 更改通知 。 通知包含有助于访问脚本内容和录制的会议 ID 和组织者 ID。 当会议结束后生成会议时,应用可以提取会议脚本和录制内容。 脚本的内容以文件形式 .vtt
提供。 会议的录制以文件形式 .mp4
提供。
你可以对应用使用以下类型的更改通知:
订阅范围 | 说明 | 支持的资源路径 |
---|---|---|
租户级 | 脚本或录制内容可用于租户的任何联机会议。 | • 组织中的所有脚本: communications/onlineMeetings/getAllTranscripts • 组织中的所有录制内容: communications/onlineMeetings/getAllRecordings |
会议级别 | 脚本或录音可用于特定的联机会议。 | • 特定会议的所有脚本: communications/onlineMeetings/{onlineMeetingId}/transcripts • 特定会议的所有录制内容: communications/onlineMeetings/{onlineMeetingId}/recordings |
用户范围 | 脚本或录音可用于由特定用户组织的任何联机会议。 | • 在由特定用户组织的会议中可用的通话记录: users/{userId}/onlineMeetings/getAllTranscripts • 在由特定用户组织的会议中可用的通话记录: users/{userId}/onlineMeetings/getAllRecordings |
应用范围 | 脚本或录制内容可用于安装了特定 teams 应用的任何会议。 | • 在安装了特定 Teams 应用的会议中可用的通话记录: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTrancripts • 在安装了特定 Teams 应用的会议中可用的通话录制: appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings |
有关应用如何在联机会议结束后知道脚本或录制内容何时可用的详细信息,请参阅 在脚本和录制内容可用时收到通知。
有关应用如何知道会议何时结束的详细信息,请参阅订阅更改通知和使用 Bot Framework 获取会议 ID 和组织者 ID。
注意
对于特定于会议的 RSC 应用程序权限和组织范围的应用程序权限,调用 Graph API 以访问和检索脚本和录制的过程保持不变。 这些 API 仅支持已安排的会议。