Часто задаваемые вопросы об API записей вызовов Microsoft Graph

В этом разделе содержатся ответы на часто задаваемые вопросы об API записей вызовов в Microsoft Graph.

Что такое API записей вызовов Microsoft Graph?

API записей вызовов Microsoft Graph предлагает аналитические сведения об использовании и диагностике для звонков и собраний по сети, которые происходят в вашей организации при использовании Microsoft Teams или Skype для бизнеса. Организации, также называемые "арендаторами", могут использовать API записей вызовов для подписки на, перечисления, извлечения записей вызовов по идентификаторам вызовов и поиска вызовов участника. Дополнительные сведения см. в статье Работа с API записей вызовов в Microsoft Graph.

Какое разрешение требуется для использования API записей вызовов?

Приложению требуется разрешение CallRecords.Read.All для доступа к записям вызовов в Microsoft Graph. Администратор должен предоставить это разрешение приложению. Дополнительные сведения см. в статье Справочник по разрешениям Microsoft Graph.

Можно ли использовать делегированные разрешения с API записей вызовов?

Нет, API записей вызовов не поддерживает делегированные разрешения.

Почему я не могу использовать делегированные разрешения с API записей вызовов?

Вы не можете использовать делегированные разрешения, так как невозможно ограничить разрешение CallRecords.Read.All определенными вызовами или пользователями. Разрешение приложения предоставляется на уровне организации, а не на уровне отдельного пользователя.

Разделы справки запросить запись вызова с помощью API записей вызовов?

Чтобы запросить запись вызова, необходимо выполнить запрос к конечной GET точке /communications/callRecords/{id} , где {id} является уникальным идентификатором вызова. Убедитесь, что у вас есть разрешение CallRecords.Read.All и включите заголовок Authorization с допустимым маркером носителя. Дополнительные сведения см. в документации по get callRecord.

Где можно найти идентификаторы вызовов, выполненных в моей организации?

Найти и собрать идентификаторы вызовов можно следующими способами:

• Подписка на уведомления. Подпишитесь на веб-канал уведомлений об изменениях и получайте уведомления, содержащие идентификаторы вызовов при создании новой записи звонка.
• Список записей вызовов. Получите список идентификаторов вызовов, запросив его из API list callRecords.
• Поиск вручную. Если у вас есть доступ к аналитике звонков в Центре Администратор Teams для Microsoft Teams, вы можете вручную найти идентификатор звонков в журнале пользователя. Однако автоматизированная система для получения всех идентификаторов вызовов из Аналитики вызовов не доступна.
• Используйте callChainId:: найдите идентификатор вызова с помощью callChainId из API вызова Get после завершения вызова. Используйте этот подход, если вызов создан программным способом и вы работаете с типом ресурса вызова. Кроме того, объект может отличаться от идентификатора callChainId записи вызова в некоторых сценариях, таких как вызовы передачи, из-за особенностей архитектуры. Поэтому по возможности используйте другие методы в этом списке.

Когда доступна запись звонка?

Как правило, создается первая версия записи звонка, и уведомление отправляется в течение 30 минут после завершения вызова. Тем не менее, служба может занять до 150 минут, чтобы сделать запись звонка доступной. Дополнительные сведения см. на странице Задержка .

Как долго хранятся записи вызовов?

Записи вызовов хранятся в течение 30 дней после завершения вызова.

Можно ли получить записи звонков старше 30 дней?

Нет, API записей вызовов не возвращает записи вызовов старше 30 дней. Запросы таких записей приводят к ошибке 404 Not Found .

Почему мое уведомление о записи первого звонка задерживается?

Уведомление о записи звонка может быть отложено, так как служба может сделать первую версию записи звонка доступной до 150 минут. Если при доставке первой версии записи вызовов возникает более длительная задержка, проверка о сбоях, о которых сообщила команда API записей вызовов на вкладке Работоспособностьна портале Teams Администратор. Кроме того, вы можете открыть запрос в службу поддержки с помощью команды API записей звонков.

Почему последующие версии записи звонка задерживаются?

Последующие версии записи вызова могут быть доставлены после начальной задержки в 150 минут. Это означает, что, хотя первая версия доступна в течение 150 минут, более поздние обновления записи вызова могут появиться позже из-за задержки телеметрии от клиента и других факторов.

Почему в записи вызова отсутствуют поля?

В записи вызова могут отсутствовать поля из-за задержки телеметрии клиента. Когда новые данные телеметрии становятся доступными, система создает новую запись вызова с обновленными сведениями version , увеличивает значение свойства и отправляет вам обновленную запись вызова. Если в записи звонка отсутствуют свойства, дождитесь следующей версии записи вызова.

Однако важно отметить, что некоторые поля могут оставаться пустыми по умолчанию или потому, что данные телеметрии клиента так и не поступили, например значения потока мультимедиа.

Если отсутствуют критически важные или ранее доставленные поля, отправьте запрос в службу поддержки с командой API записей вызовов.

Как получить список всех участников, которые приняли участие в вызове?

Для вывода списка всех участников вызовов можно использовать следующие методы:

1. API participants_v2 списка

   Используйте API списка participants_v2 для сбора полного списка участников для запрошенного идентификатора вызова.

2. Используйте параметр запроса OData $expand для объекта callRecords, чтобы развернуть свойство participants_v2

   Вы можете вызвать вызов GET communications/callRecords/{id}?$expand=participants_v2 , чтобы получить сведения о звонках высокого уровня вместе со списком участников.

3. Создание настраиваемого списка участников

   Чтобы просмотреть всех участников, реализуйте пользовательское решение для создания списка участников из данных записей вызовов:

   1. Вызовите API Get callRecord и разверните sessions свойство : GET /communications/callRecords/{id}?$expand=sessions.
   2. Для одноранговых вызовов (P2P) считывайте caller свойства и callee из каждого session полученного sessions списка. Для вызовов собраний caller считывайте только свойство .
   3. Создайте настраиваемый список участников на основе удостоверения конечной caller точки. Для вызовов P2P также включается удостоверение конечной callee точки. idСоберите свойства , и другие свойства, displayNameнеобходимые для каждого участника.

Почему я не вижу всех участников, которые присутствовали на вызове при вызове списка participants_v2 API?

Возможно, вы не увидите всех участников, так как API списка participants_v2 поддерживает разбиение на страницы, ограничивая количество участников в ответе до 130 на страницу. Если в вызове было более 130 пользователей, ответ первой записи вызова содержит 130 участников вместе со свойством @odata.nextLink . Это свойство включает URL-адрес для вызова API и получения следующего набора участников. Продолжайте этот процесс до тех пор, пока следующая ссылка не будет пустой, что указывает на отсутствие участников для извлечения.

Почему для одной записи вызова возвращаются повторяющиеся сеансы?

Сеанс записи вызовов уникально представляет один обмен данными между пользователем и пользователем в одноранговых вызовах или один обмен данными между пользователями и службами в групповом звонке или собрании. Однако в некоторых сценариях вызовов взаимодействие между пользователем и службой может включать несколько удостоверений служб в одном сеансе, например виртуальную передачу между автосекретарем и очередью вызовов. В этих сценариях идентификатор сеанса может дублироваться один или несколько раз, чтобы правильно представить каждое удостоверение, участвующее в обмене данными, и соответствующую продолжительность обмена данными.

Почему появляется сообщение об ошибке 404 Not Found?

Ниже приведены некоторые причины, по которым может возникнуть 404 Not Found ошибка.

• Недавний вызов. Если вызов был выполнен в течение последних 150 минут, запись вызова может быть еще не создана. Подождите 150 минут после завершения вызова и повторите попытку.
• Старый вызов. Если вызов старше 30 дней, API записей вызовов возвращает ошибку 404 Not Found по умолчанию.
• Другие проблемы. Если ни один из причин не применим, проверка о каких-либо сбоях, о чем сообщила команда API записей вызовов на вкладке Работоспособностьна портале Teams Администратор. Кроме того, вы можете отправить запрос в службу поддержки с помощью команды API записей звонков.