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 sont créées à Microsoft Spoke Teams Graph 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 ne peut être effectuée qu’à l’aide d’Entra Microsoft ID et non Microsoft Spoke Teams Graph.
Les équipes peuvent être créées à partir du Microsoft groupe Office 365 uniquement.
L’ID de l’équipe dans Microsoft Teams est le même que l’ID 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 La version4.1.1 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 Flow Designer (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 mises à jour des notes de travail d’incident ServiceNow sur la messagerie instantanée Microsoft Teams, pour illustrer 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

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. Les exemples de flux secondaires disponibles sont les suivants :

Tableau 1. Microsoft Teams Graph Flux secondaires des spokes
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 à l’abonnement webhook	Renouvelle un abonnement si un renouvellement est nécessaire, qui est décidé en fonction des entrées.
Renouveler les abonnements Webhook.	Récupère tous les abonnements à un webhook et les renouvelle si un 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

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

Vous pouvez effectuer certaines actions à l’aide de la connexion Microsoft Teams Spoke et les actions restantes à l’aide de la connexion Informations d’identification du 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 les autorisations déléguées.

Tableau 2. Microsoft Teams Graph actions de spoke qui utilisent l’alias de connexion et d’informations d’identification du spoke Microsoft Teams
Catégorie	Action	Description	Autorisations requises (des moins privilégiés aux plus privilégiés)
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 de disponibilité (libres ou occupées) 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
Gestion des canaux	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, Groupe.Lectureécriture.Tout, Répertoire.Lectureécriture.Tout
	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.Supprimer.Tout, Groupe.Lectureécriture.Tout, Répertoire.Lectureécriture.Tout
	Rechercher le canal	Récupère les propriétés et les relations d’un canal.	Délégué (compte professionnel ou scolaire)	Canal.LectureBasique.Tout, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All
	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.LectureBasique.Tout, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All
	Rechercher les membres du canal	Récupère une liste des membres du canal.	Délégué (compte professionnel ou scolaire)	MembreCanal.Lecture.Tous, MembreCanal.Lecture-écriture.Tout
	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.Tout
	Rechercher les canaux	Récupère la liste de canaux dans cette équipe.	Délégué (compte professionnel ou scolaire)	Canal.LectureBasique.Tout, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All
	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)	Messagerie instantanée.Créer, Messagerie instantanée.Lecture-écriture
	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.Tout
	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.Tout**
	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.Tout**
	Publier un message	Publie un message sur un canal Microsoft Teams.	Délégué (compte professionnel ou scolaire)	CanalMessage.Envoyer, Groupe.Lecture-écriture.Tout**
	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.Tout**
	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.Tout**
	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.Tout**
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)	MembreEquipe.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)	ParamètresEquipe.Lectureécriture.Tous, Groupe.Lectureécriture.Tout, Répertoire.LectureÉcriture.Tout
	Créer l'équipe	Créez une équipe à partir d’un groupe Office 365 existant. Remarque : L’ID de l’équipe est le même que celui du groupe.	Délégué (compte professionnel ou scolaire)	Groupe.Lecture-écriture.Tout, Répertoire.Lecture-écriture.Tout
	Supprimer l'équipe	Supprime l'équipe spécifiée.	Délégué (compte professionnel ou scolaire)	Groupe.Lectureécriture.Tout
	Rechercher une équipe	Récupère les propriétés et les relations d’une équipe.	Délégué (compte professionnel ou scolaire)	Equipe.LectureBasique.Tout, ÉquipeParamètres.Lecture.Tous, ÉquipeParamètres.Lectureécriture.Tout, Groupe.Lecture.Tout, Groupe.Lectureécriture.Tout, Répertoire.Lecture.Tout, Répertoire.LectureÉcriture.Tout
	Rechercher le flux des membres de l'équipe	Récupère une liste des membres du canal.	Délégué (compte professionnel ou scolaire)	TeamMember.Read.All, TeamMember.ReadWrite.All
	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.LectureBasique.Tout, ParamètresÉquipe.Lecture.Tous, ParamètresÉquipe.Lectureécriture.Tous, Utilisateur.Lecture.Tous, Utilisateur.Lectureécriture.Tout, Répertoire.Lecture.Tout, Répertoire.Lecture-écriture.Tout
	Supprimer un membre de l'équipe	Supprime le membre spécifié de l'équipe spécifiée.	Délégué (compte professionnel ou scolaire)	MembreEquipe.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)	ParamètresEquipe.Lectureécriture.Tous, Groupe.Lectureécriture.Tout, Répertoire.LectureÉcriture.Tout
	Mettre à jour l'équipe	Met à jour les propriétés d’une équipe spécifique.	Délégué (compte professionnel ou scolaire)	ParamètresEquipe.Lectureécriture.Tous, Groupe.Lectureécriture.Tout, Répertoire.LectureÉcriture.Tout

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

Tableau 3. Microsoft Teams Graph actions de spoke qui utilisent l’alias de connexion et d’informations d’identification du client Microsoft Teams Graph
Catégorie	Action	Description	Autorisations requises (des moins privilégiés aux plus privilégiés)
Gestion des calendriers	Créer une réunion	Crée un événement de réunion en ligne dans le calendrier MS Teams.	Application	Calendars.ReadWrite
	Supprimer la réunion	Supprime l'événement de réunion du calendrier MS Teams.	Application	Calendars.ReadWrite
	Rechercher une réunion	Récupère les détails de l'événement de réunion à partir du calendrier MS Teams.	Application	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.	Application	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.	Application	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.	Application	Calendars.ReadWrite
Gestion des Webhook	Rechercher un abonnement de webhooks	Récupère les détails de l'abonnement à un webhook requis.	Application	CanalMessage.Lecture.Tous, Messagerie instantanée.Lecture.Tout
	Rechercher un flux d'abonnements de webhooks	Récupère les détails de tous les abonnements à un webhook.	Application	CanalMessage.Lecture.Tous, Messagerie instantanée.Lecture.Tout
	Renouveler l'abonnement Webhook.	Renouvelle l'abonnement de webhook spécifié.	Application	CanalMessage.Lecture.Tous, Messagerie instantanée.Lecture.Tout
	S'abonner au webhook	Crée un abonnement à un webhook pour la ressource spécifiée.	Application	CanalMessage.Lecture.Tous, Messagerie instantanée.Lecture.Tout
	Se désabonner du webhook	Supprime l'abonnement de webhook spécifié.	Application	CanalMessage.Lecture.Tous, Messagerie instantanée.Lecture.Tout

Important :

Assurez-vous d’être au courant de ces configurations de spoke par défaut.

Par défaut, le type d’accord 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 du calendrier 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 en spoke Gestion du calendrier et du Webhook (à l’exception de l’action Rechercher des calendriers dans la gestion du calendrier) utilisent l’alias de connexion et d’informations d’identification des informations d’identification du client Microsoft Teams Graph et ces actions nécessitent des autorisations d’application.

Si vous souhaitez utiliser Microsoft Teams Graph Spoke sans interaction de l’utilisateur, vous devez modifier 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’attribution 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, voir Microsoft Teams interne.

Remarque :

Certaines 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 connaître ces détails, 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 du 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, consultez Microsoft Teams interne.

Modules de spokes

Le Microsoft Spoke Teams Graph ajoute le spoke Microsoft Teams Graph à votre instance ServiceNow et inclut les modules suivants.

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

Microsoft Exigences de compte

L’nécessite Microsoft Spoke Teams Graph l’enregistrement d’une application à l’aide du Microsoft portail Azure pour générer des 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 Configurer 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 Microsoft d’exécution des actions et définir Serveur MID les attributs de sélection. Pour en savoir plus, consultez Serveur MID.