Microsoft Teams Graph Rayon

Demander des applications dans l'App Store

Visitez le site Web ServiceNow Store pour découvrir toutes les applications disponibles et pour obtenir des informations sur la procédure à suivre pour soumettre des demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les ServiceNow Storenotes de publication relatives à l'historique des versions.

Remarque :

Les équipes de sont Microsoft Spoke Teams Graph créées à partir des groupes dans Microsoft Entra ID (anciennement Microsoft Azure Active Directory). Pour créer une équipe à l’aide du Microsoft Spoke Teams Graph, le groupe associé doit être présent dans Microsoft Entra ID.
La gestion des utilisateurs et des groupes peut être effectuée à l’aide Microsoft d’Entra ID uniquement et non Microsoft Spoke Teams Graph.
Les équipes peuvent être créées à partir du Microsoft groupe Office 365 uniquement.
L’ID d’équipe dans Microsoft Teams est le même que l’ID de groupe du groupe associé dans Microsoft Entra ID.

Abonnement à Hub d'intégration

Ce spoke requiert un abonnement au Centre d'intégration. Pour plus d'informations, consultez Calendriers juridiques - Vue d'ensemble du Centre d'intégration.

Version de spoke

Microsoft Spoke Teams Graph v4.1.2 est la dernière version.

Version prise en charge

Microsoft API REST Graph v1.0.

Dépendances des spokes

Si vous rencontrez des difficultés pour installer l'application, assurez-vous que les modules d'extension dépendants suivants sont installés :

ServiceNow Hub d'intégration Runtime (com.glide.hub.integration.runtime)
Modèle Concepteur de flux (com.glide.hub.designer_backend.model)
Objet complexe (com.glide.cobject)
ServiceNow Hub d'intégration Action Step - REST (com.glide.hub.action_step.rest)
ServiceNow Hub d'intégration Modèle d’action : flux de données (com.glide.hub.action_type.datastream)
Tables distantes (com.glide.script.vtable)
Étape d’action ServiceNow Centre d'intégration : obtenir les informations de connexion (com.glide.hub.action_step.get_connection_info)

Remarque :

Certains de ces modules d'extension sont des fonctionnalités sous licence et nécessitent des licences appropriées s'ils sont utilisés en dehors de l'implémentation des spokes.

Flux de spoke

Le Microsoft Spoke Teams Graph fournit un exemple de flux, Publier les notes de travail d’incident ServiceNow Mises à jour de la messagerie instantanée Microsoft Teams, pour démontrer l’automatisation de la tâche de publication d’un message de messagerie instantanée Microsoft Teams à l’utilisateur affecté avec des détails sur les dernières notes de travail ajoutées à l’incident.

Flux secondaires du spoke

L’fournit Microsoft Spoke Teams Graph des exemples de flux secondaires pour illustrer l’automatisation des tâches. Pour personnaliser un exemple de flux, copiez-le dans le périmètre de l’application requis. Exemples de flux secondaires disponibles :

Tableau 1. Microsoft Teams Graph Flux secondaires du spoke
Flux secondaire	Description
Détails post-incident	Publie les détails de l'incident requis sur un canal Microsoft Teams.
Traiter les notifications entrantes	Récupère les détails du message spécifié en fonction des données d’entrée reçues de l’abonnement webhook.
Renouveler le flux secondaire d’aide d’abonnement Webhook	Renouvelle un abonnement si le renouvellement est requis, décidé en fonction des entrées.
Renouveler les abonnements Webhook.	Récupère tous les abonnements à un webhook et les renouvelle si le renouvellement est nécessaire.
S'abonner au webhook	Crée un abonnement à un webhook pour le canal de l’équipe spécifiée.

Actions du spoke

Fournit Microsoft Spoke Teams Graph des actions permettant d’automatiser les tâches de l’équipe et du canal lorsqu’un incident est créé dans l’instance ServiceNow .

Vous pouvez effectuer certaines actions à l’aide de la connexion Spoke Microsoft Teams et les actions restantes à l’aide de la connexion Informations d’identification client Microsoft Teams Graph.

Les actions de la table suivante utilisent l’enregistrement d’alias de connexion et d’informations d’identification du spoke Microsoft Teams. Ces actions nécessitent des autorisations déléguées.

Tableau 2. Microsoft Teams Graph Actions de spokes qui utilisent l’alias de connexion et d’informations d’identification Microsoft Teams Spoke
Catégorie	Action	Description	Autorisations requises (du moins au plus privilégié)
Gestion des applications	Installer l'application pour l'utilisateur	Installe l'application spécifiée dans le périmètre personnel de l'utilisateur.	Délégué (compte professionnel ou scolaire)	TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser
Gestion des applications	Rechercher l'installation de l'application utilisateur	Récupère les détails de l'installation de l'application spécifiée pour l'utilisateur.	Délégué (compte professionnel ou scolaire)	TeamsAppInstallation.ReadForUser, TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser
Gestion des calendriers	Rechercher des calendriers	Récupère les informations sur la disponibilité (libre ou occupé) d’une collection d’utilisateurs, de listes de distribution ou de ressources (salles ou équipement) pour la période spécifiée.	Délégué (compte professionnel ou scolaire)	Calendriers.Lecture, Calendriers.LectureÉcriture
Channel Management	Ajouter des membres au canal	Ajoute le membre spécifié au canal spécifié.	Délégué (compte professionnel ou scolaire)	MembreCanal.Lecture-écriture.Tous
	Créer un canal	Créez un canal dans une équipe.	Délégué (compte professionnel ou scolaire)	Canal.Créer, Group.Lectureécriture.Tous, Répertoire.Lecture-écriture.Tous
	Supprimer un canal	Supprime le canal spécifié de l’équipe requise et supprime toutes les conversations.	Délégué (compte professionnel ou scolaire)	Canal.Suppression.Tout, Groupe.Lectureécriture.Tous, Répertoire.Lecture-écriture.Tous
	Rechercher le canal	Récupère les propriétés et les relations d’un canal.	Délégué (compte professionnel ou scolaire)	Canal.LectureBase.Tout, ParamètresCanal.Lecture.Tout, ParamètresCanal.ÉcritureLecture.Tout, Groupe.Lecture.Tout, Groupe.Lecture.Tout, Répertoire.Lecture.Tout, Répertoire.LectureÉcriture.Tout
	Rechercher le canal par nom	Récupère l’ID et les propriétés du canal à partir d’un nom de canal et d’un ID d’équipe.	Délégué (compte professionnel ou scolaire)	Canal.LectureBase.Tout, ParamètresCanal.Lecture.Tout, ParamètresCanal.ÉcritureLecture.Tout, Groupe.Lecture.Tout, Groupe.Lecture.Tout, Répertoire.Lecture.Tout, Répertoire.LectureÉcriture.Tout
	Rechercher les membres du canal	Récupère une liste des membres du canal.	Délégué (compte professionnel ou scolaire)	MembreCanal.Lecture.Tout, MembreCanal.Lecture-écriture.Tous
	Rechercher des messages de canal	Récupère la liste des messages dans un canal d'une équipe.	Délégué (compte professionnel ou scolaire)	MessageCanal.Lecture.Tous
	Rechercher les canaux	Récupère la liste de canaux dans cette équipe.	Délégué (compte professionnel ou scolaire)	Canal.LectureBase.Tout, ParamètresCanal.Lecture.Tout, ParamètresCanal.ÉcritureLecture.Tout, Groupe.Lecture.Tout, Groupe.Lecture.Tout, Répertoire.Lecture.Tout, Répertoire.LectureÉcriture.Tout
	Supprimer un membre du canal	Supprime l'utilisateur spécifié du canal spécifié.	Délégué (compte professionnel ou scolaire)	MembreCanal.Lecture-écriture.Tous
Gestion de la messagerie instantanée	Créer une messagerie instantanée	Crée une conversation instantanée entre les utilisateurs.	Délégué (compte professionnel ou scolaire)	Chat.Create, Chat.ReadWrite
	Rechercher le flux de delta des messages de messagerie instantanée	Récupère la liste des messages (sans les réponses) à partir du canal d’une équipe.	Délégué (compte professionnel ou scolaire)	Mail.ReadBasic, Mail.Read, Mail.ReadWrite
			Délégué (compte Microsoft personnel)	Mail.ReadBasic, Mail.Read, Mail.ReadWrite
	Rechercher des messages de messagerie instantanée	Récupère la liste des messages dans une messagerie instantanée.	Délégué (compte professionnel ou scolaire)	Chat.Read, Chat.ReadWrite
	Rechercher des messageries	Récupère la liste des messageries dont l'utilisateur fait partie.	Délégué (compte professionnel ou scolaire)	Chat.ReadBasic, Chat.Read, Chat.ReadWrite
	Rechercher un message	Récupère les détails du message spécifié.	Délégué (compte professionnel ou scolaire)	Chat.Read, Chat.ReadWrite
	Rechercher le flux de réponses de message	Récupère la liste des réponses pour le message spécifié à partir du canal d'une équipe.	Délégué (compte professionnel ou scolaire)	MessageCanal.Lecture.Tous
	Publier un message sur la messagerie instantanée	Publie un message dans une messagerie instantanée Microsoft Teams.	Délégué (compte professionnel ou scolaire)	ChatMessage.Send, Chat.ReadWrite, Group.ReadWrite.All
Gestion de la notification	Publier les détails du changement	Publie les détails du changement requis sur un canal Microsoft Teams.	Délégué (compte professionnel ou scolaire)	CanalMessage.Envoyer, Groupe.Lecture-Écriture.Tous**
	Détails post-incident	Publie les détails de l'incident requis sur un canal Microsoft Teams.	Délégué (compte professionnel ou scolaire)	CanalMessage.Envoyer, Groupe.Lecture-Écriture.Tous**
	Publier un message	Publie un message sur un canal Microsoft Teams.	Délégué (compte professionnel ou scolaire)	CanalMessage.Envoyer, Groupe.Lecture-Écriture.Tous**
	Publier les détails du problème	Publie les détails du problème requis sur un canal Microsoft Teams.	Délégué (compte professionnel ou scolaire)	CanalMessage.Envoyer, Groupe.Lecture-Écriture.Tous**
	Publier la réponse au message	Publie une réponse au message spécifié.	Délégué (compte professionnel ou scolaire)	CanalMessage.Envoyer, Groupe.Lecture-Écriture.Tous**
	Publier les détails de l'enregistrement	Publie les détails de l'enregistrement spécifié sur le canal Microsoft Teams spécifié.	Délégué (compte professionnel ou scolaire)	CanalMessage.Envoyer, Groupe.Lecture-Écriture.Tous**
Gestion des équipes	Ajouter un membre à l'équipe	Ajoute l’utilisateur spécifié à l’équipe spécifiée.	Délégué (compte professionnel ou scolaire)	MembreÉquipe.Lecture-écriture.Tous
	Équipe d'archivage	Lorsqu’une équipe est archivée, les utilisateurs ne peuvent plus envoyer ou aimer de messages sur ses canaux, ni mettre à jour les paramètres associés.	Délégué (compte professionnel ou scolaire)	TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All
	Créer une équipe	Créez une équipe à partir d’un groupe Office 365 existant. Remarque : L’ID de l’équipe est le même que l’ID du groupe.	Délégué (compte professionnel ou scolaire)	Groupe.Lectureécriture.Tout, Répertoire.Lecture-écriture.Tous
	Supprimer l'équipe	Supprime l'équipe spécifiée.	Délégué (compte professionnel ou scolaire)	Groupe.Lectureécriture.Tous
	Rechercher une équipe	Récupère les propriétés et les relations d’une équipe.	Délégué (compte professionnel ou scolaire)	Équipe.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All
	Rechercher le flux des membres de l'équipe	Récupère une liste des membres du canal.	Délégué (compte professionnel ou scolaire)	MembreÉquipe.Lecture.Tout, MembreÉquipe.Lectureécriture.Tous
	Rechercher Teams par utilisateur	Répertorie les équipes de l'utilisateur contenant des ID et leur nom d'affichage.	Délégué (compte professionnel ou scolaire)	Équipe.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All
	Supprimer un membre de l'équipe	Supprime le membre spécifié de l'équipe spécifiée.	Délégué (compte professionnel ou scolaire)	MembreÉquipe.Lecture-écriture.Tous
	Désarchiver l'équipe	Restaure une équipe archivée. Permet aux membres de publier sur les canaux de l’équipe, de faire des commentaires et d’aimer à nouveau les publications.	Délégué (compte professionnel ou scolaire)	TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All
	Mettre à jour l'équipe	Met à jour les propriétés d’une équipe spécifique.	Délégué (compte professionnel ou scolaire)	TeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All

Les actions de la table suivante utilisent l’enregistrement d’alias de connexion et d’informations d’identification Microsoft Teams Graph Client. Ces actions nécessitent les autorisations de l’application.

Tableau 3. Microsoft Teams Graph Actions de spokes qui utilisent l’alias de connexion et d’informations d’identification des informations d’identification de Microsoft Teams Graph Client
Catégorie	Action	Description	Autorisations requises (du moins au plus privilégié)
Gestion des calendriers	Créer une réunion	Crée un événement de réunion en ligne dans le calendrier MS Teams.	Demande	Calendars.ReadWrite
	Supprimer la réunion	Supprime l'événement de réunion du calendrier MS Teams.	Demande	Calendars.ReadWrite
	Rechercher une réunion	Récupère les détails de l'événement de réunion à partir du calendrier MS Teams.	Demande	Calendars.Read
	Rechercher les occurrences de réunion	Récupère l'ID de réunion enfant de récurrence à partir du calendrier MS Teams.	Demande	Calendars.Read
	Rechercher les flux de réunions	Récupère les détails des événements de réunion à partir du calendrier MS Teams.	Demande	Calendriers.Lecture, Calendriers.LectureÉcriture
	Mettre à jour la réunion	Crée un événement de réunion en ligne dans le calendrier MS Teams.	Demande	Calendars.ReadWrite
Gestion des Webhook	Rechercher un abonnement de webhooks	Récupère les détails de l'abonnement à un webhook requis.	Demande	CanalMessage.Lecture.Tout, Messagerie instantanée.Lecture.Tout
	Rechercher un flux d'abonnements de webhooks	Récupère les détails de tous les abonnements à un webhook.	Demande	CanalMessage.Lecture.Tout, Messagerie instantanée.Lecture.Tout
	Renouveler l'abonnement Webhook.	Renouvelle l'abonnement de webhook spécifié.	Demande	CanalMessage.Lecture.Tout, Messagerie instantanée.Lecture.Tout
	S'abonner au webhook	Crée un abonnement à un webhook pour la ressource spécifiée.	Demande	CanalMessage.Lecture.Tout, Messagerie instantanée.Lecture.Tout
	Se désabonner du webhook	Supprime l'abonnement de webhook spécifié.	Demande	CanalMessage.Lecture.Tout, Messagerie instantanée.Lecture.Tout

Important :

Assurez-vous de bien connaître ces configurations de spoke par défaut.

Par défaut, le type d’attribution est défini sur Code d’autorisation.
Toutes les actions des catégories Gestion des applications, Gestion des canaux, Gestion de la messagerie instantanée, Gestion des notifications et Gestion des équipes, ainsi que l’action Rechercher des calendriers dans la catégorie Gestion des calendriers utilisent l’alias de connexion et d’informations d’identification Microsoft Teams Spoke et ces actions nécessitent des autorisations déléguées.
Les actions de spoke Gestion des calendriers et des Webhook (à l’exception de l’action Rechercher des calendriers dans Gestion des calendriers) utilisent les alias de connexion et d’informations d’identification des informations d’identification de Microsoft Teams Graph Client , et ces actions nécessitent des autorisations d’application.

Si vous souhaitez utiliser le spoke Microsoft Teams Graph sans interaction de l’utilisateur, vous devez changer le type d’attribution en Informations d’identification du client afin que l’application ServiceNow puisse accéder à l’API Microsoft Teams Graph sans intervention de l’utilisateur. Pour obtenir des instructions sur la façon de modifier le type d’accord et les configurations requises, consultez l’article de la base de connaissances - KB1635160 sur ServiceNow - Now Support.

Pour plus d’informations sur les autorisations requises, consultez Microsoft Teams interne.

Remarque :

Certaines des actions de spoke nécessitent l’ID de canal, l’ID de groupe ou l’ID d’équipe comme l’une des entrées. Pour en savoir plus, connectez-vous à Microsoft Teams, naviguez vers Teams, puis cliquez sur Obtenir le lien vers le canal pour le canal requis. Le lien du canal contient les détails requis. Par exemple, si le lien de canal est https://teams.microsoft.com/l/channel/ 19%3a1aa3730712e245a0af31e4095d66d613%40thread.skype /New%2520channel%2520in%2520team ? groupId= 7fb91938-5e8c-4968-bf7d-3987df7716f3 &tenantId= a46df9b7-2c9b-49d5-8c9f-d1b3de4ba59f, l’ID du groupe et l’ID de l’équipe sont 7fb91938-5e8c-4968-bf7d-3987df7716f3, et l’ID du canal est19:1aa3730712e245a0af31e4095d66d613@thread.skype ou 1aa3730712e245a0af31e4095d66d613.

Pour plus d’informations sur l’accès à l’ID de canal et à l’ID de groupe via Microsoft Teams, voir Microsoft Teams interne.

Modules de spoke

Cela Microsoft Spoke Teams Graph ajoute le spoke Microsoft Teams Graph à votre instance ServiceNow et inclut ces modules.

Tableau 4. Modules de spoke Microsoft Teams Graph
Module	Description
Jeton delta	Affiche la liste des jetons delta disponibles.
Registre Webhook	Affiche la liste des registres de webhook disponibles.
Politique de décision Webhook	Affiche la liste des politiques de décision.
Abonnements webhook	Affiche les détails des abonnements à un webhook.

Microsoft Exigences de compte

L’nécessite Microsoft Spoke Teams Graph l’enregistrement d’une application à l’aide du portail Azure pour générer des Microsoft jetons OAuth 2.0.

Exigences en matière d'alias de connexion et d'informations d'identification

Hub d'intégration utilise des alias pour gérer les informations de connexion et d’identification, ainsi que les informations d’identification OAuth. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification et profils d'informations de connexion lors de l'utilisation d'environnements multiples. Si les informations de connexion ou d'identification changent, il n'est pas nécessaire de mettre à jour les actions qui utilisent la connexion.

Pour en savoir plus sur la configuration du spoke, consultez Configurez le Microsoft Spoke Teams Graph.

Configuration requise pour le Serveur MID

Les Microsoft Spoke Teams Graph actions utilisent des appels REST, qui peuvent s’exécuter sur une instance ou un Serveur MID. Utilisez l’enregistrement de connexion associé à l’alias pour configurer l’emplacement d’exécution Microsoft des actions et définir Serveur MID les attributs de sélection. Pour en savoir plus, consultez Serveur MID.