Обзор API Microsoft TeamsMicrosoft Teams API overview

Microsoft Teams — это единый центр для работы в группах и интеллектуального обмена данными.Microsoft Teams is the ultimate hub for teamwork and intelligent communications. В основе Microsoft Teams лежат мощь и масштаб Microsoft 365 с более чем 120 млн пользователей. В нем имеются средства для совместной работы на основе чатов, собраний, звонков и корпоративные голосовые функции.Built on the strength and scale of Microsoft 365 with over 120 million users, Microsoft Teams delivers chat-based collaboration, meetings, calling, and enterprise voice features.

Зачем выполнять интеграцию с Microsoft Teams?Why integrate with Microsoft Teams?

Автоматизация жизненных циклов командAutomate team lifecycles

Если у вас возникла новая бизнес-проблема, с помощью Microsoft Graph вы можете создать виртуальную команду, добавить в нее нужных пользователей и настроить каналы, вкладки и приложения для команды.Use Microsoft Graph to create a new virtual team when a new business issue arises, add the right people to the team, and configure the team with channels, tabs, and apps. Если вы хотите привлечь участников команды к обсуждению бизнес-проблемы, добавьте новое событие в календарь команды.If you want to get the new team together to discuss the business issue, add a new event to the team calendar.

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

После того как бизнес-проблема решена, и вам больше не нужна команда, вы можете выполнить архивацию или удаление команды с помощью API Microsoft Teams.When the business issue is resolved and you no longer need the team, use the Microsoft Teams API to archive or delete the team. Если при создании команды вы заранее знаете максимальный срок ее работы, настройте для нее политику завершения срока действия групп в Microsoft 365, благодаря которой команда будет автоматически удалена согласно параметрам политики.If you know the maximum duration of the team when you create it, set an Microsoft 365 group expiration policy for the team that automatically removes the team according to the policy.

Выполнение работы в отсутствие пользователейGet work done even when no one is around

Используйте разрешения приложений для работы с командами, каналами и вкладками без человеческого вмешательства.Use application permissions to work with teams, channels, and tabs without human intervention. Создайте канал, если ваш клиент разместил заказ.Create a new channel when your customer files an order. Автоматически создавайте команды для занятий в начале учебного года и архивируйте их в конце.Automatically create teams for classes at the beginning of the school year, and archive them at the end.

Создание команд, связанных с приложениемCreate teams linked to your app

Разрешите пользователям создавать новые команды и каналы.Let customers to create new teams and channels. Установите ваше приложение Teams в новых командах.Install your Teams app in the new teams. Закрепите приложение на вкладке в новом канале.Pin your app to a tab in the new channel. Отправляйте сообщения в канал со ссылкой, возвращающей на ваш веб-сайт.Send messages to the channel linking back to your website.

Создание нескольких команд и каналов и управление имиCreate and manage multiple teams and channels

Microsoft Graph упрощает создание большого количества команд и наполнение их пользователями и каналами путем автоматического создания и управления командами, каналами, вкладками и приложениями.Microsoft Graph makes it easy to create large numbers of teams and populate them with users and channels, by automate creating and managing teams, channels, tabs, and apps. С помощью Microsoft Graph также можно искать и архивировать команды, которые больше не используются.Microsoft Graph also lets you find and archive the teams you are no longer using. Это тот же API, на основе которого созданы Центр администрирования Microsoft Teams и командлеты PowerShell Teams.This is the same API that the Microsoft Teams Admin Center and Teams PowerShell commandlets are built on.

Разворачивание приложений в командахDeploy apps to teams

Перечислите команды в вашем клиенте и установите приложения для них.List the teams in your tenant, and install apps to them. Создайте вкладки в каналах, чтобы предоставить пользователям удобный доступ к приложениям.Create tabs in channels to give users easy access to apps.

Использование Microsoft Graph в приложениях любого типаUse Microsoft Graph in any kind of app

Приложения Microsoft Teams предоставляют рабочим группам новое средство для повышения эффективности совместной работы.Microsoft Teams apps give work groups a new tool to make collaboration a more productive and compelling experience. С помощью этих приложений пользователи в рабочих группах могут делиться ресурсами, взаимодействовать друг с другом в чате и планировать мероприятия в календаре группы.These apps let work group users share assets, interact through chat, and schedule events on the team calendar. С помощью этих приложений можно также автоматизировать создание команд, каналов и бесед, расширяя возможности Microsoft Teams.These apps can also automate creating teams, channels, and conversations, enhancing the value of Microsoft Teams.

Можно создавать веб-сайты, службы и приложения на собственной платформе, работающие за пределами интерфейса Microsoft Teams, а также вызывать API Teams для автоматизации сценариев Teams.You can create web sites, services, and native platform applications that run outside the Microsoft Teams user experience, and call the Teams API to automate Teams scenarios.

Типы приложений, которые разрешено использовать в Microsoft TeamsTypes of apps enabled for Microsoft Teams

Вызов API Microsoft Teams из вкладок, ботов, веб-сайтов и служб

Эти средства совместной работы включают вкладки или ботов с поддержкой Microsoft Graph, работающих в приложениях Microsoft Teams.These collaboration tools include Microsoft Graph-enabled tabs or bots running inside Microsoft Teams apps. Кроме того, вы можете вызывать Microsoft Graph из-за пределов приложения Microsoft Teams, например с веб-сайта или из веб-службы.You can also call Microsoft Graph outside of a Microsoft Teams app, such as from a website or a web service. Если вы уже включили поддержку Microsoft Graph на своем веб-сайте, вы можете использовать ее для работы с Microsoft Teams. Для этого с помощью платформы разработки Microsoft Teams создайте вкладку, использующую существующий код веб-сайта.If you've already enabled your website for Microsoft Graph, you can use that work for Microsoft Teams by using the Microsoft Teams developer platform to create a tab that uses the existing website code.

API Microsoft Teams могут расширять возможности приложений внутри и за пределами Teams:Microsoft Teams APIs can enhance apps inside and outside of Teams:

Тип приложенияApp type Описание сценарияScenario description
ВкладкиTabs Отображение содержимого в Microsoft Teams.Surface your content in Microsoft Teams.
БотыBots Помощь пользователям в выполнении их задач в беседах.Help users get tasks done in conversations.
СоединителиConnectors Публикация обновлений из внешних служб в каналах.Post updates from external services to channels.
Сообщения с действиямиActionable messaging Добавление расширенного взаимодействия в карточки соединителей.Add enhanced interaction to your connector cards.
Расширения для системы обмена сообщениямиMessaging extensions Разрешение пользователям запрашивать сведения и делиться ими в беседах.Allow users to query and share information in conversations.
Веб-сайтыWebsites Предоставление доступа к расширенному контенту на ваших веб-страницах.Surface enhanced content in your web pages.
СлужбыServices Дополнение клиентских приложений данными из Microsoft Graph через веб-службу.Enhance your client applications with Microsoft Graph data via your web service.
Веб-канал активностиActivity feed Привлечение пользователей с помощью уведомлений в веб-каналах.Engage users via feed notifications.
Звонки и собрания по сети (предварительная версия)Calling and online meetings (preview) Создание приложений Microsoft Teams с ботами, которые могут начинать аудио- или видеозвонки и участвовать в них, направлять и передавать звонки с учетом потоков интерактивной обработки голоса (IVR), а также участвовать в собраниях по сети.Create Microsoft Teams apps with bots that can initiate and participate in audio/video calls, route/transfer calls based on interactive voice response (IVR) flows, and participate in online meetings.

Получение уведомлений об измененияхGet notified about changes

Microsoft Teams поддерживает подписку на изменения (создание, обновление и удаление) в сообщениях каналов и чатов, чтобы разрешить приложениям получать обновления почти мгновенно.Microsoft Teams supports subscribing to changes (create, update, and delete) to messages in channels and chats to allow apps to get near-instant updates. Сведения о том, как подписаться на изменения, см. в статье Получение уведомлений об изменениях для сообщений в каналах и чатах.For details about how to subscribe to changes, see Get change notifications for messages in channels and chats.

Справочник по APIAPI reference

Ищете справочные материалы по API для этой службы?Looking for the API reference for this service?

См. статью API Teams в Microsoft Graph.See the Teams API in Microsoft Graph.

Дальнейшие действияNext steps