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

Примечание.

API для получения расшифровок и записей собраний являются лимитными API. Дополнительные сведения см. в статье Модели оплаты для API-интерфейсов собраний.

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

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

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

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

Вариант использования Описание Как API-интерфейсы помогают
Автоматическое получение расшифровок и записей собраний для запланированных экземпляров, таких как собрания по сети Как менеджер по продажам, вам нужно получить расшифровки и записи для сбора значимой информации из нескольких собраний по вертикали продаж. Ведение вкладки на всех собраниях и извлечение расшифровок и записей собраний вручную для получения полезной информации занимает много времени и неэффективно. Используйте API Graph в приложении, чтобы автоматически получать расшифровки и записи собраний со всех собраний, соответствующих вашей цели. Ваше приложение получает уведомления о собраниях, а затем получает расшифровку и запись при создании собрания.
Затем эти данные можно использовать для получения:
• Обобщенной аналитики и интеллектуального анализа
• Новых потенциальных клиентов и основных возможностей
• Следующих результатов и итогов собраний
Получение расшифровок и записей после собрания для запланированных экземпляров, таких как собрания по сети В качестве инициативы отдела кадров вы проводите мозговой штурм, чтобы понять и улучшить работоспособность и производительность сотрудников. После его завершения необходимо проанализировать обсуждение, чтобы собрать точки данных для улучшения планирования. Необходимость постоянного создания заметок для предоставления сводки после собрания может помешать потоку мыслей, и вы можете не захватить все ценные предложения. Использование API Graph в приложении для получения расшифровок и записей после собрания позволяет вам и участникам полностью сосредоточиться на обсуждении. Содержимое расшифровки и записи собрания доступно для:
• Анализа вовлеченности и настроений
• Перечисления задач или проблем
• Дальнейших собраний и уведомлений
Создание персонализированного приложения для запланированных экземпляров, таких как собрания по сети Как продавец в ведущей технологической компании, вы должны связаться с клиентами и заключать сделки. Благодаря многочисленным собраниям, запланированным с помощью календаря Teams и Outlook, очень важно присутствовать на всех звонках и следить за обсуждениями и последними обновлениями. Создайте приложение со следующими возможностями:
• Уведомлять вас о планировании собрания с помощью Teams или календаря Outlook.
• Включите настройку AutoRecording=true приложения для этих собраний.
• Добавьте бота в качестве участника собрания, чтобы отобразить баннер, указывающий, что собрание записывается и что содержимое используется приложением для анализа.
• Разрешите приложению доступ к записям и расшифровкам собраний.
• Разрешите приложение, не требуя утверждения администратором OnlineMeetingRecording.Read.All разрешений, так как получение утверждения администратора для этих разрешений может занять много времени.
Ниже приведен пример приложения , демонстрирующего этот сценарий использования.
Получение расшифровок и записей после собрания для нерегламентированных экземпляров Как руководитель проекта, ваша роль требует от вас выполнять спонтанные групповые или один-на-один вызовы, которые невозможно запланировать заранее. Без приглашения на собрание идентификаторы собраний не создаются, поэтому доступ к стенограммам и записям невозможно. Снимая обильные заметки оставляет много места, чтобы пропустить критические элементы действий. Использование API Graph в приложении для получения расшифровок и записей после собрания позволяет вам и участникам полностью сосредоточиться на обсуждении. Используя разрешения и CallRecordings.Read.All, расшифровка CallTranscripts.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с ).
  • Подпишитесь на два отдельных ресурса с соответствующей областью (один для onlineMeetings и другой для adhocCalls). Эти ресурсы предоставляют URL-адреса для получения данных.

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

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

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

Примечание.

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

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

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

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

Примечание.

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

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

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

Важно!

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

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

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

Примеры кода

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

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

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

См. также

  • Last updated on