Работа с Microsoft Teams при помощи API Microsoft Graph

  • Статья

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Microsoft Teams — это рабочее пространство с чатами в Microsoft 365, обеспечивающее встроенный доступ к календарям команд, файлам, заметкам OneNote, планам Планировщика, расписаниям Смен и многому другому. Вы можете использовать microsoft API Graph для интеграции с функциями Microsoft Teams.

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

В следующей таблице перечислены распространенные варианты использования API Microsoft Teams в Microsoft Graph.

Варианты использования Ресурсы REST См. также
Создание команд, групп и каналов и управление ими команда, канал, группа создание команды, перечисление команд, создание канала
Добавление вкладок, управление и установка приложений в каталоге приложений Microsoft Teams teamsTab, teamsAppInstallation создание teamsTab, перечисление teamsTab, список установленных приложений
Создание каналов и чатов для отправки и получения сообщений чата channel, chat, chatMessage создание канала, перечисление канала, отправка chatMessage в канале
Использование тегов для классификации пользователей или групп на основе общих атрибутов в команде teamworkTag, teamworkTagMember list teamworkTag, create teamworkTag
Создание и прием звонков, запись звонков или получение координат собраний call, callRecords ответить, пригласить участников
Подключение ботов к вызовам и реализация интерактивного голосового ответа (IVR) call Сценарии IVR
Создание и получение собраний по сети или проверка присутствия и активности пользователей onlineMeeting, присутствие создание onlineMeeting, meetingAttendanceReport
Создание интеграции сотрудников и управление ими с помощью смен, расписаний, карточек времени или отгулов в организации workforceIntegration, schedule, shift, timeOff, timeOffReason create workforceIntegration, create schedule, create shift, create timeOff
Используйте API обучения сотрудников для интеграции с Viva Learning обучение сотрудников, обучениеProvider, обучениеContent list learningProviders, list learningContents

Сценарии IVR

Ниже приведены сценарии интерактивного голосового ответа (IVR), поддерживаемые API-интерфейсами вызова в Microsoft Graph.

  • Воспроизведение звукового запроса , например, когда звонок помещается в очередь агента обслуживания клиентов.
  • Запись ответа — например, для записи звука вызывающего абонента, как правило, после того, как он услышал подсказку с параметрами.
  • Подписывайтесь на тона . Например, если вы хотите узнать, какие тоналы DTMF выбрано вызывающей стороны, обычно после прослушивая звукового запроса.
  • Отмена обработки мультимедиа — например, если требуется отменить все операции playPrompt или recordResponse , которые могут быть в процессе.

Ограничения Microsoft Teams

Протестированные ограничения производительности (мощности) Microsoft Teams описаны в статье Ограничения и спецификации для Microsoft Teams. Эти ограничения применяются при непосредственном использовании Microsoft Teams или с помощью API Microsoft Graph. Так как у каждой команды есть соответствующая группа, а каждая группа является объектом каталога, ограничение количества групп и количества объектов каталога ("ресурсов") может также оказывать влияние.

Файлы в каналах хранятся в SharePoint; при этом применяются ограничения SharePoint Online.

См. также Ограничения регулирования для служб Microsoft Teams.

Команды и группы

В Microsoft Graph приложение Microsoft Teams представлено ресурсом group. Команды Microsoft Teams и группы Microsoft 365 предназначены для различных требований совместной работы в группе. Почти всех групповые функции применимы к командам Microsoft Teams и группам Microsoft 365, например календарь группы, файлы, заметки, фотографии, планы и т. д. Основное различие между командой и группой Microsoft 365 состоит в режиме общения участников. Участники команды общаются в сохраняемом чате в контексте определенной команды. Участники группы Microsoft 365 общаются с помощью групповых бесед, то есть бесед по электронной почте, которые осуществляются в контексте группы в Outlook.

У любой группы, содержащей команду, есть свойство resourceProvisioningOptions со значением Team.

Примечание. Свойство Group.resourceProvisioningOptions можно изменить. Не добавляйте и не удаляйте значение Team из этой коллекции; в противном случае вы получите неправильные результаты при перечислении всех команд.

Ниже указаны различия на уровне API между командами и группами.

Изменение состава участников в Microsoft Teams

Вариант использования Глагол URL-адрес
Добавление участника POST /teams/{team-id}/members
Удаление участника DELETE /teams/{team-id}/members/{membership-id}
Обновление роли участника PATCH /teams/{team-id}/members/{membership-id}
Обновление команды PATCH /teams/{team-id}

Требования к опросу

Если приложение опрашивает вас на предмет изменения ресурса, это можно делать раз в день. (teamsAsyncOperation является исключением из общего правила, так как опрашивается часто.) Если нужно узнавать об изменениях чаще, создайте подписку на этот ресурс и получайте уведомления об изменениях (веб-перехватчики). Если вы не нашли поддержку для нужного типа подписки, рекомендуем оставить свой отзыв на форуме идей платформы для разработчиков Microsoft 365.

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

При опросе для ресурса раз за разом выполняется операция GET, чтобы проверить, не изменился ли он. Операцию GET разрешается выполнять на одном и том же ресурсе несколько раз в день, пока не проводится опрос. Например, можно использовать GET /me/joinedTeams каждый раз, когда пользователь посещает или обновляет веб-страницу, но не рекомендуется каждые 30 секунд обновлять веб-страницу в цикле GET /me/joinedTeams.

Если приложения не удовлетворяют требованиям опроса, это будет рассматриваться как нарушение условий использования API Майкрософт. Такое нарушение может привести к дополнительному регулированию, а также приостановке или прекращению использования API Майкрософт.

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