Microsoft Teams Graph Spoke
Die MicrosoftMicrosoft Azure Event Hubs Teams-Graph-SpokeVerwaltet Anwendungen, Kalender, Teams, Kanäle, Chats, Benachrichtigungen und Webhooks in MicrosoftMicrosoft Azure Event Hubs Teams. Verwenden Sie zum Erstellen, Verwalten oder Löschen von Anwendern und Gruppen MicrosoftMicrosoft Azure Event HubsEntra ID-Spoke (früher MicrosoftMicrosoft Azure Event HubsAzure 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-SpokeWerden aus den Gruppen in erstellt MicrosoftMicrosoft Azure Event HubsEntra-ID (früher MicrosoftMicrosoft Azure Event Hubs Azure Active Directory ). Dient zum Erstellen eines Teams mit MicrosoftMicrosoft Azure Event Hubs Teams-Graph-Spoke, Die zugeordnete Gruppe muss in vorhanden sein MicrosoftMicrosoft Azure Event HubsEntra-ID.
- Anwender- und Gruppenverwaltung kann mit durchgeführt werden MicrosoftMicrosoft Azure Event HubsNur Entra-ID und nicht MicrosoftMicrosoft Azure Event Hubs Teams-Graph-Spoke.
- Teams können aus erstellt werden MicrosoftMicrosoft Azure Event HubsNur Office 365-Gruppe.
- Die Team-ID in MicrosoftMicrosoft Azure Event Hubs TeamsIst mit der Gruppen-ID der zugeordneten Gruppe in identisch MicrosoftMicrosoft Azure Event HubsEntra-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-Spokev 4.1.2 Ist die neueste Version.
Unterstützte Version
MicrosoftMicrosoft Azure Event Hubs Graph REST API v1.0.
Spoke-Abhängigkeiten
- ServiceNow IntegrationHub Laufzeit (com.glide.hub.integration.runtime)
- Flow Designer-Modell (com.glide.hub.designer_backend.model)
- Komplexes Objekt (com.Glide.cobject)
- ServiceNow IntegrationHub Aktionsschritt – 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 MicrosoftMicrosoft Azure Event Hubs Teams-Graph-SpokeBietet einen Beispiel-Flow, Aktualisierung 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, die dem Incident hinzugefügt wurden, zu veröffentlichen.
Spoke-Subflows
| Subflow | Beschreibung |
|---|---|
| Incident-Details veröffentlichen | Veröffentlicht Details des erforderlichen Incidents in einem Microsoft Teams-Kanal. |
| Verarbeiten Sie Eingehende Benachrichtigungen | 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. |
| Webhook-Abonnements Verlängern | 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 MicrosoftMicrosoft Azure Event Hubs Teams-Graph-SpokeStellt Aktionen zur Automatisierung von Team- und Kanalaufgaben bereit, wenn ein Incident in erstellt wird ServiceNowInstanz.
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 verwenden.
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 bis zu den meisten Privilegierungen) | |
|---|---|---|---|---|
| Anwendungsmanagement | Installieren Sie die Anwendung für den Anwender | Installiert die angegebene Anwendung im persönlichen Bereich des Anwenders. | Delegiert (Arbeits- oder Schulaccount) | TeamsAppInstallation.ReadWriteSelfForAnwender, TeamsAppInstallation.ReadWriteForAnwender |
| Suchen Sie nach Installation der Anwenderanwendung | Ruft die Details der Installation der angegebenen Anwendung für den Anwender ab. | Delegiert (Arbeits- oder Schulaccount) | TeamsAppInstallation.ReadForAnwender, TeamsAppInstallation.ReadWriteSelfForAnwender, TeamsAppInstallation.ReadWriteForAnwender | |
| Kalenderverwaltung | Suchen Sie nach Zeitplänen | Ruft die Verfügbarkeitsinformationen (frei oder beschäftigt) für eine Sammlung von Anwendern, Verteilungslisten oder Ressourcen (Räume oder Ausrüstung) für den angegebenen Zeitraum ab. | Delegiert (Arbeits- oder Schulaccount) | Kalender.Lesen, Kalender.Lesen.Lesen |
| Channel-Management | Fügen Sie dem Kanal ein Mitglied hinzu | Fügt dem angegebenen Kanal das angegebene Mitglied hinzu. | Delegiert (Arbeits- oder Schulaccount) | ChannelMember.Lese/Schreiben.alle |
| Kanal erstellen | Erstellen Sie einen neuen Kanal in einem Team. | Delegiert (Arbeits- oder Schulaccount) | Kanal.Erstellen, Gruppe.Lesen.alle**, Verzeichnis.Lesen.Schreiben.alle** | |
| 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** | |
| Suchen Sie nach Kanal | Ruft die Eigenschaften und Beziehungen eines Kanals ab. | Delegiert (Arbeits- oder Schulaccount) | Kanal.LeseteBasic.alle, Kanaleinstellungen.Lesen.alle, Kanaleinstellungen.Lesen.alle, Gruppe.Lesen.alle**, Gruppe.Lesen.alle**, Gruppe.Lesen.alle**, Verzeichnis.Lesen.alle**, Verzeichnis.Lesen.alle** | |
| Kanal nach Name suchen | Ruft die Kanal-ID und die Eigenschaften anhand eines Kanalnamens und einer Team-ID ab. | Delegiert (Arbeits- oder Schulaccount) | Kanal.LeseteBasic.alle, Kanaleinstellungen.Lesen.alle, Kanaleinstellungen.Lesen.alle, Gruppe.Lesen.alle**, Gruppe.Lesen.alle**, Gruppe.Lesen.alle**, Verzeichnis.Lesen.alle**, Verzeichnis.Lesen.alle** | |
| Nach Kanalmitgliedern suchen | Ruft eine Liste von Kanalmitgliedern ab. | Delegiert (Arbeits- oder Schulaccount) | ChannelMember.Lesen.alle, ChannelMember.Lesen.alle | |
| Suchen Sie nach Kanalnachrichten | Ruft die Liste der Nachrichten in einem Kanal eines Teams ab. | Delegiert (Arbeits- oder Schulaccount) | KanalNachricht.Lesen.alle | |
| Suchen Sie nach Kanälen | Ruft die Liste der Kanäle in diesem Team ab. | Delegiert (Arbeits- oder Schulaccount) | Kanal.LeseteBasic.alle, Kanaleinstellungen.Lesen.alle, Kanaleinstellungen.Lesen.alle, Gruppe.Lesen.alle**, Gruppe.Lesen.alle**, Gruppe.Lesen.alle**, Verzeichnis.Lesen.alle**, Verzeichnis.Lesen.alle** | |
| Entfernen Sie Mitglied aus Kanal | Entfernt den angegebenen Anwender aus dem angegebenen Kanal. | Delegiert (Arbeits- oder Schulaccount) | ChannelMember.Lese/Schreiben.alle | |
| Chatverwaltung | Chat erstellen | Erstellt einen Chat zwischen den Anwendern. | Delegiert (Arbeits- oder Schulaccount) | Chat.Erstellen, Chat.Lesen/Schreiben |
| Deltas-Stream für Chatnachrichten suchen | Ruft die Liste der Nachrichten (ohne die Antworten) aus dem Kanal eines Teams ab. | Delegiert (Arbeits- oder Schulaccount) | E-Mail.LeseStandard, E-Mail.Lesen, E-Mail.Leseschreiben | |
| Delegiert (privates Microsoft-Konto) | E-Mail.LeseStandard, E-Mail.Lesen, E-Mail.Leseschreiben | |||
| Suchen Sie nach Chatnachrichten | Ruft die Liste der Nachrichten in einem Chat ab. | Delegiert (Arbeits- oder Schulaccount) | Chat.Lesen, Chat.Lesen | |
| Suchen Sie nach Chats | Ruft die Liste der Chats ab, denen der Anwender angehört. | Delegiert (Arbeits- oder Schulaccount) | Chat.ReadBasic, Chat.Lesen, Chat.Lesen | |
| Nachricht suchen | Ruft die Details der angegebenen Nachricht ab. | Delegiert (Arbeits- oder Schulaccount) | Chat.Lesen, Chat.Lesen | |
| Stream mit Nachrichtenantwort 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 im Chat veröffentlichen | Postet eine Nachricht in einem Microsoft Teams-Chat. | Delegiert (Arbeits- oder Schulaccount) | ChatNachricht.Senden, Chat.Lesen Schreiben, Gruppe.Lesen.Schreiben.alle | |
| Benachrichtigungsverwaltung | Change-Details veröffentlichen | Veröffentlicht Details des erforderlichen Changes in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulaccount) | KanalNachricht.Senden, Gruppe.Lesen.Schreiben.alle** |
| Incident-Details veröffentlichen | Veröffentlicht Details des erforderlichen Incidents in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulaccount) | KanalNachricht.Senden, Gruppe.Lesen.Schreiben.alle** | |
| Nachricht veröffentlichen | Postet eine Nachricht in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulaccount) | KanalNachricht.Senden, Gruppe.Lesen.Schreiben.alle** | |
| Problemdetails veröffentlichen | Postet Details des erforderlichen Problems in einem Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulaccount) | KanalNachricht.Senden, Gruppe.Lesen.Schreiben.alle** | |
| Antwort auf Nachricht posten | Postet eine Antwort auf die angegebene Nachricht. | Delegiert (Arbeits- oder Schulaccount) | KanalNachricht.Senden, Gruppe.Lesen.Schreiben.alle** | |
| Datensatzdetails Veröffentlichen | Postet Details des angegebenen Datensatzes im angegebenen Microsoft Teams-Kanal. | Delegiert (Arbeits- oder Schulaccount) | 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 Schulaccount) | Teammitglied.Lesen/Schreiben.alle |
| Archivieren Sie Das Team | Wenn ein Team archiviert wird, können Anwender keine Nachrichten mehr in einem Kanal im Team senden oder „gefällt mir“-Nachrichten senden oder keine Aktualisierungen der Teameinstellungen vornehmen. | Delegiert (Arbeits- oder Schulaccount) | Teameinstellungen.Lesen.Schreiben.alle, Gruppe.Lesen.alle**, Verzeichnis.Lesen.Schreiben.alle** | |
| 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.Lese-/Schreibvorgang.alle, Verzeichnis.Lese-/Schreibzugriff.alle | |
| Team löschen | Löscht das angegebene Team. | Delegiert (Arbeits- oder Schulaccount) | Gruppe.Lesen/Schreiben.alle | |
| Sucht nach Team | Ruft die Eigenschaften und Beziehungen eines Teams ab. | Delegiert (Arbeits- oder Schulaccount) | Team.Lesen.alle, Teameinstellungen.Lesen.alle, Teameinstellungen.Lesen.alle, Teameinstellungen.Lesen.alle, Gruppe.Lesen.alle**, Gruppe.Lesen.alle**, Gruppe.Lesen.alle**, Verzeichnis.Lesen.alle**, Verzeichnis.Lesen.alle** | |
| Suchen Sie nach Stream „Teammitglieder“ | Ruft die Liste der Teammitglieder ab. | Delegiert (Arbeits- oder Schulaccount) | Teamkollege.Lesen.alle, Teamkollege.Lesen.alle | |
| Sucht Teams nach Anwender | Listet Teams des Anwenders mit IDs und ihren Anzeigenamen auf. | Delegiert (Arbeits- oder Schulaccount) | Team.LeseteBasic.alle, Teameinstellungen.Lesen.alle, Teameinstellungen.Lesen.alle, Anwender.Lesen.alle, Anwender.Lesen.alle, Anwender.Lesen.alle, Verzeichnis.Lesen.alle**, Verzeichnis.Lesen.alle** | |
| Entfernen Sie ein Mitglied aus dem Team | 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 zu gefallen. | Delegiert (Arbeits- oder Schulaccount) | Teameinstellungen.Lesen.Schreiben.alle, Gruppe.Lesen.alle**, Verzeichnis.Lesen.Schreiben.alle** | |
| Aktualisieren Sie Das Team | Aktualisiert die Eigenschaften eines bestimmten Teams. | Delegiert (Arbeits- oder Schulaccount) | Teameinstellungen.Lesen.Schreiben.alle, Gruppe.Lesen.alle**, Verzeichnis.Lesen.Schreiben.alle** | |
Die Aktionen in der folgenden Tabelle verwenden den Datensatz des Microsoft Teams Graph Client-Verbindungs- und Anmeldeinformationsalias. Diese Aktionen erfordern die Anwendungsberechtigungen.
| Kategorie | Aktion | Beschreibung | Erforderliche Berechtigungen (von den niedrigsten bis zu den meisten Privilegierungen) | |
|---|---|---|---|---|
| Kalenderverwaltung | Erstellen Sie Eine Besprechung | Erstellt ein Online-Besprechungsereignis im MS Teams-Kalender. | Anwendung | Calendars.ReadWrite |
| Besprechung Löschen | Löscht das Besprechungsereignis aus dem MS Teams-Kalender. | Anwendung | Calendars.ReadWrite | |
| Besprechung suchen | Ruft Details zum Besprechungsereignis aus dem MS Teams-Kalender ab. | Anwendung | Kalender.Lesen | |
| Sucht nach Besprechungsvorkommen | Ruft die ID der untergeordneten Wiederholung-Besprechung aus dem MS Teams-Kalender ab. | Anwendung | Kalender.Lesen | |
| Suchen Sie nach Stream „Besprechungen“ | Ruft Details zu Besprechungsereignissen aus dem MS Teams-Kalender ab. | Anwendung | Kalender.Lesen, Kalender.Lesen.Lesen | |
| Aktualisieren Sie Die Besprechung | Erstellt ein Online-Besprechungsereignis im MS Teams-Kalender. | Anwendung | Calendars.ReadWrite | |
| Webhook-Verwaltung | Suchen Sie nach Webhook-Abonnement | Ruft Details des erforderlichen Webhook-Abonnements ab. | Anwendung | ChannelMessage.Lesen.alle, Chat.Lesen.alle |
| Suchen Sie nach Webhook-Abonnementstream | Ruft Details aller Webhook-Abonnements ab. | Anwendung | ChannelMessage.Lesen.alle, Chat.Lesen.alle | |
| Webhook-Abonnement Verlängern | Verlängert 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, Kanalverwaltung, 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-Verwaltung“ (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 MicrosoftMicrosoft Azure Event Hubs Teams Dokumentationan.
Um weitere Informationen zum Zugriff auf die Kanal-ID und Gruppen-ID über zu erhalten MicrosoftMicrosoft Azure Event Hubs Teams, Siehe MicrosoftMicrosoft Azure Event Hubs Teams Dokumentationan.
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. |
MicrosoftMicrosoft Azure Event Hubs Account-Anforderungen
Die MicrosoftMicrosoft Azure Event Hubs Teams-Graph-SpokeErfordert die Registrierung einer Anwendung mit MicrosoftMicrosoft Azure Event HubsAzure-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. Durch die Verwendung eines Alias müssen bei der Verwendung mehrerer Umgebungen nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfiguriert werden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie keine Aktionen aktualisieren, die die Verbindung verwenden.
Informationen zum Einrichten der Spoke finden Sie unter Richten Sie ein MicrosoftMicrosoft Azure Event Hubs Teams-Graph-Spoke.
MID-Server Anforderungen
Die MicrosoftMicrosoft Azure Event Hubs 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 MicrosoftMicrosoft Azure Event HubsAlias zum Konfigurieren, wo Aktionen ausgeführt und festgelegt werden MID-ServerAuswahlattribute. Weitere Informationen finden Sie unter MID-Server .