Microsoft Teams Connector

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

Microsoft 365 Connector

Az olyan Microsoft-alkalmazásokkal való integrációhoz, mint a Teams, az Outlook és az Office Suite.

Cél

Használja ezt a dokumentumot a Tulip Apps integrálásához a Microsoft 365 termékekkel, például a Teams, az Office Suite és az Outlook termékekkel.

Előfeltételek

::: (info) () Megjegyzés: Az Oauth2 hitelesítési adatokat az Entra ID-ban kell létrehozni, mielőtt ezt a csatlakozót használná. Kövesse ezt az útmutatót a szükséges hitelesítő adatok létrehozásához.
Az MS Graph API csatlakoztatása a Tuliphoz Oauth2-vel:::

API Doc

Microsoft Graph API dokumentáció

A csatlakozóhoz szükséges hatókörök

A csatlakozó funkciói

1) Az összes csapat 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üldött 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, és 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 küldött 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ó