Microsoft Teams Graph Spoke
Die MicrosoftMicrosoft Azure Event Hubs Teams Graph-Spoke verwaltet Anwendungen, Kalender, Teams, Kanäle, Chats, Benachrichtigungen und Webhooks in MicrosoftMicrosoft Azure Event Hubs Teams. Um Benutzer und Gruppen zu erstellen, zu verwalten oder zu löschen, verwenden Sie die MicrosoftMicrosoft Azure Event Hubs Entra ID-Spoke (früher MicrosoftMicrosoft Azure Event Hubs 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 MicrosoftMicrosoft Azure Event Hubs Teams Graph-Spoke werden aus den Gruppen in MicrosoftMicrosoft Azure Event Hubs Entra ID (früher MicrosoftMicrosoft Azure Event Hubs Azure Active Directory) erstellt. Um ein Team mit MicrosoftMicrosoft Azure Event Hubs Teams Graph-Spokezu erstellen, muss die zugehörige Gruppe in der Entra-ID MicrosoftMicrosoft Azure Event Hubs vorhanden sein.
- Die Anwender- und Gruppenverwaltung kann nur mit MicrosoftMicrosoft Azure Event Hubs Entra ID und nicht mit MicrosoftMicrosoft Azure Event Hubs Teams Graph-Spokeerfolgen.
- Teams können nur aus der Office 365-Gruppe MicrosoftMicrosoft Azure Event Hubs erstellt werden.
- Die Team-ID in MicrosoftMicrosoft Azure Event Hubs Teams entspricht der Gruppen-ID der zugehörigen Gruppe in MicrosoftMicrosoft Azure Event Hubs, Entra ID.
IntegrationHub-Abonnement
Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht.
Spoke-Version
MicrosoftMicrosoft Azure Event Hubs Teams Graph-Spoke v4.1.2 ist die neueste Version.
Unterstützte Version
MicrosoftMicrosoft Azure Event Hubs 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-Flows
MicrosoftMicrosoft Azure Event Hubs 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-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 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
MicrosoftMicrosoft Azure Event Hubs 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 Autorisierungscodefestgelegt.
- 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 MicrosoftMicrosoft Azure Event Hubs Teams Dokumentation.
Weitere Informationen zum Zugriff auf die Kanal-ID und die Gruppen-ID über MicrosoftMicrosoft Azure Event Hubs Teamsfinden Sie unter MicrosoftMicrosoft Azure Event Hubs 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. |
MicrosoftMicrosoft Azure Event Hubs Kontoanforderungen
MicrosoftMicrosoft Azure Event Hubs Teams Graph-Spoke erfordert die Registrierung einer Anwendung über das Azure-Portal MicrosoftMicrosoft Azure Event Hubs, 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 Richten Sie die ein MicrosoftMicrosoft Azure Event Hubs Teams Graph-Spoke.
MID-Server-Anforderungen
Die MicrosoftMicrosoft Azure Event Hubs 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 MicrosoftMicrosoft Azure Event Hubs 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.