Коннектор Microsoft Teams

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

Коннектор Microsoft Teams

Интеграция Tulip с Microsoft Teams

Введение

Microsoft Teams API позволяет пользователям создавать, читать и редактировать команды и каналы Microsoft в Teams с соответствующим доступом, установленным для их учетных записей Microsoft. Цель этого коннектора - интегрировать Tulip с Microsoft, используя Graph API Microsoft (v1.0) с помощью HTTP-коннекторов, и предоставить нашим клиентам готовый коннектор, который можно импортировать в их экземпляр.

Назначение

Мы собираемся осветить различные функции коннектора, которые могут быть созданы путем выполнения HTTP-вызовов к Microsoft's Graph API(v1.0) для взаимодействия с M365 Teams, чтобы продемонстрировать различные действия чтения и записи в командах, которые могут быть использованы для различных сценариев использования.

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

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

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

1. Создайте учетную запись на Microsoft 365 и настройте учетные данные OAuth 2.0 в Microsoft Entra ID.
2. Зарегистрируйте API с необходимыми диапазонами на портале Microsoft. Azure - Entra ID

Видео о настройке коннектора для excel:

Вы можете выполнить те же шаги, чтобы настроить коннектор для команд.

Детали подключения Tulip

В Tulip необходимо настроить следующую информацию

Коннекторы.

1. Работает на: хосте облачного коннектора
2. Хост: graph.microsoft.com
3. Порт:443
4. TLS: Да

OAuth 2: аутентификация будет перенесена на все

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

**Важно отметить:**1. Это соединение Tulip с Microsoft по протоколу https. 2. Доступ контролируется аутентификацией на стороне Microsoft. В зависимости от учетной записи Teams, которая используется для аутентификации, пользователь будет иметь одинаковый доступ. В функциях коннектора можно дополнительно настроить разрешения и уровни доступа.

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

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