Microsoft Teams Graph-Spoke
Die Microsoft Teams Graph-Spoke verwaltet Anwendungen, Kalender, Teams, Kanäle, Chats, Benachrichtigungen und Webhooks in Microsoft Teams. Um Benutzer und Gruppen zu erstellen, zu verwalten oder zu löschen, verwenden Sie die Microsoft Entra ID-Spoke (früher Microsoft Azure Active Directory-Spoke).
Apps im Store anfordern
Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.
- Teams in Microsoft Teams Graph-Spoke werden aus den Gruppen in Microsoft Entra ID (früher Microsoft Azure Active Directory) erstellt. Um ein Team mit Microsoft Teams Graph-Spokezu erstellen, muss die zugeordnete Gruppe in Microsoft Entra ID vorhanden sein.
- Die Benutzer- und Gruppenverwaltung kann nur mit Microsoft Entra ID und nicht mit Microsoft Teams Graph-Spokedurchgeführt werden.
- Teams können nur aus der Office 365-Gruppe Microsoft erstellt werden.
- Die Team-ID in Microsoft Teams ist mit der Gruppen-ID der zugeordneten Gruppe in Microsoft Entra ID identisch.
IntegrationHub-Abonnement
Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht.
Spoke-Version
Microsoft Teams Graph-Spoke v4.0.0 ist die neueste Version.
Unterstützte Version
Microsoft Graph REST API v1.0.
Spoke-Abhängigkeiten
- ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
- Flow Designer Designer-Modell (com.glide.hub.designer_backend.model)
- Komplexes Objekt (com.glide.cobject)
- ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
- ServiceNow IntegrationHub Aktionsvorlage – Datenstrom (com.glide.hub.action_type.datastream)
- Remotetabellen (com.glide.script.vtable)
- ServiceNow IntegrationHub-Aktionsschritt – Verbindungsinformationen abrufen (com.glide.hub.action_step.get_connection_info)
Spoke-Abläufe
Microsoft Teams Graph-Spoke stellt den Beispiel-Flow Post ServiceNow Incident Worknotes Updates to Microsoft Teams Chat (ServiceNow-Incident-Arbeitsnotizen in Microsoft Teams-Chat veröffentlichen) bereit, um die Automatisierung der Aufgabe zu demonstrieren, bei der eine Microsoft Teams-Chatnachricht an den zugewiesenen Benutzer mit Details zu den letzten Arbeitsnotizen gesendet wird, die dem Incident hinzugefügt wurden.
Spoke-Unterabläufe
| Subflow | Beschreibung |
|---|---|
| Incident-Details veröffentlichen | Veröffentlicht Details des erforderlichen Incidents in einem Microsoft Teams-Kanal. |
| Verarbeitet eingehende Benachrichtigungen | Ruft die Details der angegebenen Nachricht basierend auf den Eingabedaten ab, die vom Webhook-Abonnement empfangen wurden. |
| Webhook-Abonnement verlängern – Hilfs-Subflow | Verlängert ein Abonnement, wenn eine Verlängerung erforderlich ist, was basierend auf Eingaben entschieden wird. |
| Verlängern Sie Webhook-Abonnements | Ruft alle Webhook-Abonnements ab und verlängert sie, wenn eine Verlängerung erforderlich ist. |
| Webhook abonnieren | Erstellt ein Webhook-Abonnement für den Kanal des angegebenen Teams. |
Spoke-Aktionen
Microsoft Teams Graph-Spoke bietet Aktionen zum Automatisieren von Team- und Kanalaufgaben, wenn ein Incident in der Instanz ServiceNow erstellt wird.
Einige Aktionen können Sie über die Microsoft Teams-Spoke-Verbindung ausführen, die restlichen Aktionen über die Microsoft Teams Graph Client-Anmeldeinformationen-Verbindung.
Die Aktionen in der folgenden Tabelle verwenden den Microsoft Teams-Spoke-Aliasdatensatz für Verbindungen und Anmeldeinformationen. Für diese Aktionen sind die delegierten Berechtigungen erforderlich.
| Kategorie | Aktion | Beschreibung | Erforderliche Berechtigungen (von den geringsten bis zu den höchsten Berechtigungen) | |
|---|---|---|---|---|
| Anwendungsmanagement | Anwendung für Anwender installieren | Installiert die angegebene Anwendung im persönlichen Bereich des Anwenders. | Delegiert (Arbeits- oder Schulkonto) | TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser |
| Anwender-App-Installation suchen | Ruft die Details der Installation der angegebenen Anwendung für den Anwender ab. | Delegiert (Arbeits- oder Schulkonto) | TeamsAppInstallation.ReadForUser, TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser | |
| Kalenderverwaltung | Zeitpläne suchen | Ruft die Verfügbarkeitsinformationen (Frei oder Beschäftigt) für eine Sammlung von Benutzern, Verteilerlisten oder Ressourcen (Räume oder Geräte) für den angegebenen Zeitraum ab. | Delegiert (Arbeits- oder Schulkonto) | Calendars.Read, Calendars.ReadWrite |
| Channel-Management | Mitglied zu Kanal hinzufügen | Fügt das angegebene Mitglied dem angegebenen Kanal hinzu. | Delegiert (Arbeits- oder Schulkonto) | ChannelMember.ReadWrite.All |
| Kanal erstellen | Erstellen Sie einen neuen Kanal in einem Team. | Delegiert (Arbeits- oder Schulkonto) | Channel.Create, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
| Kanal löschen | Entfernt den angegebenen Kanal aus dem erforderlichen Team und löscht alle Konversationen. | Delegiert (Arbeits- oder Schulkonto) | Channel.Delete.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
| Kanal suchen | Ruft die Eigenschaften und Beziehungen eines Kanals ab. | Delegiert (Arbeits- oder Schulkonto) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |
| Kanal nach Name suchen | Ruft die Kanal-ID und die Eigenschaften anhand eines Kanalnamens und einer Team-ID ab. | Delegiert (Arbeits- oder Schulkonto) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |
| Nach Kanalmitgliedern suchen | Ruft eine Liste von Kanalmitgliedern ab. | Delegiert (Arbeits- oder Schulkonto) | ChannelMember.Read.All, ChannelMember.ReadWrite.All | |
| Kanalnachrichten suchen | Ruft die Liste der Nachrichten in einem Kanal eines Teams ab. | Delegiert (Arbeits- oder Schulkonto) | ChannelMessage.Read.All | |
| Nach Kanälen suchen | Ruft die Liste der Nachrichten der Kanäle in diesem Team ab. | Delegiert (Arbeits- oder Schulkonto) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |
| Mitglied aus Kanal entfernen | Entfernt den angegebenen Benutzer aus dem angegebenen Kanal. | Delegiert (Arbeits- oder Schulkonto) | ChannelMember.ReadWrite.All | |
| Chat-Verwaltung | Chat erstellen | Erstellt einen Chat zwischen den Benutzern. | Delegiert (Arbeits- oder Schulkonto) | Chat.Create, Chat.ReadWrite |
| Stream mit Chat-Nachrichten-Deltas suchen | Ruft die Liste der Nachrichten (ohne Antworten) aus dem Kanal eines Teams ab. | Delegiert (Arbeits- oder Schulkonto) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| Delegiert (privater Microsoft-Account) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |||
| Chatnachrichten suchen | Ruft die Liste der Nachrichten in einem Chat ab. | Delegiert (Arbeits- oder Schulkonto) | Chat.Read, Chat.ReadWrite | |
| Chats suchen | Ruft die Liste der Chats ab, an denen der Benutzer teilnimmt. | Delegiert (Arbeits- oder Schulkonto) | Chat.ReadBasic, Chat.Read, Chat.ReadWrite | |
| Nachricht suchen | Ruft die Details der angegebenen Nachricht ab. | Delegiert (Arbeits- oder Schulkonto) | Chat.Read, Chat.ReadWrite | |
| Stream mit Nachrichtenantworten suchen | Ruft die Liste der Antworten für die angegebene Nachricht aus dem Kanal eines Teams ab. | Delegiert (Arbeits- oder Schulkonto) | ChannelMessage.Read.All | |
| Nachricht in Chat veröffentlichen | Veröffentlicht eine Nachricht in einem Microsoft Teams-Chat. | Delegiert (Arbeits- oder Schulkonto) | ChatMessage.Send, Chat.ReadWrite | |
| Benachrichtigungsverwaltung | Change-Details veröffentlichen | Veröffentlicht Details des erforderlichen Change in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulkonto) | ChannelMessage.Send, Group.ReadWrite.All** |
| Incident-Details veröffentlichen | Veröffentlicht Details des erforderlichen Incidents in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulkonto) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Nachricht veröffentlichen | Veröffentlicht eine Nachricht in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulkonto) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Problemdetails veröffentlichen | Veröffentlicht Details des erforderlichen Problems in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulkonto) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Antwort auf Nachricht veröffentlichen | Veröffentlicht eine Antwort auf die angegebene Nachricht. | Delegiert (Arbeits- oder Schulkonto) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Team-Management | Mitglied zu Team hinzufügen | Fügt den angegebenen Anwender dem angegebenen Team hinzu. | Delegiert (Arbeits- oder Schulkonto) | TeamMitglied.Lesen/Schreiben.Alle |
| Team archivieren | Wenn ein Team archiviert wird, können Benutzer keine Nachrichten mehr in einem Kanal im Team senden oder mit „Gefällt mir“ markieren oder Teameinstellungen aktualisieren. | Delegiert (Arbeits- oder Schulkonto) | TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
| Team erstellen | Erstellt ein Team aus einer vorhandenen Office 365-Gruppe. Hinweis: Die Team-ID ist mit der Gruppen-ID identisch. |
Delegiert (Arbeits- oder Schulkonto) | Group.ReadWrite.All, Directory.ReadWrite.All | |
| Team löschen | Löscht das angegebene Team. | Delegiert (Arbeits- oder Schulkonto) | Gruppe.LesenSchreiben.Alle | |
| Nach Team suchen | Ruft die Eigenschaften und Beziehungen eines Teams ab. | Delegiert (Arbeits- oder Schulkonto) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |
| Nach Stream „Teammitglieder“ suchen | Ruft eine Liste von Team-Mitgliedern ab. | Delegiert (Arbeits- oder Schulkonto) | TeamMember.Read.All, TeamMember.ReadWrite.All | |
| Teams nach Benutzer suchen | Listet Teams des Anwenders mit IDs und Anzeigenamen auf. | Delegiert (Arbeits- oder Schulkonto) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Directory.Read.All**, Directory.ReadWrite.All** | |
| Mitglied aus Team entfernen | Entfernt das angegebene Mitglied aus dem angegebenen Team. | Delegiert (Arbeits- oder Schulkonto) | TeamMitglied.Lesen/Schreiben.Alle | |
| Archivierung des Teams aufheben | Stellt ein archiviertes Team wieder her. Ermöglicht Mitgliedern, in Kanälen im Team zu posten, Kommentare abzugeben und Beiträge erneut zu liken. | Delegiert (Arbeits- oder Schulkonto) | TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
| Team aktualisieren | Aktualisiert die Eigenschaften eines bestimmten Teams. | Delegiert (Arbeits- oder Schulkonto) | TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
Die Aktionen in der folgenden Tabelle verwenden den Microsoft Teams Graph Client-Aliasdatensatz für Verbindungen und Anmeldeinformationen. Für diese Aktionen sind die Anwendungsberechtigungen erforderlich.
| Kategorie | Aktion | Beschreibung | Erforderliche Berechtigungen (von den geringsten bis zu den höchsten Berechtigungen) | |
|---|---|---|---|---|
| Kalenderverwaltung | Besprechung erstellen | Erstellt ein Online-Besprechungsereignis im MS Teams-Kalender. | Anwendung | Calendars.ReadWrite |
| Besprechung löschen | Löscht das Besprechungsereignis im MS Teams-Kalender. | Anwendung | Calendars.ReadWrite | |
| Besprechung suchen | Ruft Details zum Besprechungsereignis aus dem MS Teams-Kalender ab. | Anwendung | Calendars.Read | |
| Nach Besprechungsserienelementen suchen | Ruft die ID der wiederkehrenden untergeordneten Besprechung vom MS Teams-Kalender ab. | Anwendung | Calendars.Read | |
| Stream mit Besprechungen suchen | Ruft Details zum Besprechungsereignissen aus dem MS Teams-Kalender ab. | Anwendung | Calendars.Read, Calendars.ReadWrite | |
| Besprechung aktualisieren | Erstellt ein Online-Besprechungsereignis im MS Teams-Kalender. | Anwendung | Calendars.ReadWrite | |
| Webhook-Verwaltung | Nach Webhook-Abonnement suchen | Ruft Details des erforderlichen Webhook-Abonnements ab. | Anwendung | ChannelMessage.Read.All, Chat.Read.All |
| Nach Stream „Webhook-Abonnements“ suchen | Ruft Details aller Webhook-Abonnements ab. | Anwendung | ChannelMessage.Read.All, Chat.Read.All | |
| Webhook-Abonnement verlängern | Erneuert das angegebene Webhook-Abonnement. | Anwendung | ChannelMessage.Read.All, Chat.Read.All | |
| Webhook abonnieren | Erstellt ein Webhook-Abonnement für die angegebene Ressource. | Anwendung | ChannelMessage.Read.All, Chat.Read.All | |
| Webhook abbestellen | Löscht das angegebene Webhook-Abonnement. | Anwendung | ChannelMessage.Read.All, Chat.Read.All | |
- Standardmäßig ist der Gewährungstyp auf Autorisierungscode festgelegt.
- Alle Aktionen in den Kategorien „Anwendungsmanagement“, „Channel Management“, „Chat Management“, „Benachrichtigungsmanagement“ und „Team Management“ und die Aktion „Zeitpläne suchen“ in der Kategorie „Kalenderverwaltung“ verwenden den Microsoft Teams Spoke -Alias für Verbindungen und Anmeldeinformationen. Für diese Aktionen sind delegierte Berechtigungen erforderlich.
- Die Spoke-Aktionen für Kalender- und Webhook-Management (mit Ausnahme der Aktion „Zeitpläne suchen“ in Kalender-Management) verwenden den Microsoft Teams Graph Client -Anmeldeinformationen-Alias für Verbindungen und Anmeldeinformationen. Für diese Aktionen sind Anwendungsberechtigungen erforderlich.
Wenn Sie die Microsoft Teams Graph-Spoke ohne Benutzerinteraktion verwenden möchten, sollten Sie den Gewährungstyp in Client-Anmeldeinformationen ändern, damit die ServiceNow-Anwendung ohne Benutzereingreifen auf die Microsoft Teams Graph-API zugreifen kann. Anweisungen zum Ändern des Gewährungstyps und der erforderlichen Konfigurationen finden Sie im Knowledge Base-Artikel – KB1635160 auf ServiceNow – NOW Support.
Weitere Informationen zu den erforderlichen Berechtigungen finden Sie unter Microsoft Teams Dokumentation.
Weitere Informationen zum Zugriff auf die Kanal-ID und die Gruppen-ID über Microsoft Teamsfinden Sie unter Microsoft Teams Dokumentation.
Spoke-Module
| Modul | Beschreibung |
|---|---|
| Delta-Token | Zeigt die Liste der verfügbaren Delta-Token an. |
| Webhook-Registrierung | Zeigt die Liste der verfügbaren Webhook-Registrierungen an. |
| Webhook-Entscheidungsrichtlinie | Zeigt die Liste der Entscheidungsrichtlinien an. |
| Webhook-Abonnements | Zeigt die Details der Webhook-Abonnements an. |
Microsoft -Kontoanforderungen
Für Microsoft Teams Graph-Spoke muss eine Anwendung über das Azure-Portal von Microsoft ] registriert werden, um OAuth 2.0-Token zu generieren.
Alias-Anforderungen für Verbindungen und Anmeldeinformationen
IntegrationHub verwendet Aliasse, um Verbindungs- und Anmeldeinformationen sowie OAuth-Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren.
Informationen zum Einrichten der Spoke finden Sie unter Microsoft Teams Graph-Spoke einrichten.
MID-Server-Anforderungen
Die Microsoft Teams Graph-Spoke -Aktionen verwenden REST-Aufrufe, die für eine Instanz oder einen MID-Serverausgeführt werden können. Verwenden Sie den Verbindungsdatensatz, der dem Alias Microsoft zugeordnet ist, um zu konfigurieren, wo Aktionen ausgeführt werden, und um MID-Server Auswahlattribute festzulegen. Weitere Informationen finden Sie unter MID-Server.