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 zugehörige Gruppe in der Entra-ID Microsoft vorhanden sein.
- Die Anwender- und Gruppenverwaltung kann nur mit Microsoft Entra ID und nicht mit Microsoft Teams Graph-Spokeerfolgen.
- Teams können nur aus der Office 365-Gruppe Microsoft erstellt werden.
- Die Team-ID in Microsoft Teams entspricht der Gruppen-ID der zugehörigen Gruppe in Microsoft, Entra ID.
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.1.1 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 „Aktualisierungen von ServiceNow-Incident-Arbeitsnotizen im Microsoft Teams-Chat veröffentlichen“ bereit, um die Automatisierung der Aufgabe zu demonstrieren, eine Microsoft Teams-Chatnachricht mit Details zu den neuesten Arbeitsnotizen, die dem Incident hinzugefügt wurden, an den zugewiesenen Benutzer zu senden.
Spoke-Unterabläufe
| Subflow | Beschreibung |
|---|---|
| Incident-Details posten | Postet Details des erforderlichen Incidents in einem Microsoft Teams-Kanal. |
| Eingehende Benachrichtigungen verarbeiten | Ruft die Details der angegebenen Nachricht basierend auf den Eingabedaten ab, die vom Webhook-Abonnement empfangen wurden. |
| Hilfs-Subflow „Webhook-Abonnement verlängern“. | Verlängert ein Abonnement, wenn eine Verlängerung erforderlich ist, worüber 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 zur Automatisierung von Team- und Kanalaufgaben, wenn in der Instanz ServiceNow ein Incident erstellt wird.
Sie können einige Aktionen mithilfe der Microsoft Teams Spoke-Verbindung und die verbleibenden Aktionen mithilfe der Microsoft Teams Graph Client-Anmeldeinformationsverbindung ausführen.
Die Aktionen in der folgenden Tabelle verwenden den Microsoft Teams-Spoke-Alias-Datensatz für Verbindungen und Anmeldeinformationen. Diese Aktionen erfordern die delegierten Berechtigungen.
| Kategorie | Aktion | Beschreibung | Erforderliche Berechtigungen (von den niedrigsten zu den höchsten Berechtigungen) | |
|---|---|---|---|---|
| Anwendungsmanagement | Anwendung für Anwender installieren | Installiert die angegebene Anwendung im persönlichen Bereich des Anwenders. | Delegiert (Arbeits- oder Uni-Account) | TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser |
| Anwender-App-Installation suchen | Ruft die Details der Installation der angegebenen Anwendung für den Anwender ab. | Delegiert (Arbeits- oder Uni-Account) | TeamsAppInstallation.LesenFürAnwender, TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.LesenSchreibenFürAnwender | |
| Kalenderverwaltung | Zeitpläne suchen | Ruft die Verfügbarkeitsinformationen (frei oder beschäftigt) für eine Sammlung von Anwendern, Verteilungslisten oder Ressourcen (Räume oder Geräte) für den angegebenen Zeitraum ab. | Delegiert (Arbeits- oder Uni-Account) | Kalender.Lesen, Kalender.LesenSchreiben |
| Channel-Management | Mitglied zu Kanal hinzufügen | Fügt das angegebene Mitglied zum angegebenen Kanal hinzu. | Delegiert (Arbeits- oder Uni-Account) | Kanalmitglied.Lesen/Schreiben.Alle |
| Kanal erstellen | Erstellt einen neuen Kanal in einem Team. | Delegiert (Arbeits- oder Uni-Account) | 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 Uni-Account) | Channel.Delete.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
| Kanal suchen | Ruft die Eigenschaften und Beziehungen eines Kanals ab. | Delegiert (Arbeits- oder Uni-Account) | 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 Uni-Account) | 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 Uni-Account) | Kanalmitglied.Lesen.Alle, Kanalmitglied.LesenSchreiben.Alle | |
| Kanalnachrichten suchen | Ruft die Liste der Nachrichten in einem Kanal eines Teams ab. | Delegiert (Arbeits- oder Uni-Account) | KanalNachricht.Lesen.Alle | |
| Nach Kanälen suchen | Ruft die Liste der Nachrichten der Kanäle in diesem Team ab. | Delegiert (Arbeits- oder Uni-Account) | 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 Anwender aus dem angegebenen Kanal. | Delegiert (Arbeits- oder Uni-Account) | Kanalmitglied.Lesen/Schreiben.Alle | |
| Chat-Verwaltung | Chat erstellen | Erstellt einen Chat zwischen den Anwendern. | Delegiert (Arbeits- oder Uni-Account) | 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 Uni-Account) | 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 Uni-Account) | Chat.Lesen, Chat.LesenSchreiben | |
| Chats suchen | Ruft die Liste der Chats ab, an denen der Anwender teilnimmt. | Delegiert (Arbeits- oder Uni-Account) | Chat.LesenBasic, Chat.Lesen, Chat.LesenSchreiben | |
| Nachricht suchen | Ruft die Details der angegebenen Nachricht ab. | Delegiert (Arbeits- oder Uni-Account) | Chat.Lesen, Chat.LesenSchreiben | |
| Stream mit Nachrichtenantworten suchen | Ruft die Liste der Antworten für die angegebene Nachricht aus dem Kanal eines Teams ab. | Delegiert (Arbeits- oder Uni-Account) | KanalNachricht.Lesen.Alle | |
| Nachricht in Chat posten | Postet eine Nachricht in einem Microsoft Teams-Chat. | Delegiert (Arbeits- oder Uni-Account) | ChatMessage.Send, Chat.ReadWrite, Group.ReadWrite.All | |
| Benachrichtigungsverwaltung | Change-Details posten | Postet Details des erforderlichen Change in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Uni-Account) | KanalNachricht.Senden, Gruppe.Lesen/Schreiben.Alle** |
| Incident-Details posten | Postet Details des erforderlichen Incidents in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Uni-Account) | KanalNachricht.Senden, Gruppe.Lesen/Schreiben.Alle** | |
| Nachricht posten | Postet eine Nachricht in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Uni-Account) | KanalNachricht.Senden, Gruppe.Lesen/Schreiben.Alle** | |
| Problemdetails posten | Postet Details des erforderlichen Problems in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Uni-Account) | KanalNachricht.Senden, Gruppe.Lesen/Schreiben.Alle** | |
| Antwort auf Nachricht posten | Postet eine Antwort auf die angegebene Nachricht. | Delegiert (Arbeits- oder Uni-Account) | KanalNachricht.Senden, Gruppe.Lesen/Schreiben.Alle** | |
| Datensatzdetails posten | Postet Details des angegebenen Datensatzes im angegebenen Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Uni-Account) | KanalNachricht.Senden, Gruppe.Lesen/Schreiben.Alle** | |
| Team-Management | Mitglied zu Team hinzufügen | Fügt den angegebenen Anwender dem angegebenen Team hinzu. | Delegiert (Arbeits- oder Uni-Account) | Teammitglied.Lesen/Schreiben.Alle |
| Team archivieren | Wenn ein Team archiviert wird, können Anwender keine Nachrichten mehr in Kanälen im Team senden oder mit „Gefällt mir“ markieren oder Teameinstellungen aktualisieren. | Delegiert (Arbeits- oder Uni-Account) | 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 Uni-Account) | Gruppe.LesenSchreiben.Alle, Verzeichnis.LesenSchreiben.Alle | |
| Team löschen | Löscht das angegebene Team. | Delegiert (Arbeits- oder Uni-Account) | Gruppe.LesenSchreiben.Alle | |
| Nach Team suchen | Ruft die Eigenschaften und Beziehungen eines Teams ab. | Delegiert (Arbeits- oder Uni-Account) | 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 Uni-Account) | Teammitglied.Lesen.Alle, Teammitglied.Lesen/Schreiben.Alle | |
| Teams nach Anwender suchen | Listet Teams des Anwenders mit IDs und Anzeigenamen auf. | Delegiert (Arbeits- oder Uni-Account) | Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Verzeichnis.Lesen.Alle**, Verzeichnis.LesenSchreiben.Alle** | |
| Mitglied aus Team entfernen | Entfernt das angegebene Mitglied aus dem angegebenen Team. | Delegiert (Arbeits- oder Uni-Account) | Teammitglied.Lesen/Schreiben.Alle | |
| Archivierung des Teams aufheben | Stellt ein archiviertes Team wieder her. Ermöglicht Mitgliedern wieder das Posten von Beiträgen in Kanälen im Team, das Verfassen von Kommentaren und das Markieren von Posts mit „Gefällt mir“. | Delegiert (Arbeits- oder Uni-Account) | TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
| Team aktualisieren | Aktualisiert die Eigenschaften eines bestimmten Teams. | Delegiert (Arbeits- oder Uni-Account) | TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
Die Aktionen in der folgenden Tabelle verwenden den Aliasdatensatz für Verbindungen und Anmeldeinformationen des Microsoft Teams Graph Client. Diese Aktionen erfordern die -Anwendungsberechtigungen.
| Kategorie | Aktion | Beschreibung | Erforderliche Berechtigungen (von den niedrigsten 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 | Kalender.Lesen, Kalender.LesenSchreiben | |
| 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 | KanalNachricht.Lesen.Alle, Chat.Lesen.Alle |
| Nach Stream „Webhook-Abonnements“ suchen | Ruft Details aller Webhook-Abonnements ab. | Anwendung | KanalNachricht.Lesen.Alle, Chat.Lesen.Alle | |
| Webhook-Abonnement verlängern | Erneuert das angegebene Webhook-Abonnement. | Anwendung | KanalNachricht.Lesen.Alle, Chat.Lesen.Alle | |
| Webhook abonnieren | Erstellt ein Webhook-Abonnement für die angegebene Ressource. | Anwendung | KanalNachricht.Lesen.Alle, Chat.Lesen.Alle | |
| Webhook abbestellen | Löscht das angegebene Webhook-Abonnement. | Anwendung | KanalNachricht.Lesen.Alle, Chat.Lesen.Alle | |
- Standardmäßig ist der Gewährungstyp auf Autorisierungscode festgelegt.
- Alle Aktionen in den Kategorien Anwendungsmanagement, Channel-Management, Chat-Management, Benachrichtigungsmanagement und Teammanagement sowie die Aktion Zeitpläne suchen in der Kategorie Kalendermanagement verwenden den Alias für Verbindungen und Anmeldeinformationen der Microsoft Teams-Spoke. Diese Aktionen erfordern delegierte Berechtigungen.
- Die Spoke-Aktionen für die Kalender- und Webhook-Verwaltung (außer die Aktion „Zeitpläne in der Kalenderverwaltung suchen“) verwenden den Microsoft Teams Graph Client -Anmeldeinformationen-Alias für Verbindungen und Anmeldeinformationen. Diese Aktionen erfordern Anwendungsberechtigungen.
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 Benutzerinteraktion auf die Microsoft Teams Graph API zugreifen kann. Anweisungen zum Ändern des Erteilungstyps und der erforderlichen Konfigurationen finden Sie im Knowledge Base-Artikel KB1635160 in 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
Microsoft Teams Graph-Spoke erfordert die Registrierung einer Anwendung über das Azure-Portal Microsoft, 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 auf einer Instanz oder einem 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 Auswahlattribute für MID-Server festzulegen. Weitere Informationen finden Sie unter MID-Server.