Microsoft Teams Graph Un spoke
Le Microsoft Spoke Teams Graph gère les applications, le calendrier, les équipes, les canaux, les conversations instantanées, les notifications et les webhooks dans Microsoft Teams. Pour créer, gérer ou supprimer des utilisateurs et des groupes, utilisez le Microsoft Entra spoke ID (anciennement Microsoft spoke Azure Active Directory).
Demander des applications dans l'App Store
Visitez le ServiceNow Store pour afficher toutes les applications disponibles et pour obtenir des informations sur la soumission de demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les ServiceNow Store notes de publication relatives à l'historique des versions.
- 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 d’Entra ID uniquement et non Microsoft Spoke Teams Graphà l’aide Microsoft de .
- 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 à Centre 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.4.1 est la dernière version.
Version prise en charge
Microsoft API REST Graph v1.0.
Dépendances des spokes
- ServiceNow Centre d'intégration Exécution (com.glide.hub.integration.runtime)
- Modèle de Concepteur de flux (com.glide.hub.designer_backend.model)
- Objet complexe (com.glide.cobject)
- ServiceNow Centre d'intégration Étape d’action : REST (com.glide.hub.action_step.rest)
- ServiceNow Centre 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)
Flux de spoke
fournit Microsoft Spoke Teams Graph un exemple de flux, Notes de travail post-incident ServiceNow mises à jour dans 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
| 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 un renouvellement est requis, décidé en fonction des entrées. |
| Renouveler les abonnements Webhook. | Récupère tous les abonnements de 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
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 Microsoft Teams Spoke et les actions restantes à l’aide de la connexion aux 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 Microsoft Teams Spoke. Ces actions nécessitent les autorisations déléguées.
| 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 |
| 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 |
| 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.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.Supprimer.Tous, 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) | Channel.ReadBasic.All, 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) | Channel.ReadBasic.All, 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.Lire.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.Lire.Tout | |
| Rechercher les canaux | Récupère la liste de canaux dans cette équipe. | Délégué (compte professionnel ou scolaire) | Channel.ReadBasic.All, 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) | 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 instantanées | 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.Lire.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) | MessageCanal.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) | MessageCanal.Envoyer, Groupe.Lecture-écriture.Tous | |
| Publier un message | Publie un message sur un canal Microsoft Teams. | Délégué (compte professionnel ou scolaire) | MessageCanal.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) | MessageCanal.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) | MessageCanal.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) | MessageCanal.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.LectureBasique.Tout, Paramètresd’équipe.Lecture.Tout, Paramètresd’équipe.Lecture.Tout, Groupe.Lecture.Tout, Groupe.Lecture.Tout, Répertoire.Lecture.Tout, Répertoire.Lecture.Tous | |
| Rechercher le flux des membres de l’équipe | Récupère une liste des membres de l’équipe. | 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) | Team.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 du client Microsoft Teams Graph. Ces actions nécessitent les autorisations de l’application.
| 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. | 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 | Calendriers.Lire | |
| Rechercher les occurrences de réunion | Récupère l’ID de réunion enfant de récurrence à partir du calendrier MS Teams. | Application | Calendriers.Lire | |
| 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.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. | Application | CanalMessage.Lecture.Tout, Messagerie instantanée.Lecture.Tout | |
| Renouveler l’abonnement Webhook. | Renouvelle l’abonnement de webhook spécifié. | Application | CanalMessage.Lecture.Tout, Messagerie instantanée.Lecture.Tout | |
| S'abonner au webhook | Crée un abonnement à un webhook pour la ressource spécifiée. | Application | CanalMessage.Lecture.Tout, Messagerie instantanée.Lecture.Tout | |
| Se désabonner du webhook | Supprime l’abonnement de webhook spécifié. | Application | CanalMessage.Lecture.Tout, Messagerie instantanée.Lecture.Tout | |
- 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’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, consultez Microsoft Teams documentation.
Pour plus d’informations sur l’accès à l’ID de canal et à l’ID de groupe via , reportez-vous à Microsoft Teams la section Microsoft Teams documentation.
Agents IA disponibles
Installez Now AssistCentre d'intégration et commencez à utiliser les agents IA disponibles. Pour plus d'informations, consultez Now Assist pour Centre d'intégration.
- Dans le ServiceNow système agentique, vous pouvez créer un workflow agentique qui comprend un ensemble d’instructions de grand modèle de langage (LLM) ainsi qu’un ou plusieurs agents IA autonomes pour exécuter un objectif. Consultez pour plus d’informations sur l’ajout d’agents IA pour créer des workflows agentiques selon vos besoins et fournir le déclencheur requis.
Vous pouvez également rechercher d’autres agents IA disponibles et les ajouter à votre workflow agentique. Consultez Find AI agents pour plus d'informations.
- Vous pouvez créer un clone de l’agent IA de spoke requis et le personnaliser selon vos besoins. Consultez pour plus d’informations sur la création d’un clone.
- Consultez la rubrique pour plus d’informations sur les agents IA.
| Agent IA | Description |
|---|---|
| Microsoft Teams Agent IA de gestion des applications | Automatise les tâches liées à Microsoft Teams et Centre d'intégration. Effectue des actions telles que la recherche d’installations d’applications et l’installation d’applications pour les utilisateurs. |
| Microsoft Teams Agent IA de gestion des canaux | Gère les Microsoft Teams canaux via Centre d’intégration. Il fournit des options telles que la création de canaux, la gestion des membres et la récupération des informations sur les canaux. |
| Microsoft Teams gestion de la messagerie instantanée Agent IA | Automatise les workflows entre ServiceNow et Microsoft Teams en fournissant des options telles que la recherche de messageries instantanées et de messages. |
| Microsoft Teams gestion des notifications Agent IA | Automatise la communication entre ServiceNow et Microsoft Teams en envoyant des messages, des mises à jour et des réponses aux Microsoft Teams canaux. L’agent prend en charge des actions telles que « Publier les détails du changement », « Publier un message » et « Publier la réponse au message » pour assurer une gestion efficace des notifications pour les demandes de changement. |
| Microsoft Teams gestion des équipes Agent IA | Automatise des tâches telles que la création et la gestion d’équipes, l’ajout ou la suppression de membres et la récupération des informations relatives à l’équipe. Améliore les workflows de gestion d’équipe et de communication au sein d’une organisation. |
| Microsoft Teams gestion des calendriers Agent IA | Automatise les workflows entre ServiceNow et Microsoft Teams. Fournit des options de gestion des calendriers. Effectue des actions telles que la suppression et la récupération des détails de la réunion. |
Il peut y avoir des agents IA installés avec l’application qui ne sont pas utilisés dans les Now Assist workflows agentiques. Pour savoir comment afficher tous les agents à votre disposition, consultez Trouver des agents IA.
Modules de spoke
| 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 à un webhook. |
Microsoft Exigences de compte
Pour générer Microsoft Spoke Teams Graph des jetons OAuth, il est nécessaire d’enregistrer une application à l’aide du Microsoft portail Azure pour générer des jetons OAuth.
Exigences en matière d'alias de connexion et d'informations d'identification
Centre 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.
Pour configurer le Serveur MID pour ce spoke, reportez-vous à la section Configurer Serveur MID pour un spoke.