Работа с API облачных коммуникаций в Microsoft Graph

  • Статья

API облачных коммуникаций в Microsoft Graph добавляет новое измерение для взаимодействия приложений и служб с пользователями путем использования основных возможностей общения в приложениях и службах. Этот API можно использовать для создания и приема звонков, а также для создания и получения координат собраний.

API облачных коммуникаций можно использовать для создания служебных приложений (ботов), выполняющих роль участников в звонке, а также создающих собрания и получающих приглашения на них от имени пользователей. Этот API предоставляет функции звонков, а также возможность создавать собрания по сети и получать приглашения на них. С помощью этого API можно использовать служебные приложения (боты), при этом боты могут участвовать в звонках VoIP или собраниях Microsoft Teams.

Важно!

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

Авторизация

Для доступа к API облачных коммуникаций требуется одно из указанных ниже разрешений. Эти разрешения должны предоставляться администратором.

Сценарий Разрешения
Записи звонков CallRecords.Read.All
Звонки Calls.JoinGroupCallAsGuest.All, Calls.JoinGroupCall.All, Calls.Initiate.All, Calls.InitiateGroupCall.All, Calls.AccessMedia.All
Собрания OnlineMeetings.ReadWrite.All, OnlineMeetings.Read.All
Присутствие Presence.Read, Presence.Read.All

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

В таблице ниже перечислены некоторые распространенные варианты использования API облачных коммуникаций.

Варианты использования Ресурсы REST См. также
Создание приватных и групповых звонков, а также присоединение к ним Звонок Методы звонков
Звонки с интерактивным речевым взаимодействием Методы для интерактивного речевого взаимодействия
Элементы управления звонком (участник) Участник
Собрания onlineMeeting Методы для собраний
Получение записей звонков callRecord Подписки веб-перехватчиков
Присутствие presence

Общие свойства

Ресурс Свойства
call свойства объекта call
participant свойства объекта participant
onlineMeeting свойства объекта onlineMeeting
callRecord Свойства callRecord
presence presence

Связанные материалы