Microsoft Teams-integration
Microsoft Teams-integration med Microsoft Graph API anslutning
Microsoft Teams-integration
Microsoft Teams-integration med Microsoft Graph API anslutning
Integrationsfunktioner för Microsoft Teams ingår i Microsoft Graph API Connector (tidigare känt som Entra ID Connector).
Med Microsoft Graph API Connector har du kunnat läsa data från Microsoft Teams. Från och med version 2025.2 kan du även utföra åtgärder mot Microsoft Teams och göra ändringar i Teams-miljön. Tillsammans levererar dessa funktioner konkret affärsvärde inom fyra nyckelområden:
Förbättrad synlighet och kontroll: Tillgång till Microsoft Teams-relaterad data i nära realtid, till exempel användare, kanaler och teammedlemskap.
Automatisering och effektivitet: Automatiserade åtgärder minskar manuell ansträngning, snabbar upp svarstider och effektiviserar processer.
Strategisk integration och innovation: Sömlös integration med andra IT-system möjliggör avancerad automatisering, förbättrad styrning och stöder bredare digitala transformationsinitiativ.
Microsoft Teams-integration kan byggas med Microsoft Graph API Connector .
För kundens instruktioner, se https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
Dokumentation för Microsoft Graph API relaterad till Teams-integration: https://learn.microsoft.com/en-us/graph/api/resources/teams-api-overview?view=graph-rest-1.0
Exempel på användningsområden med Teams är
- Skicka aviseringar till Teams
- Läser team och kanalinformation till ITSM
- Hantering av teammedlemskap
- Teamets livscykelhantering
- Validering av teamägarskap
- Integration med användarlivscykelprocesser
- Händelsedriven teamskapande
Läs Microsoft Teams-team
Azure applikationsbehörigheter
För Teams-import behöver programmet i Azure dessa behörigheter
För kundens instruktioner, se https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
| Tillståndstyp | Behörigheter |
| Ansökan |
Grupp.Läs.Alla, Team.Läs.Basic.Alla och (Channel.ReadBasic.All eller Channel.Read.All) |
Frågor för schemalagd uppgift
Fråga: groups?$filter=resurs Pro /Any(x:x eq 'Team')
Delfrågor:
team/{id}/kanaler
team/{id}/medlemmar
Mappningar för schemalagd uppgift
Använd alltid generisk mall för Teams-mappningstyp:
| Externt attribut | Lokalt attribut | Mer information |
|---|---|---|
| id | team_id | Unikt ID för teamet |
| visningsnamn | team_displayName | |
| beskrivning | team_beskrivning | |
| synlighet | team_visibility | Offentligt eller privat team |
| teams/{id}/channels.id | kanal_id |
Lista över teamkanal-ID:n Detta attribut måste vara flervärde |
| teams/{id}/medlemmar.användar-ID | teammedlemmar |
Lista över teammedlemmarnas ID:n Detta attribut måste vara flervärde |
Öppet ämne: Skulle det vara bättre att även hämta kanaldetaljer (visningsnamn, beskrivning etc.) till ett annat flervärdesattribut i den här schemalagda uppgiften, eller hämta dessa kanal för kanal från arbetsflödesorkestreringsnoden.
Händelsebaserade uppgifter (åtgärder för) Microsoft-team och -kanaler
Azure applikationsbehörigheter
För Teams-åtgärder behöver applikationer i Azure behörigheter. För att ställa in korrekta behörigheter, se: https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id och https://learn.microsoft.com/en-us/graph/permissions-reference
Händelsebaserad uppgift
URL för händelsebaserad uppgift kan vara tom. Slutgiltig URL att anropa skapas genom att kombinera kopplings-URL och arbetsflödesnod-URL.
Mappningar för händelsebaserade uppgifter
Rubrik för händelsebaserad uppgift
Inget behov av att ställa in extra rubriker, kopplingshanteringen ställer in detta automatiskt:
| Innehållstyp | applikation/json |
Arbetsflödesnod
På noden Workflow Orchestration väljer du dessa Orchestrate, Data Source och Activity:
Välj den händelsebaserade uppgift som du skapade för den här åtgärden. Du kan också använda en händelsebaserad uppgift för många åtgärder.
De flesta av dessa åtgärder använder http-metoden POST. Kom ihåg att ange korrekt metod för noden Workflow Orchestration för dessa åtgärder.
Skicka textkommentar/meddelande till teamkanalen
Åtgärd : POST
URL : teams/{team-id}/channels/{channel-id}/messages
Exempel på kropp :
Microsoft-dokumentation för API
Hämta kanalinformation
Åtgärd : GET
URL : teams/{team-id}/channels/{channel-id}
Kropp: (ingen)
I arbetsflödet, analysera resultset-json från attributet " REST response attribute" för att skapa referensdatakort för kanalen.
Exempel på returnerad resultset-json när teamet {team-id} innehåller 2 kanaler:
Skapa ett team
Åtgärd : POST
URL : teams
Exempel på kropp:
Microsoft-dokumentation för API
Uppdatera ett lag
Åtgärd : PATCH
URL : teams/{team-id}
Exempel på kropp :
Microsoft-dokumentation för API
Arkivera ett team
Åtgärd : POST
URL : teams/{id}/arkiv
Exempel på brödtext : {"shouldSetSpoSiteReadOnlyForMembers": true}
Microsoft-dokumentation för API
Lägg till medlem(mar) i ett team
Åtgärd : POST
URL : /teams/{team-id}/medlemmar
Exempel på kropp:
Microsoft-dokumentation för API
Ta bort medlem från ett team
Åtgärd : DELETE
URL : /teams/{team-id}/members/{membership-id}
Kropp : (ingen)
https://learn.microsoft.com/en-us/graph/api/team-delete-members?view=graph-rest-1.0&tabs=http
Microsoft-programbehörigheter för team och kanaler
Lägg till korrekta behörigheter baserat på ditt användningsfalls behov.
Användaromfattningstyp Applikation :
| Drift | Tillstånd | Anteckningar |
|---|---|---|
| Upptäck team | Team.ReadBasic.All | Räkna upp alla team i hyresgästen. |
| Hantera teaminställningar | Teaminställningar.LäsSkriv.Alla | Läs/uppdatera teaminställningar; stöds inte för personliga Microsoft-konton. |
| Skapa kanaler (valfritt team) | Kanal.Skapa | Skapa standard-/privata kanaler i valfritt team. |
| Läs kanaler (metadata) | Kanal.LäsBasic.Alla | Läs kanallistor och grundläggande information för alla hyresgäster. |
| Läs kanalinställningar | Kanalinställningar.Läs.Alla | Läs alla kanalegenskaper/inställningar. |
| Redigera kanalinställningar | Kanalinställningar.LäsSkriv.Alla | Ändra kanalnamn, beskrivning och modereringsinställningar. |
| Hantera teammedlemskap | Teammedlem.LäsSkriv.Alla | Lägg till/ta bort medlemmar och ändra roller (gästtillägg stöds inte). |
| Läs kanalmedlemskap | Kanalmedlem.Läs.Alla | Läs medlemskap i alla standard-/privata/delade kanaler. |
| Hantera kanalmedlemskap | Kanalmedlem.LäsSkriv.Alla | Lägg till/ta bort/uppdatera medlemmar i privata/delade kanaler. |
| Läs kanalmeddelanden | Kanalmeddelande.Läs.Alla | Läs alla kanalmeddelanden för hela hyresgästen (efterlevnad/revision). |
Kända begränsningar
Begränsningar i 2025.2 och äldre versioner
Av prestandaskäl stöds inte mer än en nivå av underfrågor.
Mer än en delfråga stöds inte.
Anslutningsprogrammet har ännu inte stöd för att markera Teams/kanalobjekt som borttagna till Matrix42 Core , Pro eller IGA när objektet tas bort från Microsoft Teams.