通过

使用 Graph API 获取会议脚本和录制内容

注意

用于提取会议脚本和录制的 API 是按流量计费的 API。 有关详细信息，请参阅 会议 API 的付款模型。

现在可以将应用配置为在会议或通话结束后提取Microsoft Teams 脚本和录制内容。 应用可以使用 Microsoft Graph REST API 访问和提取为以下实例生成的脚本和录制内容：

  • 安排的联机会议
  • 临时呼叫

用例

下面是使用 图形 API 提取会议脚本和录制的一些用例。

用例 说明 API 如何提供帮助
自动提取 计划实例 （如联机会议）的会议脚本和录制内容 作为销售经理，你需要获取脚本和录制内容，以便从销售垂直的多个会议中捕获有意义的见解。 对所有会议保持一个选项卡，并手动从中检索会议脚本和录制内容以获取有用的信息既耗时又效率低下。 在应用中使用 Graph API 自动从与你的用途相关的所有会议中提取会议脚本和录制内容。 你的应用接收会议通知，并在会议结束后生成脚本和录制内容时获取脚本和录制内容。
然后，此数据可用于获取：
• 聚合见解和智能分析
• 新的潜在顾客和亮点
• 会议跟进和摘要
为联机会议等 计划实例 在会议后提取脚本和录制内容 作为人力资源计划，你将召开一个集思广益的会议，以了解和提高员工的健康状况和工作效率。 在讨论结束后，你需要分析讨论，以收集用于规划改进的数据点。 必须不断做笔记以提供会后摘要可能会阻碍思想的流动，你可能无法捕获所有有价值的建议。 使用应用中的 Graph API 在会议后提取脚本和录制内容，使你和参与者能够完全专注于讨论。 会议脚本和录制内容可用于：
• 参与度和情绪分析
• 列出任务或问题
• 后续会议和通知
为 计划实例 （如联机会议）创建个性化应用 作为一家领先的科技公司的销售人员，你必须与客户联系并达成交易。 由于通过 Teams 和 Outlook 日历安排了许多会议，因此参加所有通话并随时了解讨论和最新更新至关重要。 创建具有以下功能的应用：
• 使用 Teams 或 Outlook 日历安排会议时通知你。
• 允许应用为这些会议设置 AutoRecording=true 。
• 将机器人添加为会议参与者，以显示一个横幅，指示正在录制会议以及应用使用内容进行分析。
• 允许应用访问会议录制和脚本。
• 允许应用无需管理员批准 OnlineMeetingRecording.Read.All 权限，因为获取这些权限的管理员批准可能很耗时。
下面是展示此用例方案 的示例应用 。
在会议后为临时实例提取脚本和录制内容 作为项目经理，你的角色要求你进行自发的分组或一对一呼叫，这些呼叫不能事先安排。 如果没有会议邀请，则不会生成会议 ID，因此无法访问脚本和录制内容。 关闭大量笔记留下许多空间，可以错过关键作项目。 使用应用中的 Graph API 在会议后提取脚本和录制内容，使你和参与者能够完全专注于讨论。 通过使用权限 CallTranscripts.Read.All 和 CallRecordings.Read.All，呼叫脚本可用于：
• 捕获重要作项
• 列出要办事项或问题
• 后续会议和通知
获取 PSTN 呼叫的通话后脚本和录音 你有一个呼叫中心，人工助理在其中使用 Microsoft Teams 通过传入或传出 PSTN 呼叫提供客户支持。 助理需要手动更新外部记录系统，其中包含通话结束后每个通话的备注。 在调用后使用应用中的 Graph API 提取脚本和录制内容可以减少每个助手更新记录所需的手动工作。 此外，它允许你的应用使用呼叫脚本触发自动化。

获取会议和通话记录和录音

若要提取特定会议和通话的脚本和录制内容，请执行以下作：

  1. 配置Microsoft Entra ID访问脚本和录制的权限
  2. 会议脚本和录制内容可用时收到通知
  3. 使用图形 API 提取脚本
  4. 使用 Graph API 提取录制

配置Microsoft Entra ID访问脚本和录制的权限

你的应用必须具有提取脚本和录制所需的权限。 它可以使用组织范围内的应用程序权限或特定于资源的同意来访问和提取 Teams 会议的脚本和录制内容， (RSC) 特定会议的应用程序权限。

注意

  • 上述资源需要 (并行) OnlineMeetings 的新权限adhocCalls。
  • 订阅两个单独的、范围适当的资源， (一个用于 onlineMeetings 订阅，另一个用于 adhocCalls) 。 这些资源提供用于提取数据的 URL。

使用组织范围的应用程序权限

对于联机会议和通话，可以将应用配置为访问整个租户的会议脚本和录制内容。 在这种情况下，会议组织者无需在 Teams 会议聊天中安装应用。 当管理员授权组织范围的应用程序权限时，你的应用可以读取和访问租户中所有会议的脚本和录制内容。

有关可授予应用的组织范围应用程序权限的详细信息，请参阅 联机会议权限。

注意

临时调用允许基于应用的权限和用户委托的权限。

使用特定于会议的 RSC 应用程序权限

如果希望应用仅提取安装它的 Teams 会议的脚本和录制内容，请为应用配置特定于会议的 RSC 权限。 授权用户可以在会议聊天中安装应用。 会议结束后，应用可以进行 API 调用，以获取该会议的脚本和录制内容。

有关特定于会议的 RSC 权限的详细信息，请参阅 聊天或会议的 RSC 权限。

注意

临时调用的基于 RSC 的权限未启用。

当脚本或录制内容可用时收到通知

配置权限后，将应用配置为在可用或所有相关会议和临时呼叫时接收脚本和录制 的更改通知 。 对于联机会议，通知包含有助于访问脚本内容和录制的会议 ID 和组织者 ID。 在会议结束后生成会议时，应用可以提取会议脚本和录制内容。 对于临时呼叫，会议 ID 不可用，因为这些是 PSTN、1：1、组呼叫) (自发事件。 虽然对临时调用的通知路径没有限制， getAll 但 API 不适用于临时调用实例， (例如，调用级别的项目列表) 。 脚本的内容以文件形式 .vtt 提供。 会议的录制以文件形式 .mp4 提供。

你可以对应用使用以下类型的更改通知：

订阅范围 说明 支持的资源路径
租户级 脚本或录制内容可用于租户的任何联机会议或通话。 组织中的所有脚本：
• 对于联机会议： communications/onlineMeetings/getAllTranscripts
• 对于呼叫： communications/adhocCalls/getAllTranscripts

组织中的所有录制内容：
• 对于联机会议： communications/onlineMeetings/getAllRecordings
• 对于呼叫： communications/adhocCalls/getAllRecordings
会议或通话级别 脚本或录音可用于特定会议或通话。
特定会议的所有脚本： communications/onlineMeetings/{onlineMeetingId}/transcripts

特定会议的所有录制内容： communications/onlineMeetings/{onlineMeetingId}/recordings

特定临时调用的所有脚本： /communications/adhocCalls/{callId}/transcripts

特定临时呼叫的所有录制： /communications/adhocCalls/{callId}/recordings
用户范围 脚本或录音可用于由特定用户发起的任何在线会议组织或临时呼叫。 在由特定用户组织的会议或由指定用户发起听录的通话中可用的通话记录：
• 对于联机会议： users/{userId}/onlineMeetings/getAllTranscripts
• 对于临时呼叫： users/{userId}/adhocCalls/getAllTranscripts

在由特定用户组织的会议或由指定用户发起听录的通话中可用的通话记录：
• 对于联机会议： users/{userId}/onlineMeetings/getAllRecordings
• 对于临时呼叫： users/{userId}/adhocCalls/getAllRecordings
应用范围 脚本或录制内容可用于安装了特定 teams 应用的任何会议。 不适用于临时调用。 在安装了特定 Teams 应用的会议中可用的通话记录：
• 对于联机会议： appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts

在安装了特定 Teams 应用的会议中可用的通话记录：
• 对于联机会议： appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings

有关应用如何在联机会议或临时呼叫结束后知道脚本或录制内容何时可用的详细信息，请参阅 在脚本和录制内容可用时收到通知。

有关应用如何知道会议何时结束的详细信息，请参阅订阅更改通知和使用 Bot Framework 获取会议 ID 和组织者 ID。

重要

  • 对于特定于会议的 RSC 应用程序权限和组织范围的应用程序权限，调用 Graph API 以访问和检索脚本和录制的过程保持不变。
  • 这些 API 仅在 beta 版中支持私人聊天会议、频道会议和临时呼叫。
  • 对于即席呼叫：

获取联机会议实例的 AI 生成的会议摘要

你的应用可以直接提取 AI 生成的会议摘要，包括使用会议AI 见解 API 的对话摘要、作项和提及。 有关详细信息，请参阅使用会议AI 见解 API 获取会议见解。

代码示例

示例名称 Description Node.js C#
联机会议脚本机器人 此示例应用使用Microsoft图形 API检索会议脚本并将其显示在对话框中。 View View
联机会议脚本录制 此示例应用使用 Graph API 检索 Teams 会议脚本和录制内容。 View View
即席呼叫脚本和录制 此示例应用使用 Graph API 检索临时呼叫（包括 PSTN、1：1 和群组呼叫）的会议脚本和录制内容。 View

后续步骤

会议脚本和录制内容可用时收到通知

另请参阅

  • Last updated on