Konektor Microsoft Teams

::: (info) () Aby pobrać aplikację, odwiedź: Biblioteka:::

Microsoft Teams Connector

Integracja Tulip z Microsoft Teams

Wprowadzenie

Interfejs API Microsoft Teams umożliwia użytkownikom tworzenie, odczytywanie i edytowanie zespołów i kanałów Microsoft w Teams z odpowiednim dostępem do ich kont Microsoft. Celem tego konektora jest integracja Tulip z Microsoft za pomocą interfejsu Graph API (v1.0) firmy Microsoft przy użyciu konektorów HTTP i zapewnienie naszym klientom gotowego konektora, który można zaimportować do ich instancji.

Cel

Zamierzamy wyróżnić różne funkcje konektorów, które można zbudować, wykonując wywołania HTTP do interfejsu Graph API (v1.0) firmy Microsoft w celu interakcji z zespołami M365, aby zaprezentować różne akcje odczytu i zapisu w zespołach, które można wykorzystać w różnych przypadkach użycia.

Dokumentacja API

Dokumentacja interfejsu API Microsoft Graph

Wymagania wstępne

1. Utwórz konto na platformie Microsoft 365 i skonfiguruj poświadczenia OAuth 2.0 w Microsoft Entra ID.
2. Zarejestrowanie interfejsu API z wymaganymi zakresami w portalu Microsoft. Azure - Entra ID

Film przedstawiający konfigurację konektora dla programu Excel:

Możesz wykonać te same kroki, aby skonfigurować konektor dla zespołów.

Szczegóły połączenia Tulip

Następujące informacje muszą zostać skonfigurowane w Tulip's

Konektory.

1. Uruchomione na: Host łącznika w chmurze
2. Host: graph.microsoft.com
3. Port:443
4. TLS: Tak

OAuth 2: Uwierzytelnianie zostanie przeniesione do wszystkich

funkcji łącznika

**Ważne do zapamiętania:**1. Jest to połączenie Tulip z Microsoft przez https. 2. Dostęp jest kontrolowany przez uwierzytelnianie po stronie Microsoft. W zależności od konta Teams, które jest używane do uwierzytelniania, użytkownik będzie miał taki sam dostęp. W funkcjach konektora można dodatkowo skonfigurować uprawnienia i poziomy dostępu.

Funkcje łącznika

1) Pobierz wszystkie zespoły

Cel

Ten konektor pobiera wszystkie zespoły, do których należy użytkownik przy użyciu konta Microsoft Teams.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego - https://graph.micrsoft.com:443/v1.0/me/joinedTeams

Wymagane dane wejściowe

Dane wejściowe nie są wymagane

Wymagane dane wyjściowe Extractor

1. teamID: Unikalny identyfikator zespołu, który będzie używany do wykonywania innych zadań.
2. teamName: Wyświetlana nazwa zespołu.
3. teamDescription: Opis zespołu.

2) Pobierz wszystkie kanały zespołu

Cel

Ten łącznik pobiera wszystkie kanały zespołu, przekazując identyfikator zespołu jako dane wejściowe.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

Wymagane dane wejściowe

Poniżej przedstawiono parametry adresu URL, które należy przekazać

1. Identyfikator zespołu

Wymagane dane wyjściowe Extractor

1. channelId: Unikalny identyfikator kanału, który będzie używany do wykonywania innych zadań.
2. channelName: Wyświetlana nazwa kanału.
3. channelDescription: Opis kanału.

3) Utwórz nowy kanał

Cel

1. Użytkownicy mogą przekazać identyfikator zespołu, nazwę kanału i opis kanału jako dane wejściowe, a Tulip utworzy nowy kanał z podaną nazwą kanału. Odpowiedzią API będą metadane i różne właściwości kanału. Można to dalej wykorzystać do pobierania i aktualizowania danych z kanału.
2. Informacje pobierane z interfejsu API Microsoft Graph V1.0 mogą być następnie dalej wykorzystywane w aplikacjach Tulip, tabelach Tulip lub zmiennych Tulip, które będą przesyłane do innych funkcji łącznika.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

Wymagane dane wejściowe

Następujące parametry są wysyłane jako treść żądania

1. Identyfikator zespołu
2. Nazwa kanału
3. Opis kanału

Wymagane wyjście Extractor

1. channelId: Unikalny identyfikator kanału, który będzie używany do wykonywania innych zadań.
2. channelName:Wyświetlana nazwa kanału.
3. channelDescription:Opis kanału.

4) Aktualizacja właściwości kanału

Cel

1. Użytkownicy mogą przekazać identyfikator zespołu, identyfikator kanału, nową nazwę kanału i nowy opis kanału jako dane wejściowe, a Tulip zaktualizuje nowy kanał z nową nazwą kanału i podanym opisem. Odpowiedzią API będą metadane i różne właściwości kanału. Można to dalej wykorzystać do pobierania i aktualizowania danych z kanału.
2. Informacje pobierane z interfejsu API Microsoft Graph V1.0 mogą być następnie wykorzystywane w aplikacjach Tulip, tabelach Tulip lub zmiennych Tulip, które mogą być przesyłane do innych funkcji konektora.

Punkt końcowy

Wywołanie HTTP PATCH do punktu końcowego https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}

Wymagane dane wejściowe

Następujące parametry są wysyłane jako część adresu URL i/lub treści żądania

1. Identyfikator zespołu
2. Identyfikator kanału
3. Nazwa kanału
4. Opis kanału

Wymagany ekstraktor danych wyjściowych

Nie wymagamy żadnego ekstraktora wyjściowego.

5) Wyślij wiadomość do kanału

Cel

Użytkownicy mogą przekazać identyfikator zespołu, identyfikator kanału, temat i treść wiadomości jako dane wejściowe, a Tulip wyśle wiadomość z dostarczoną treścią wiadomości.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages

Wymagane dane wejściowe

Następujące parametry są wysyłane jako część adresu URL i/lub treści żądania

1. Identyfikator zespołu
2. Identyfikator kanału
3. Temat
4. Treść wiadomości

Wymagany ekstraktor danych wyjściowych

Nie wymagamy żadnego ekstraktora danych wyjściowych.

6) Pobierz wszystkie wiadomości z określonego kanału

Cel

To złącze pobiera wszystkie wiadomości z określonego kanału.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}/messages

Wymagane dane wejściowe

Poniżej przedstawiono parametry adresu URL, które należy przekazać.

1. Identyfikator zespołu
2. Identyfikator kanału

Wymagane dane wyjściowe Extractor

1. messageId: Unikalny identyfikator wiadomości, która zostanie użyta do wykonania innych zadań.
2. messageContent: Treść wiadomości.
3. messageFrom: Wyświetlana nazwa nadawcy.

7) Odpowiedz na wiadomość

Cel

Użytkownicy mogą przekazać identyfikator zespołu, identyfikator kanału, temat i treść wiadomości jako dane wejściowe, aby odpowiedzieć na wiadomość, a Tulip wyśle odpowiedź z dostarczoną treścią wiadomości.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages/{messageID}/replies

Wymagane dane wejściowe

Poniższe parametry są wysyłane jako część adresu URL i/lub treści żądania

1. Identyfikator zespołu
2. Identyfikator kanału
3. Identyfikator wiadomości
4. Treść wiadomości

Wymagany ekstraktor danych wyjściowych

Nie wymagamy żadnego ekstraktora wyjściowego.

8) Usuń kanał

Cel

Użytkownicy mogą przekazać identyfikator zespołu i identyfikator kanału jako dane wejściowe, a Tulip usunie określony kanał za pomocą dostarczonych danych wejściowych.

Punkt końcowy

Wywołanie HTTP DELETE do punktu końcowego -https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}

Wymagane dane wejściowe

Poniżej znajdują się parametry URL, które należy przekazać

1. Identyfikator zespołu
2. Identyfikator kanału

Wymagany ekstraktor danych wyjściowych

Nie wymagamy żadnego ekstraktora wyjściowego.

9) Pobierz listę członków zespołu

Cel

Ten konektor pobiera wszystkich członków określonego zespołu.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego https://graph.microsoft.com:443/v1.0/teams/{teamID}/members

Wymagane dane wejściowe

Poniżej znajdują się parametry URL, które należy przekazać.

1. Identyfikator zespołu

Wymagane dane wyjściowe Extractor

1. Identyfikator członka: Unikalny identyfikator członka.
2. Member Name: Wyświetlana nazwa członka.
3. EmailID członka: identyfikator e-mail członka.
4. Member Role: Rola członka w kanale Team Channel.

Więcej informacji

Więcej informacji na temat konektorów Microsoft

• Konektor kalendarza Microsoft
• Konektor Microsoft Outlook
• Konektor Microsoft Excel