Получение расшифровок и записей собраний с помощью API Graph

Важно!

Начиная с 25 августа 2025 г. API Teams, перечисленные в этой статье, больше не будут измеряться, и для использования этих API не требуется конфигурация выставления счетов. Если приложение настроено для выставления счетов, никаких действий не требуется. Эта статья предоставляется в качестве справочной информации по завершении окончательного цикла выставления счетов для API Microsoft Teams.

Теперь вы можете настроить приложение для получения расшифровок и записей Microsoft Teams после завершения собрания или звонка. Ваше приложение может использовать REST API Microsoft Graph для доступа и получения расшифровок и записей, созданных для следующих экземпляров:

  • Запланированное собрание по сети
  • Незапланированный вызов

Варианты использования

Ниже приведено несколько вариантов использования получения расшифровок и записей собраний с помощью API Graph.

Вариант использования Описание Чем полезны API-интерфейсы
Автоматически получать расшифровки и записи собраний для запланированных случаев, например собраний по сети Как менеджеру по продажам, вам как менеджеру по продажам необходимы расшифровки и записи для получения значимой аналитики из нескольких собраний по вертикали продаж. Отслеживание всех собраний и извлечение из них расшифровок и записей собраний вручную для получения полезной информации отнимает много времени и неэффективно. Используйте API Graph в своем приложении, чтобы автоматически получать расшифровки и записи всех собраний, имеющих отношение к вашей цели. Приложение получает уведомления о собраниях и получает расшифровку и запись, когда они создаются после окончания собрания.
Затем эти данные можно использовать для получения:
• Обобщенной аналитики и интеллектуального анализа
• Новых потенциальных клиентов и основных возможностей
• Следующих результатов и итогов собраний
Получение расшифровок и записей после собрания для запланированных случаев, например собраний по сети В качестве инициативы отдела кадров вы проводите мозговой штурм, чтобы понять и улучшить работоспособность и производительность сотрудников. После его завершения вам нужно будет проанализировать обсуждение, чтобы собрать точки данных для планирования улучшений. Необходимость постоянно делать заметки для предоставления сводки после собрания может затруднить поток мыслей, и вы можете не уловить все ценные предложения. Использование API Graph в вашем приложении для получения расшифровок и записей после собрания позволяет вам и участникам полностью сосредоточиться на обсуждении. Содержание стенограммы и записи собрания доступно для:
• Анализа вовлеченности и настроений
• Перечисления задач или проблем
• Дальнейших собраний и уведомлений
Создание персонализированного приложения для запланированных случаев , например собраний по сети Будучи продавцом в ведущей технологической компании, вы должны общаться с клиентами и заключать сделки. Поскольку в Teams и календаре Outlook запланировано множество собраний, очень важно присутствовать на всех звонках и быть в курсе обсуждений и последних обновлений. Создайте приложение со следующими возможностями:
• Уведомляет вас о назначенных собраниях с помощью календаря Teams или Outlook.
• Включите свое приложение для настройки AutoRecording=true этих собраний.
• Добавьте бота в качестве участника собрания, чтобы отображать баннер, указывающий, что собрание записывается и что содержимое используется вашим приложением для анализа.
• Разрешите приложению доступ к записям и расшифровкам собраний.
• Разрешите свое приложение, не требуя утверждения администратора для OnlineMeetingRecording.Read.All этих разрешений, так как получение одобрения администратора для этих разрешений может занять много времени.
Ниже приведен пример приложения , иллюстрирующий этот сценарий использования.
Получение расшифровок и записей после собрания для незапланированных экземпляров Роль менеджера проекта требует от вас спонтанных групповых или индивидуальных звонков, которые не могут быть запланированы заранее. Без приглашения на собрание идентификаторы собраний не создаются, поэтому доступ к расшифровкам и записям невозможен. Записывая объемные заметки, вы оставляете много места для пропуска важных действий. Использование API Graph в приложении для получения расшифровок и записей после собрания позволяет вам и участникам полностью сосредоточиться на обсуждении. С помощью разрешений CallTranscripts.Read.All и CallRecordings.Read.All, расшифровка звонка доступна для:
• Фиксация важных поручений
• Перечисление задач или вопросов
• Дальнейших собраний и уведомлений
Получение расшифровки и записей после звонка для вызовов по ТСОП У вас есть центр обработки вызовов, где помощники предоставляют поддержку клиентам, используя входящие и исходящие звонки по ТСОП с помощью Microsoft Teams. После его завершения помощникам необходимо вручную обновлять внешние системы записи с заметками о каждом звонке. Использование интерфейсов API Graph в приложении для получения расшифровки и записей после звонка сокращает объем ручной работы, необходимой каждому помощнику для обновления записей. Кроме того, это позволяет приложению запускать автоматизацию с помощью расшифровки вызовов.

Получение расшифровок и записей собраний и звонков

Чтобы получить расшифровку и запись определенного собрания и звонка:

  1. Настройка разрешений в Microsoft Entra ID для доступа к расшифровке и записи
  2. Получайте уведомления о доступности расшифровок и записей собраний
  3. Используйте API Graph для получения расшифровки
  4. Получение записей с помощью интерфейсов API Graph

Настройка разрешений в Microsoft Entra ID для доступа к расшифровке и записи

У вашего приложения должны быть необходимые разрешения для получения расшифровок и записей. Он может получать доступ к расшифровкам и записям собрания Teams и получать их, используя разрешения приложения для всей организации или разрешения приложения для конкретных ресурсов (RSC) для конкретного собрания.

Кроме того, доступ к расшифровкам и уведомлениям об изменении расшифровки регулируется двумя независимыми параметрами администратора клиента:

  • Доступ к расшифровкам через API Graph. Если этот параметр отключен, все запросы транскрибирования (метаданные metadataContentи content) возвращаются 403 Forbidden с GraphAccessToTranscriptsDisabled внутренним кодом ошибки, независимо от запрошенного формата.

  • Атрибуция говорящего. Если этот параметр отключен, содержимое расшифровки можно получить только без сведений о говорящем в этом формате application/vnd.microsoft.graph.transcript+text .

Дополнительные сведения см. в разделах о элементах управления администратора клиента в документации об изменениях, подписках на уведомления об изменениях и операции Get callTranscript.

Примечание.

  • Для указанных выше ресурсов требуются новые разрешения ( adhocCalls параллельно с OnlineMeetings).
  • Подпишитесь на два отдельных, соответствующих области ресурса (один для, а другой для onlineMeetingsadhocCalls). Эти ресурсы предоставляют URL-адреса для использования при извлечении данных.

Использование разрешений приложения для всей организации

Для собраний и звонков по сети можно настроить приложение для доступа к расшифровкам и записям собраний в клиенте. В этом случае организатору собрания не нужно устанавливать приложение в чате собрания Teams. Когда администратор авторизует разрешения приложения для всей организации, ваше приложение может читать и получать доступ к расшифровкам и записям всех собраний в клиенте.

Дополнительные сведения о разрешениях приложения в пределах организации, которые можно предоставить вашему приложению, см. в разделе "Разрешения на собрания по сети".

Примечание.

Для незапланированных вызовов разрешены разрешения на основе приложений и делегированные пользователю разрешения.

Использование разрешений приложений RSC для определенных собраний

Если вы хотите, чтобы приложение получало расшифровки и записи только для собрания Teams, на котором оно установлено, настройте для приложения разрешения RSC для конкретного собрания. Авторизованные пользователи могут установить ваше приложение в чате собрания. После завершения собрания приложение может выполнить вызов API, чтобы получить расшифровку и запись этого собрания.

Дополнительные сведения о разрешениях RSC для конкретных собраний см. в разделе Разрешения RSC для чата или собрания.

Примечание.

Разрешения на основе RSC для незапланированных вызовов не включены.

Получайте уведомления о доступности расшифровки или записи

Настроив разрешения, настройте приложение таким образом, чтобы оно получало уведомления об изменениях для расшифровок и записей, если они доступны, или все соответствующие собрания и незапланированные звонки. Для собраний по сети уведомления содержат идентификатор собрания и идентификатор организатора, которые помогают получить доступ к содержимому расшифровки и записи. Приложение может получить расшифровку и запись собрания, если они созданы после его окончания. Для незапланированных звонков идентификатор собрания будет недоступен, так как это спонтанные события (ТСОП, 1:1, групповые звонки). Хотя нет ограничений на путь уведомлений для незапланированных вызовов, API недоступны и для экземпляров незапланированного вызова (например, getAll перечисление артефактов на уровне вызова). Содержание расшифровки доступно в виде .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 для получения идентификатора собрания и идентификатора организатора".

Важно!

  • Процесс вызова API Graph для доступа и получения расшифровок и записей остается одинаковым как для разрешений приложения RSC, относящегося к собранию, так и для разрешений приложения для всей организации.
  • Эти API поддерживают собрания в закрытых чатах, собрания каналов и специальные вызовы только в бета-версии.
  • Незапланированные вызовы:

Получите сводки собраний, созданные искусственным интеллектом, для экземпляров собраний по сети

Ваше приложение может напрямую получать сводки собраний, созданные ИИ, включая сводки бесед, поручения и упоминания, с помощью API аналитики ИИ собраний. Дополнительные сведения см. в статье Получение аналитики собраний с помощью API аналитики ИИ собраний.

Примеры кода

Название примера Описание Node.js C# Python
Собрания ботов В этом примере демонстрируется, как обрабатывать события собраний в режиме реального времени и получать расшифровки собраний в Microsoft Teams. Просмотр Просмотр Просмотр
Записи стенограмм собраний по сети Этот пример приложения извлекает расшифровки и записи собраний Teams с помощью API Graph. Просмотр Просмотр Н/Д
Расшифровки и записи незапланированных звонков Этот пример приложения извлекает расшифровки и записи собраний с помощью API Graph для незапланированных вызовов, включая ТСОП, индивидуальные и групповые вызовы. Просмотр Недоступно Недоступно

Следующее действие

Получайте уведомления о доступности расшифровок и записей собраний

См. также

  • Последнее обновление: