Microsoft Teams Graph Spoke
Die Microsoft Teams Graph-Spoke verwaltet Anwendungen, Kalender, Teams, Kanäle, Chats, Benachrichtigungen und Webhooks in Microsoft Teams. Verwenden Sie zum Erstellen, Verwalten oder Löschen von Anwendern und Gruppen Microsoft EntraID-Spoke (früher MicrosoftAzure 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-SpokeWerden aus den Gruppen in erstellt Microsoft Entra-ID (früher Microsoft Azure Active Directory ). Dient zum Erstellen eines Teams mit Microsoft Teams Graph-Spoke, Die zugeordnete Gruppe muss in vorhanden sein Microsoft Entra-ID.
- Anwender- und Gruppenverwaltung kann mit durchgeführt werden Microsoft Nur Entra-ID und nicht Microsoft Teams Graph-Spoke.
- Teams können aus erstellt werden Microsoft Nur Office 365-Gruppe.
- Die Team-ID in Microsoft TeamsIst mit der Gruppen-ID der zugeordneten Gruppe in identisch 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-Spokev 4.3.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-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-Flows
Die Microsoft Teams Graph-SpokeStellt einen Beispiel-Flow bereit, Updates von ServiceNow-Incident-Arbeitsnotizen im Microsoft Teams-Chat veröffentlichen, um zu demonstrieren, wie die Aufgabe automatisiert wird, eine Microsoft Teams-Chat-Nachricht an den zugewiesenen Anwender mit Details zu den neuesten Arbeitsnotizen zu veröffentlichen, die dem Incident hinzugefügt wurden.
Spoke-Subflows
| 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 vom Webhook-Abonnement empfangenen Eingabedaten ab. |
| Subflow „Webhook-Abonnementhilfe Verlängern“ | Verlängert ein Abonnement, wenn eine Verlängerung erforderlich ist. Dies wird basierend auf Eingaben entschieden. |
| 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
Die Microsoft Teams Graph-SpokeStellt Aktionen zur Automatisierung von Team- und Kanalaufgaben bereit, wenn ein Incident in erstellt wird ServiceNow Instanz.
Sie können einige Aktionen ausführen, indem Sie die Microsoft Teams-Spoke-Verbindung und die verbleibenden Aktionen über die Microsoft Teams Graph Client-Anmeldeinformationen-Verbindung verwenden.
Die Aktionen in der folgenden Tabelle verwenden den Datensatz des Microsoft Teams-Spoke-Alias für Verbindungen und Anmeldeinformationen. Diese Aktionen erfordern die delegierten Berechtigungen.
| Kategorie | Aktion | Beschreibung | Erforderliche Berechtigungen (von den niedrigsten 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 Schulaccount) | TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser |
| Anwender-App-Installation suchen | Ruft die Details der Installation der angegebenen Anwendung für den Anwender ab. | Delegiert (Arbeits- oder Schulaccount) | TeamsAppInstallation.ReadForUser, TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser | |
| 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 Schulaccount) | Kalender.Lesen, Kalender.Lesen.Lesen |
| Channel-Management | Mitglied zu Kanal hinzufügen | Fügt dem angegebenen Kanal das angegebene Mitglied hinzu. | Delegiert (Arbeits- oder Schulaccount) | ChannelMember.Lesen.Schreiben.alle |
| Kanal erstellen | Erstellen Sie einen neuen Kanal in einem Team. | Delegiert (Arbeits- oder Schulaccount) | Kanal.Erstellen, Gruppe.ReadWrite.All**, Directory.ReadWrite.All** | |
| Kanal löschen | Entfernt den angegebenen Kanal aus dem erforderlichen Team und löscht alle Konversationen. | Delegiert (Arbeits- oder Schulaccount) | Kanal.Löschen.alle, Gruppe.Lesen.alle**, Verzeichnis.Lesen.Schreiben.alle** | |
| Kanal suchen | Ruft die Eigenschaften und Beziehungen eines Kanals ab. | Delegiert (Arbeits- oder Schulaccount) | Channel.ReadBasic.alle, 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 Schulaccount) | Channel.ReadBasic.alle, 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 Schulaccount) | ChannelMember.Lesen.alle, ChannelMember.Lesen.alle | |
| Kanalnachrichten suchen | Ruft die Liste der Nachrichten in einem Kanal eines Teams ab. | Delegiert (Arbeits- oder Schulaccount) | KanalNachricht.Lesen.alle | |
| Nach Kanälen suchen | Ruft die Liste der Nachrichten der Kanäle in diesem Team ab. | Delegiert (Arbeits- oder Schulaccount) | Channel.ReadBasic.alle, 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 Schulaccount) | ChannelMember.Lesen.Schreiben.alle | |
| Chat-Verwaltung | Chat erstellen | Erstellt einen Chat zwischen den Anwendern. | Delegiert (Arbeits- oder Schulaccount) | Chat.Erstellen, Chat.Lesen/Schreiben |
| Stream mit Chat-Nachrichten-Deltas suchen | Ruft die Liste der Nachrichten (ohne Antworten) aus dem Kanal eines Teams ab. | Delegiert (Arbeits- oder Schulaccount) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| Delegiert (privates Microsoft-Konto) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |||
| Chatnachrichten suchen | Ruft die Liste der Nachrichten in einem Chat ab. | Delegiert (Arbeits- oder Schulaccount) | Chat.Lesen, Chat.Lesen | |
| Chats suchen | Ruft die Liste der Chats ab, an denen der Anwender teilnimmt. | Delegiert (Arbeits- oder Schulaccount) | Chat.ReadBasic, Chat.Lesen, Chat.ReadSchreiben | |
| Nachricht suchen | Ruft die Details der angegebenen Nachricht ab. | Delegiert (Arbeits- oder Schulaccount) | Chat.Lesen, Chat.Lesen | |
| Stream mit Nachrichtenantworten suchen | Ruft die Liste der Antworten für die angegebene Nachricht aus dem Kanal eines Teams ab. | Delegiert (Arbeits- oder Schulaccount) | KanalNachricht.Lesen.alle | |
| Nachricht in Chat posten | Postet eine Nachricht in einem Microsoft Teams-Chat. | Delegiert (Arbeits- oder Schulaccount) | ChatMessage.Send, Chat.ReadWrite, Group.ReadWrite.All | |
| Benachrichtigungsverwaltung | Change-Details posten | Postet Details des erforderlichen Change in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulaccount) | ChannelMessage.Send, Group.ReadWrite.All** |
| Incident-Details posten | Postet Details des erforderlichen Incidents in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulaccount) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Nachricht posten | Postet eine Nachricht in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulaccount) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Problemdetails posten | Postet Details des erforderlichen Problems in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulaccount) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Antwort auf Nachricht posten | Postet eine Antwort auf die angegebene Nachricht. | Delegiert (Arbeits- oder Schulaccount) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Datensatzdetails posten | Postet Details des angegebenen Datensatzes im angegebenen Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulaccount) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Team-Management | Mitglied zu Team hinzufügen | Fügt den angegebenen Anwender dem angegebenen Team hinzu. | Delegiert (Arbeits- oder Schulaccount) | Teammitglied.Lesen.Schreiben.alle |
| Team archivieren | Wenn ein Team archiviert wird, können Anwender keine Nachrichten mehr in einem Kanal im Team senden oder „gefällt mir“-Nachrichten mehr senden oder keine Aktualisierungen der Teameinstellungen vornehmen. | Delegiert (Arbeits- oder Schulaccount) | TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
| Team erstellen | Erstellen Sie ein Team aus einer vorhandenen Office 365-Gruppe. Hinweis: Die Team-ID ist mit der Gruppen-ID identisch. | Delegiert (Arbeits- oder Schulaccount) | Gruppe.Lesen.Schreiben.alle, Verzeichnis.Lesen.Schreiben.alle | |
| Team löschen | Löscht das angegebene Team. | Delegiert (Arbeits- oder Schulaccount) | Gruppe.Lesen.Schreiben.alle | |
| Nach Team suchen | Ruft die Eigenschaften und Beziehungen eines Teams ab. | Delegiert (Arbeits- oder Schulaccount) | Team.ReadBasic.alle, 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 Schulaccount) | Teamkollege.Lesen.alle, Teamkollege.Lesen.alle | |
| Teams nach Anwender suchen | Listet Teams des Anwenders mit IDs und Anzeigenamen auf. | Delegiert (Arbeits- oder Schulaccount) | Team.ReadBasic.alle, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Anwender.Lesen.alle, Anwender.Lesen.alle, Anwender.ReadWrite.alle, Directory.Read.All**, Directory.ReadWrite.All** | |
| Mitglied aus Team entfernen | Entfernt das angegebene Mitglied aus dem angegebenen Team. | Delegiert (Arbeits- oder Schulaccount) | 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 Posts erneut mit „gefällt mir“ zu versehen. | Delegiert (Arbeits- oder Schulaccount) | TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
| Team aktualisieren | Aktualisiert die Eigenschaften eines bestimmten Teams. | Delegiert (Arbeits- oder Schulaccount) | TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All** | |
Die Aktionen in der folgenden Tabelle verwenden den Microsoft Teams Graph Client-Alias für Verbindungen und Anmeldeinformationen. Diese Aktionen erfordern die Anwendungsberechtigungen.
| Kategorie | Aktion | Beschreibung | Erforderliche Berechtigungen (von den niedrigsten 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 | Kalender.Lesen, Kalender.Lesen.Lesen | |
| 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.Lesen.alle, Chat.Lesen.alle |
| Nach Stream „Webhook-Abonnements“ suchen | Ruft Details aller Webhook-Abonnements ab. | Anwendung | ChannelMessage.Lesen.alle, Chat.Lesen.alle | |
| Webhook-Abonnement verlängern | Erneuert das angegebene Webhook-Abonnement. | Anwendung | ChannelMessage.Lesen.alle, Chat.Lesen.alle | |
| Webhook abonnieren | Erstellt ein Webhook-Abonnement für die angegebene Ressource. | Anwendung | ChannelMessage.Lesen.alle, Chat.Lesen.alle | |
| Webhook abbestellen | Löscht das angegebene Webhook-Abonnement. | Anwendung | ChannelMessage.Lesen.alle, Chat.Lesen.alle | |
- Standardmäßig ist der Gewährungstyp auf festgelegt Autorisierungscode .
- Alle Aktionen in den Kategorien „Anwendungsmanagement“, „Kanalmanagement“, „Chatmanagement“, „Benachrichtigungsmanagement“ und „Teammanagement“ sowie „Zeitpläne suchen“ in der Kategorie „Kalenderverwaltung“ verwenden Microsoft Teams-Spoke Alias für Verbindungen und Anmeldeinformationen und diese Aktionen erfordern delegierte Berechtigungen.
- Die Spoke-Aktionen „Kalender“ und „Webhook-Management“ (mit Ausnahme der Aktion „Zeitpläne suchen“ in „Kalenderverwaltung“) verwenden Microsoft Teams Graph Client-Anmeldeinformationen Alias für Verbindungen und Anmeldeinformationen und diese Aktionen erfordern Anwendungsberechtigungen.
Wenn Sie die Microsoft Teams Graph-Spoke ohne Anwenderinteraktion verwenden möchten, sollten Sie den Gewährungstyp in ändern Client-Anmeldeinformationen Damit die ServiceNow-Anwendung ohne Anwenderbeteiligung auf die Microsoft Teams Graph API zugreifen kann. Anweisungen zum Ändern des Gewährungstyps und der erforderlichen Konfigurationen finden Sie unter Knowledge Base-artikel – KB1635160 Ein ServiceNow: NOW-Support .
Weitere Informationen zu den erforderlichen Berechtigungen finden Sie unter Microsoft Teams Dokumentationan.
Weitere Informationen zum Zugriff auf die Kanal-ID und Gruppen-ID über Microsoft Teams, Siehe Microsoft Teams Dokumentationan.
Verfügbare KI-Agents
Installieren Now Assist Für Spokes und beginnen Sie mit der Verwendung der verfügbaren KI-Agents. Weitere Informationen finden Sie unter Now Assist Für Spokes.
- In ServiceNow Agentic-System können Sie einen agentischen Workflow erstellen, der aus einem Satz von Anweisungen für ein großes Sprachmodell (LLM) zusammen mit einem oder mehreren eigenständigen KI-Agents besteht, um ein Ziel auszuführen. Siehe Create an agentic workflow Informationen zum Hinzufügen von KI-Agents zum Erstellen von agentischen Workflows gemäß Ihren Anforderungen und zum Bereitstellen des erforderlichen Auslösers.
Sie können auch nach anderen verfügbaren KI-Agents suchen und sie Ihrem agentischen Workflow hinzufügen. Weitere Informationen finden Sie unter Find AI agents.
- Sie können einen Klon des erforderlichen Spoke-KI-Agents erstellen und entsprechend Ihren Anforderungen anpassen. Siehe Duplicate an AI agent Weitere Informationen zum Erstellen eines Klons.
- Siehe Now Assist AI agents Für Informationen zu KI-Agents.
| KI-Agent | Beschreibung |
|---|---|
| Microsoft Teams KI-Agent für Anwendungsmanagement | Automatisiert Aufgaben im Zusammenhang mit Microsoft Teams und IntegrationHub. Führt Aktionen aus, z. B. Suche nach App-Installationen und Installation von Anwendungen für die Anwender. |
| Microsoft Teams Kanalmanagement-KI-Agent | Verwaltet Microsoft Teams Kanäle über IntegrationHub. Es bietet Funktionen wie das Erstellen von Kanälen, das Verwalten von Mitgliedern und das Abrufen von Kanalinformationen. |
| Microsoft Teams Chat-Management-KI-Agent | Automatisiert Workflows zwischen ServiceNow und Microsoft Teams Durch Bereitstellung von Fähigkeiten wie der Suche nach Chats und Nachrichten. |
| Microsoft Teams Benachrichtigungsmanagement-KI-Agent | Automatisiert die Kommunikation zwischen ServiceNow und Microsoft Teams Durch Senden von Nachrichten, Updates und Antworten auf Microsoft Teams Kanäle. Der Service Desk-Mitarbeiter unterstützt Aktionen wie „Change-Details veröffentlichen“, „Nachricht veröffentlichen“ und „Antwort auf Nachricht veröffentlichen“, um ein effektives Benachrichtigungsmanagement für Change-Anforderungen sicherzustellen. |
| Microsoft Teams KI-Agent für Teammanagement | Automatisiert Aufgaben wie das Erstellen und Verwalten von Teams, das Hinzufügen oder Entfernen von Mitgliedern und das Abrufen von teambezogenen Informationen. Verbessert Teammanagement- und Kommunikations-Workflows innerhalb einer Organisation. |
| Microsoft Teams KI-Agent für Kalenderverwaltung | Automatisiert Workflows zwischen ServiceNow Und Microsoft Teams. Stellt Funktionen zur Kalenderverwaltung bereit. Führt Aktionen wie Löschen und Abrufen von Besprechungsdetails aus. |
- Möglicherweise sind KI-Agenten mit installiert Now AssistAnwendung, die nicht in Agenten-Workflows verwendet wird. Informationen zum Anzeigen aller in Ihrer Instanz verfügbaren Agenten finden Sie unter Suchen Sie KI-Agenten .
- Um Agenten zu finden, die möglicherweise nicht auf Ihrer Instanz installiert sind, besuchen Sie die KI-Agenten-Marktplatz Auf ServiceNow Store.
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 von Webhook-Abonnements an. |
Microsoft Account-Anforderungen
Die Microsoft Teams Graph-SpokeErfordert die Registrierung einer Anwendung mit Microsoft Azure-Portal zum Generieren von OAuth 2,0-Token.
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 Richten Sie ein Microsoft Teams Graph-Spoke.
MID-Server-Anforderungen
Die Microsoft Teams Graph-SpokeAktionen verwenden REST-Aufrufe, die auf einer Instanz oder einer ausgeführt werden können MID-Server. Verwenden Sie den Verbindungsdatensatz, der dem zugeordnet ist Microsoft Alias zum Konfigurieren, wo Aktionen ausgeführt und festgelegt werden MID-Server Auswahlattribute. Weitere Informationen finden Sie unter MID-Server.
Zum Einrichten von MID-ServerInformationen zu dieser Spoke finden Sie unter Einrichten MID-Server Für eine Spoke.