Konektor Microsoft Teams

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

Microsoft 365 Connector

Do integracji z aplikacjami Microsoft, takimi jak Teams, Outlook i Office Suite.

Cel

Ten dokument służy do integracji aplikacji Tulip Apps z produktami Microsoft 365, takimi jak Teams, Office Suite i Outlook.

Wymagania wstępne

Uwaga: Informacje uwierzytelniające Oauth2 muszą zostać wygenerowane w Entra ID przed użyciem tego konektora. Postępuj zgodnie z tym przewodnikiem, aby wygenerować wymagane poświadczenia.
Podłącz MS Graph API do Tulip za pomocą Oauth2 :::

API Doc

Dokumentacja interfejsu API Microsoft Graph

Zakresy wymagane dla tego konektora

Funkcje konektora

1) Pobierz wszystkie zespoły

Cel

Ten łącznik pobiera wszystkie zespoły, do których należy użytkownik, korzystając z 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