Microsoft Teams-Integration
Microsoft Teams-Integration mit dem Microsoft Graph API Connector
Microsoft Teams-Integration
Microsoft Teams-Integration mit dem Microsoft Graph API Connector
Die Integrationsfunktionen für Microsoft Teams sind im Microsoft Graph API Connector (früher bekannt als Entra ID Connector) enthalten.
Mit dem Microsoft Graph API Connector können Sie Daten aus Microsoft Teams lesen. Ab Version 2025.2 können Sie auch Aktionen für Microsoft Teams ausführen und Änderungen innerhalb der Teams-Umgebung vornehmen. Zusammen bieten diese Funktionen einen spürbaren Geschäftswert in vier Schlüsselbereichen:
Verbesserte Sichtbarkeit und Kontrolle: Nahezu in Echtzeit Zugriff auf Microsoft Teams-bezogene Daten wie Benutzer, Kanäle und Teammitgliedschaften.
Automatisierung und Effizienz: Automatisierte Aktionen reduzieren den manuellen Aufwand, beschleunigen die Reaktionszeiten und optimieren Prozesse.
Strategische Integration und Innovation: Die nahtlose Integration mit anderen IT-Systemen ermöglicht erweiterte Automatisierung, verbesserte Governance und unterstützt umfassendere Initiativen zur digitalen Transformation.
Die Microsoft Teams-Integration kann mit Microsoft Graph API Connector erstellt werden.
Anweisungen für Kunden finden Sie unter https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
Microsoft Graph API Dokumentation zur Teams-Integration: https://learn.microsoft.com/en-us/graph/api/resources/teams-api-overview?view=graph-rest-1.0
Beispiele für Anwendungsfälle mit Teams sind
- Senden von Benachrichtigungsnachrichten an Teams
- Lesen von Team- und Kanalinformationen an ITSM
- Teammitgliedschaftsverwaltung
- Team-Lebenszyklusmanagement
- Validierung der Teameigentümerschaft
- Integration mit Benutzerlebenszyklusprozessen
- Ereignisgesteuerte Teambildung
Lesen Sie Microsoft Teams-Teams
Azure Anwendungsberechtigungen
Für den Teams-Import benötigt die Anwendung in Azure diese Berechtigungen
Anweisungen für Kunden finden Sie unter https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
| Berechtigungstyp | Berechtigungen |
| Anwendung |
Gruppe.Alles.Lesen, Team.Grundlegendes.Alles. Und (Channel.ReadBasic.All oder Channel.Read.All) |
Abfragen für geplante Aufgaben
Abfrage: groups?$filter=resource Pro visioningOptions/Any(x:x eq 'Team')
Unterabfragen:
Teams/{id}/Kanäle
Teams/{id}/Mitglieder
Zuordnungen für geplante Aufgaben
Verwenden Sie immer eine generische Vorlage für den Teamzuordnungstyp:
| Externes Attribut | Lokales Attribut | Mehr Infos |
|---|---|---|
| Ausweis | Team-ID | Eindeutige ID des Teams |
| Anzeigename | Team-Anzeigename | |
| Beschreibung | Teambeschreibung | |
| Sichtweite | Teamsichtbarkeit | Öffentliches oder privates Team |
| teams/{id}/channels.id | Kanal-ID |
Liste der Team-Kanal-IDs Dieses Attribut muss mehrwertig sein |
| teams/{id}/members.userId | Teammitglieder |
Liste der Teammitglieder-IDs Dieses Attribut muss mehrwertig sein |
Offenes Thema: Wäre es besser, auch Kanaldetails (Anzeigename, Beschreibung usw.) in ein anderes mehrwertiges Attribut in dieser geplanten Aufgabe abzurufen oder diese Kanal für Kanal vom Workflow-Orchestrierungsknoten abzurufen?
Ereignisbasierte Aufgaben (Aktionen für) Microsoft-Teams und -Kanäle
Azure Anwendungsberechtigungen
Für Team-Aktionen benötigt die Anwendung in Azure Berechtigungen. Informationen zum Festlegen der richtigen Berechtigungen finden Sie unter: https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id und https://learn.microsoft.com/en-us/graph/permissions-reference
Ereignisbasierte Aufgabe
Die URL für ereignisbasierte Aufgaben kann leer sein. Die endgültige aufzurufende URL wird durch Kombination der Connector-URL und der Workflow-Knoten-URL erstellt.
Zuordnungen für ereignisbasierte Aufgaben
Header für ereignisbasierte Aufgaben
Es müssen keine zusätzlichen Header festgelegt werden, die Connector-Verwaltung legt dies automatisch fest:
| Inhaltstyp | Anwendung/JSON |
Workflow-Knoten
Wählen Sie im Knoten „Workflow-Orchestrierung“ Folgendes aus: Orchestrierung, Datenquelle und Aktivität:
Wählen Sie die ereignisbasierte Aufgabe aus, die Sie für diese Aktion erstellt haben. Sie können auch eine ereignisbasierte Aufgabe für mehrere Aktionen verwenden.
Die meisten dieser Aktionen verwenden die HTTP-Methode POST. Denken Sie daran, für diese Aktionen die richtige Methode für den Workflow-Orchestrierungsknoten festzulegen.
Senden Sie einen Textkommentar/eine Textbenachrichtigung an den Teamkanal
Aktion : POST
URL : teams/{team-id}/channels/{channel-id}/messages
Beispieltext :
Microsoft-Dokumentation für API
Kanalinformationen abrufen
Aktion : GET
URL : teams/{team-id}/channels/{channel-id}
Text: (keine)
Analysieren Sie im Workflow das JSON-Ergebnisset vom Attribut „ REST Antwortattribut“, um eine Referenzdatenkarte des Kanals zu erstellen.
Beispiel für das zurückgegebene JSON-Ergebnisset, wenn das Team {team-id} 2 Kanäle enthält:
Erstellen Sie ein Team
Aktion : POST
URL : teams
Beispieltext:
Microsoft-Dokumentation für API
Aktualisieren eines Teams
Aktion : PATCH
URL : teams/{team-id}
Beispieltext :
Microsoft-Dokumentation für API
Ein Team archivieren
Aktion : POST
URL : teams/{id}/archive
Textbeispiel : {"shouldSetSpoSiteReadOnlyForMembers": true}
Microsoft-Dokumentation für API
Mitglieder zu einem Team hinzufügen
Aktion : POST
URL : /teams/{team-id}/members
Beispieltext:
Microsoft-Dokumentation für API
Mitglied aus einem Team entfernen
Aktion : DELETE
URL : /teams/{Team-ID}/Mitglieder/{Mitglieds-ID}
Körper : (keine)
https://learn.microsoft.com/en-us/graph/api/team-delete-members?view=graph-rest-1.0&tabs=http
Microsoft-Anwendungsberechtigungen für Teams und Kanäle
Fügen Sie je nach Bedarf Ihres Anwendungsfalls die richtigen Berechtigungen hinzu.
Benutzerbereichstyp Anwendung :
| Betrieb | Erlaubnis | Hinweise |
|---|---|---|
| Teams entdecken | Team.ReadBasic.All | Zählen Sie alle Teams im Mandanten auf. |
| Teameinstellungen verwalten | TeamSettings.ReadWrite.All | Teameinstellungen lesen/aktualisieren; wird für persönliche Microsoft-Konten nicht unterstützt. |
| Kanäle erstellen (jedes Team) | Kanal.Erstellen | Erstellen Sie in jedem Team Standard-/private Kanäle. |
| Kanäle lesen (Metadaten) | Channel.ReadBasic.All | Lesen Sie Kanallisten und grundlegende Informationen über alle Mandanten hinweg. |
| Kanaleinstellungen lesen | ChannelSettings.Read.All | Lesen Sie alle Kanaleigenschaften/-einstellungen. |
| Kanaleinstellungen bearbeiten | ChannelSettings.ReadWrite.All | Kanalnamen, Beschreibung und Moderationseinstellungen ändern. |
| Teammitgliedschaft verwalten | TeamMember.ReadWrite.All | Mitglieder hinzufügen/entfernen und Rollen ändern (Gast-Hinzufügen wird nicht unterstützt). |
| Kanalmitgliedschaft lesen | ChannelMember.Read.All | Lesen Sie die Mitgliedschaft aller Standard-/privaten/geteilten Kanäle. |
| Kanalmitgliedschaft verwalten | ChannelMember.ReadWrite.All | Mitglieder in privaten/geteilten Kanälen hinzufügen/entfernen/aktualisieren. |
| Kanalnachrichten lesen | ChannelMessage.Read.All | Lesen Sie alle Kanalnachrichten im gesamten Mandanten (Compliance/Audit). |
Bekannte Einschränkungen
Einschränkungen in 2025.2 und älteren Versionen
Aus Leistungsgründen werden mehr als eine Ebene von Unterabfragen nicht unterstützt.
Mehr als eine Unterabfrage wird nicht unterstützt.
Connector unterstützt noch nicht das Markieren von Teams-/Kanalobjekten, die in Matrix42 Core , Pro , IGA gelöscht wurden, wenn das Objekt aus Microsoft Teams gelöscht wird.