- Nyomtat
To download the app, visit: Library
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 és a Microsoft 365 termékek, például a Teams, az Office Suite és az Outlook integrálásához.
Előfeltételek
Note: Oauth2 authentication information must be generated in Entra ID before using this Connector. Follow this guide to generate the required credentials. Connect the MS Graph API to Tulip with Oauth2
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
- teamID: A csapat egyedi azonosítója, amelyet a többi feladat elvégzéséhez használnak.
- teamName: A csapat megjelenített neve.
- teamDescription: A csapat leírása.
2) A 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
A következő URL paramétereket kell átadni
- Csapat azonosítója
Kötelező kimenet Extractor
- channelId: A csatorna egyedi azonosítója, amelyet a többi feladat elvégzéséhez használnak.
- channelName: A csatorna megjelenített neve.
- channelDescription: A csatorna leírása.
3) Új csatorna létrehozása
Cél
- 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.
- 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 lehet továbbítani.
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
- Csapat azonosítója
- Csatorna neve
- Csatorna leírása
Kötelező kimenet Extractor
- channelId: A csatorna egyedi azonosítója, amelyet a többi feladat végrehajtásához használnak.
- channelName: A csatorna megjelenített neve.
- channelDescription:A csatorna leírása.
4) A csatorna tulajdonságainak frissítése
Cél
- 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.
- A Microsoft Graph V1.0 API-ból származó információk ezután tovább haszná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
- Csapat azonosító
- Csatorna azonosítója
- Csatorna neve
- 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
- Csapat azonosítója
- Csatorna azonosítója
- Tárgy
- Ü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.
- Csapat azonosítója
- Csatorna azonosítója
Kötelező kimenet Kivonat
- messageId: Az üzenet egyedi azonosítója, amely a többi feladat elvégzéséhez használatos.
- messageContent: Az üzenet tartalma.
- 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
- Csapat azonosító
- Csatorna azonosítója
- Üzenet azonosítója
- Ü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
- Csapat azonosítója
- 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.
- Csapat azonosítója
Kötelező kimenet Extractor
- Tag azonosító: A tag egyedi azonosítója.
- Tag neve: A tag megjelenített neve.
- Tag EmailID: A tag e-mail azonosítója.
- Tag szerepe: A tag szerepe a Csapatcsatornában.
További olvasmányok
További információk a Microsoft Connectors-ról