Microsoft Teams Connector

::: (info) () Az alkalmazás letöltéséhez látogasson el a következő weboldalra: Könyvtár:::

Microsoft Teams Connector

Tulip integráció a Microsoft Teams-szel

Bevezetés

A Microsoft Teams API lehetővé teszi a felhasználók számára, hogy a Microsoft Teams-en belül Microsoft csapatokat és csatornákat hozzanak létre, olvassanak és szerkesszenek a Microsoft fiókjukhoz beállított megfelelő hozzáféréssel. Ennek a csatlakozónak a célja a Tulip és a Microsoft integrálása a Microsoft Graph API(v1.0) segítségével a HTTP csatlakozók segítségével, és ügyfeleink számára egy olyan out-of-box csatlakozót biztosít, amelyet be lehet importálni a példányukba.

Cél

Különböző csatlakozófunkciókat fogunk kiemelni, amelyek a Microsoft Graph API(v1.0) HTTP-hívásaival építhetők az M365 Teams-szel való interakcióhoz, hogy bemutassuk a különböző olvasási és írási műveleteket a csapatokon, amelyeket különböző felhasználási esetekben lehet kihasználni.

API-dokumentum

Microsoft Graph API dokumentáció

Előfeltételek

1. Hozzon létre egy fiókot a Microsoft 365 rendszerben, és konfigurálja az OAuth 2.0 hitelesítő adatokat a Microsoft Entra ID-ban.
2. Regisztrálja az API-t a szükséges hatókörökkel a Microsoft portálon. Azure - Entra ID

Videó a csatlakozó beállításáról az excel számára:

Ugyanezeket a lépéseket követheti a csapatok csatlakozójának beállításához is.

Tulip kapcsolat részletei

A következő információkat kellene beállítani a Tulipban

Csatlakozók.

1. Futtatás: Cloud Connector Host
2. Host: graph.microsoft.com
3. Port:443
4. TLS: Igen

OAuth 2: A hitelesítés továbbításra kerül az összes

a csatlakozó funkcióira

**Fontos megjegyezni:**1. Ez a Tulip to Microsoft kapcsolat https-en keresztül. 2. A hozzáférést a Microsoft oldalán a hitelesítés szabályozza. A hitelesítéshez használt Teams-fiók függvényében a felhasználónak ugyanaz a hozzáférése. A csatlakozó funkcióiban tovább konfigurálhatja a jogosultságokat és a hozzáférési szinteket.

Csatlakozófunkciók

1) Az összes Teams lekérdezése

Cél

Ez a csatlakozó lekérdezi az összes csapatot, amelynek egy felhasználó a Microsoft Teams fiókja segítségével tagja.

Végpont

HTTP GET hívás a végponthoz - https://graph.micrsoft.com:443/v1.0/me/joinedTeams

Kötelező bemenet

Nincs szükség bemenetre

Kötelező kimenet Extractor

1. teamID: A csapat egyedi azonosítója, amelyet a többi feladat elvégzéséhez használnak.
2. teamName: A csapat megjelenített neve.
3. teamDescription: A csapat leírása.

2) Egy csapat összes csatornájának lekérdezése

Cél

Ez a csatlakozó egy csapat összes csatornáját lekérdezi a teamID bemenetként történő átadásával.

Végpont:

HTTP GET hívás a https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels végpontra.

Szükséges bemenet

Az alábbi URL paramétereket kell átadni

1. Csapat azonosítója

Kötelező kimenet Extractor

1. channelId: A csatorna egyedi azonosítója, amelyet a többi feladat elvégzéséhez használnak.
2. channelName: A csatorna megjelenített neve.
3. channelDescription: A csatorna leírása.

3) Új csatorna létrehozása

Cél

1. A felhasználók megadhatják a csapat azonosítóját, a csatorna nevét és a csatorna leírását bemenetként, és a Tulip létrehoz egy új csatornát a megadott csatornanévvel. Az API válasza a csatorna metaadatai és különböző tulajdonságai lesznek. Ez a továbbiakban felhasználható a csatorna adatainak lekérdezésére és frissítésére.
2. A Microsoft Graph V1.0 API-ból származó információk a továbbiakban felhasználhatók a Tulip alkalmazásokban, a Tulip táblázatokban vagy a Tulip változókban, amelyeket más csatlakozófunkciókba továbbítanak.

Végpont

HTTP POST hívás a végponthoz - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

Szükséges bemenet

A következő paraméterek a kérés testeként elküldendő paraméterek

1. Csapat azonosítója
2. Csatorna neve
3. Csatorna leírása

Kötelező kimenet Kivonó

1. channelId: A csatorna egyedi azonosítója, amelyet a többi feladat végrehajtásához használnak.
2. channelName: A csatorna megjelenített neve.
3. channelDescription:A csatorna leírása.

4) A csatorna tulajdonságainak frissítése

Cél

1. A felhasználók bemenetként átadhatnak egy Csapat azonosítót, Csatorna azonosítót, Új csatorna nevet és Új csatorna leírást & a Tulip frissít egy új csatornát a megadott új csatornanévvel és leírással. Az API válasza a csatorna metaadatai és különböző tulajdonságai lesznek. Ez a továbbiakban felhasználható a csatorna adatainak lekérdezésére és frissítésére.
2. A Microsoft Graph V1.0 API-ból származó információk a továbbiakban felhasználhatók a Tulip alkalmazásokban, a Tulip táblázatokban vagy a Tulip változókban, amelyeket más csatlakozófunkciókba vezetnek.

Végpont

HTTP PATCH hívás a https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID} végpontra.

Kötelező bemenet

Az alábbi paraméterek az URL és/vagy a kérelemtest részeként elküldendő paraméterek

1. Csapat azonosító
2. Csatorna azonosítója
3. Csatorna neve
4. Csatorna leírása

Kötelező kimeneti kivonat

Nincs szükségünk semmilyen kimeneti kivonatolóra.

5) Üzenet küldése egy csatornának

Cél

A felhasználók megadhatják a csapat azonosítóját, a csatorna azonosítóját, a tárgyat és az üzenet tartalmát bemenetként, és a Tulip elküldi az üzenetet a megadott üzenettartalommal.

Végpont

HTTP POST hívás a https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages végpontra.

Kötelező bemenet

A következő paraméterek az URL és/vagy a kérés testének részeként küldött paraméterek

1. Csapat azonosítója
2. Csatorna azonosítója
3. Tárgy
4. Üzenet tartalma

Kötelező kimeneti kivonat

Nincs szükségünk semmilyen kimeneti kivonatolóra.

6) Egy adott csatorna összes üzenetének lekérdezése

Cél

Ez a csatlakozó egy adott csatorna összes üzenetét lekérdezi.

Végpont

HTTP GET hívás a https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}/messages végpontra.

Kötelező bemenet

A következő URL paramétereket kell átadni.

1. Csapat azonosítója
2. Csatorna azonosítója

Kötelező kimenet Kivonat

1. messageId: Az üzenet egyedi azonosítója, amely a többi feladat elvégzéséhez használatos.
2. messageContent: Az üzenet tartalma.
3. messageFrom: A feladó megjelenített neve.

7) Válasz az üzenetre

Cél

A felhasználók egy üzenetre való válaszadáshoz megadhatják a csapat azonosítóját, a csatorna azonosítóját, a tárgyat és az üzenet tartalmát, és a Tulip elküldi a választ a megadott üzenettartalommal.

Végpont

HTTP POST hívás a végpontra - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages/{messageID}/replies

Kötelező bemenet

A következő paraméterek az URL és/vagy a kérés testének részeként küldött paraméterek

1. Csapat azonosító
2. Csatorna azonosítója
3. Üzenet azonosítója
4. Üzenet tartalma

Kötelező kimeneti kivonat

Nincs szükségünk semmilyen kimeneti kivonatolóra.

8) Csatorna törlése

Cél

A felhasználók megadhatják a csapat azonosítóját és a csatorna azonosítóját bemenetként, és a Tulip törölni fogja az adott csatornát a megadott bemenetekkel.

Végpont

HTTP DELETE hívás a -https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID} végpontra.

Kötelező bemenet

A következő URL paramétereket kell átadni

1. Csapat azonosítója
2. Csatorna azonosítója

Kötelező kimenet Kivonat

Nincs szükségünk semmilyen kimeneti kivonatolóra.

9) Egy csapat tagjainak listájának lekérdezése

Cél

Ez a csatlakozó lekérdezi egy adott csapat összes tagját.

Végpont

HTTP GET hívás a https://graph.microsoft.com:443/v1.0/teams/{teamID}/members végpontra.

Kötelező bemenet

A következő URL paramétereket kell átadni.

1. Csapat azonosítója

Kötelező kimenet Extractor

1. Tag azonosító: A tag egyedi azonosítója.
2. Tag neve: A tag megjelenített neve.
3. Tag EmailID: A tag e-mail azonosítója.
4. Tag szerepe: A tag szerepe a Csapatcsatornában.

További olvasmányok

További információk a Microsoft Connectors-ról

• Microsoft Calendar Connector
• Microsoft Outlook-csatlakozó
• Microsoft Excel-csatlakozó