Коннектор Microsoft Teams

::: (информация) () Чтобы скачать приложение, посетите: Библиотека:::

Microsoft 365 Connector

Для интеграции с такими приложениями Microsoft, как Teams, Outlook и Office Suite.

Назначение

Используйте этот документ для интеграции приложений Tulip Apps с продуктами Microsoft 365, такими как Teams, Office Suite и Outlook.

Предварительные требования

::: (info) () Примечание: Перед использованием этого коннектора в Entra ID должна быть сгенерирована информация для аутентификации Oauth2. Следуйте этому руководству, чтобы сгенерировать необходимые учетные данные.
Подключение MS Graph API к Tulip с помощью Oauth2:::

API Doc

Документация Microsoft Graph API

Области, необходимые для этого коннектора

Функции коннектора

1) Получить все команды

Назначение

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

Конечная точка

HTTP GET вызов конечной точки - https://graph.micrsoft.com:443/v1.0/me/joinedTeams.

Требуемый ввод

Входные данные не требуются

Требуемый выходной экстрактор

1. teamID: Уникальный идентификатор команды, которая будет использоваться для выполнения других задач.
2. teamName: Отображаемое имя команды.
3. teamDescription: Описание команды.

2) Получить все каналы команды

Назначение

Этот коннектор получит все каналы команды, передав ей на вход идентификатор teamID.

Конечная точка

HTTP GET вызов конечной точки - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

Необходимые входные данные

Ниже перечислены параметры URL, которые необходимо передать

1. Идентификатор команды

Требуемый выходной экстрактор

1. channelId: Уникальный идентификатор канала, который будет использоваться для выполнения других задач.
2. channelName: Отображаемое имя канала.
3. channelDescription: Описание канала.

3) Создание нового канала

Назначение

1. Пользователи могут передать ID команды, название канала и описание канала в качестве входных данных, и Tulip создаст новый канал с указанным названием канала. Ответом API будут метаданные и различные свойства канала. Эти данные могут быть использованы для получения и обновления данных из канала.
2. Информация, полученная из Microsoft Graph V1.0 API, может быть использована в приложениях Tulip, таблицах Tulip или переменных Tulip, которые будут переданы в другие функции коннектора.

Конечная точка

HTTP POST вызов конечной точки - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels.

Необходимые входные данные

Ниже перечислены параметры, которые отправляются в теле запроса

1. ID команды
2. Название канала
3. Описание канала

Требуемый выходной экстрактор

1. channelId: Уникальный идентификатор канала, который будет использоваться для выполнения других задач.
2. channelName:Отображаемое имя канала.
3. channelDescription:Описание канала.

4) Обновление свойств канала

Назначение

1. Пользователи могут передать ID команды, ID канала, название нового канала и описание нового канала в качестве входных данных, и Tulip обновит новый канал с указанным названием и описанием. Ответом API будут метаданные и различные свойства канала. Эти данные могут быть использованы для получения и обновления данных из канала.
2. Информация, полученная из Microsoft Graph V1.0 API, может быть использована в приложениях Tulip, таблицах Tulip или переменных Tulip, которые будут переданы в другие функции коннектора.

Конечная точка

HTTP PATCH-вызов конечной точки https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}.

Необходимые входные данные

Ниже перечислены параметры, которые передаются как часть URL и/или тела запроса

1. Идентификатор команды
2. Идентификатор канала
3. Имя канала
4. Описание канала

Требуемый экстрактор вывода

Мы не требуем никакого экстрактора вывода.

5) Отправить сообщение на канал

Назначение

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

Конечная точка

HTTP POST вызов конечной точки - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages

Необходимые входные данные

Ниже перечислены параметры, которые отправляются как часть URL и/или тела запроса

1. Идентификатор команды
2. Идентификатор канала
3. Тема
4. Содержание сообщения

Требуемый экстрактор вывода

Нам не требуется никакой экстрактор вывода.

6) Получить все сообщения определенного канала

Назначение

Этот коннектор будет получать все сообщения с определенного канала.

Конечная точка

HTTP GET вызов конечной точки - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}/messages

Требуемый ввод

Ниже перечислены параметры URL, которые необходимо передать.

1. Идентификатор команды
2. Идентификатор канала

Требуемый выходной экстрактор

1. messageId: Уникальный идентификатор сообщения, которое будет использоваться для выполнения других задач.
2. messageContent: Содержание сообщения.
3. messageFrom: Отображаемое имя отправителя.

7) Ответ на сообщение

Назначение

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

Конечная точка

HTTP POST вызов конечной точки - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages/{messageID}/replies

Требуемый ввод

Ниже перечислены параметры, которые отправляются как часть URL и/или тела запроса

1. Идентификатор команды
2. ID канала
3. Идентификатор сообщения
4. Содержание сообщения

Требуемый экстрактор вывода

Нам не требуется никакой экстрактор вывода.

8) Удалить канал

Назначение

Пользователи могут передать ID команды и ID канала в качестве входных данных, и Tulip удалит конкретный канал с указанными входными данными.

Конечная точка

HTTP DELETE вызов конечной точки -https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}

Необходимые входные данные

Ниже перечислены параметры URL, которые необходимо передать

1. ID команды
2. Идентификатор канала

Требуемый экстрактор вывода

Мы не требуем никакого экстрактора вывода.

9) Получение списка членов команды

Назначение

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

Конечная точка

HTTP GET вызов конечной точки https://graph.microsoft.com:443/v1.0/teams/{teamID}/members

Требуемый ввод

Ниже перечислены параметры URL, которые необходимо передать.

1. Идентификатор команды

Требуемый выходной экстрактор

1. Идентификатор участника: Уникальный идентификатор участника.
2. Имя участника: Отображаемое имя участника.
3. EmailID участника: идентификатор электронной почты участника.
4. Роль участника: Роль участника в командном канале.

Дополнительное чтение

Ознакомьтесь с дополнительной информацией о коннекторах Microsoft

• Коннектор календаря Microsoft
• Коннектор Microsoft Outlook
• Коннектор Microsoft Excel