Microsoft Teams Graph 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 spoke Microsoft Entra ID (anciennement spoke Microsoft Azure Active Directory).
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.
- Les équipes de l’application Microsoft Spoke Teams Graph sont créées à partir des groupes d’Entra Microsoft ID (anciennement Microsoft Azure Active Directory). Pour créer une équipe à l’aide de , Microsoft Spoke Teams Graphle groupe associé doit être présent dans Microsoft Entra ID.
- La gestion des utilisateurs et des groupes peut être effectuée uniquement à l’aide de Microsoft Entra 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.0.0 est la dernière version.
Version prise en charge
Microsoft API REST Graph v1.0.
Dépendances des spokes
- ServiceNow Hub d'intégration Runtime (com.glide.hub.integration.runtime)
- Modèle de 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 du Centre d’intégration ServiceNow : obtenir des informations de connexion (com.glide.hub.action_step.get_connection_info)
Flux de spokes
La Microsoft Spoke Teams Graph fournit un exemple de flux, Publier les notes de travail d’incident ServiceNow mises à jour vers 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 nécessaire, ce 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
La 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.
| Catégorie | Action | Description | Autorisations requises (du moins privilégié 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 de disponibilité (libre ou occupé) pour 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.Tout |
| 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.Suppression.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) | 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) | ChannelMember.Read.All, ChannelMember.ReadWrite.All | |
| 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) | 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.Tout | |
| 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.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 | |
| 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) | ChannelMessage.Send, Group.ReadWrite.All** |
| Détails post-incident | Publie les détails de l'incident requis sur un canal Microsoft Teams. | Délégué (compte professionnel ou scolaire) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Publier un message | Publie un message sur un canal Microsoft Teams. | Délégué (compte professionnel ou scolaire) | ChannelMessage.Send, Group.ReadWrite.All** | |
| 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) | ChannelMessage.Send, Group.ReadWrite.All** | |
| Publier la réponse au message | Publie une réponse au message spécifié. | Délégué (compte professionnel ou scolaire) | ChannelMessage.Send, Group.ReadWrite.All** | |
| 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) | TeamMember.ReadWrite.All |
| É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**, Répertoire.LectureÉcriture.Tous** | |
| 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) | Group.ReadWrite.All, 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) | Team.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) | 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) | Equipe.ReadBasic.Tout, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Répertoire.Lecture.Tous**, 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) | TeamMember.ReadWrite.All | |
| 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**, Répertoire.LectureÉcriture.Tous** | |
| 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**, Répertoire.LectureÉcriture.Tous** | |
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 des autorisations d’application.
| Catégorie | Action | Description | Autorisations requises (du moins privilégié 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 | 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 | ChannelMessage.Read.All, Chat.Read.All |
| Rechercher un flux d'abonnements de webhooks | Récupère les détails de tous les abonnements à un webhook. | Application | ChannelMessage.Read.All, Chat.Read.All | |
| Renouveler l'abonnement Webhook. | Renouvelle l'abonnement de webhook spécifié. | Application | ChannelMessage.Read.All, Chat.Read.All | |
| S'abonner au webhook | Crée un abonnement à un webhook pour la ressource spécifiée. | Application | ChannelMessage.Read.All, Chat.Read.All | |
| Se désabonner du webhook | Supprime l'abonnement de webhook spécifié. | Application | ChannelMessage.Read.All, Chat.Read.All | |
- 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, et 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 Spoke Gestion du calendrier et des webhook (à l’exception de l’action Rechercher des calendriers dans Gestion du calendrier) utilisent l’alias de connexion et d’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 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 manière 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 interne.
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
| 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 webhook. |
Microsoft Exigences de compte
L’opération Microsoft Spoke Teams Graph nécessite l’inscription 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’informations 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 ainsi que pour définir Serveur MID des attributs de sélection. Pour en savoir plus, consultez Serveur MID.