Intégration de Microsoft Teams
Intégration de Microsoft Teams avec le connecteur Microsoft Graph API
Intégration de Microsoft Teams
Intégration de Microsoft Teams avec le connecteur Microsoft Graph API
Les fonctionnalités d’intégration de Microsoft Teams sont incluses dans le connecteur Microsoft Graph API (anciennement connu sous le nom de connecteur Entra ID ).
Grâce au connecteur Microsoft Graph API , vous pouvez désormais lire les données de Microsoft Teams. Depuis la version 2025.2, vous pouvez également effectuer des actions sur Microsoft Teams et apporter des modifications à l'environnement Teams. Ensemble, ces fonctionnalités offrent une valeur ajoutée concrète dans quatre domaines clés :
Visibilité et contrôle améliorés : accès en temps quasi réel aux données liées à Microsoft Teams, telles que les utilisateurs, les canaux et les appartenances aux équipes.
Automatisation et efficacité : les actions automatisées réduisent l’effort manuel, accélèrent les temps de réponse et rationalisent les processus.
Intégration stratégique et innovation : l’intégration transparente avec d’autres systèmes informatiques permet une automatisation avancée, une gouvernance améliorée et prend en charge des initiatives de transformation numérique plus larges.
L'intégration de Microsoft Teams peut être réalisée avec Microsoft Graph API Connector .
Pour les instructions client, voir https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
Documentation Microsoft Graph API relative à l'intégration de Teams : https://learn.microsoft.com/en-us/graph/api/resources/teams-api-overview?view=graph-rest-1.0
Voici des exemples de cas d'utilisation avec Teams :
- Envoi de messages de notification aux équipes
- Lecture des informations sur les équipes et les canaux vers ITSM
- Gestion des membres de l'équipe
- Gestion du cycle de vie de l'équipe
- Validation de la propriété de l'équipe
- Intégration avec les processus du cycle de vie des utilisateurs
- Création d'équipe pilotée par les événements
Lire les équipes Microsoft Teams
Autorisations d'application Azure
Pour l'importation d'équipes, l'application dans Azure a besoin de ces autorisations
Pour les instructions client, voir https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
| Type d'autorisation | Autorisations |
| Application |
Groupe.Lire.Tout, Équipe.Lire.Basic.Tout et (Channel.ReadBasic.All ou Channel.Read.All) |
Requêtes pour les tâches planifiées
Requête : groupes ? $ filter = resource Pro visioningOptions/Any(x : x eq 'Team')
Sous-requêtes :
équipes/{id}/canaux
équipes/{id}/membres
Mappages pour les tâches planifiées
Utilisez toujours un modèle générique pour les mappages d'équipes Type :
| Attribut externe | Attribut local | Plus d'infos |
|---|---|---|
| identifiant | identifiant_équipe | Identifiant unique de l'équipe |
| nom d'affichage | nom_d'affichage_de_l'équipe | |
| description | description_de_l'équipe | |
| visibilité | visibilité_de_l'équipe | Équipe publique ou privée |
| équipes/{id}/channels.id | identifiant_de_canal |
Liste des identifiants des canaux d'équipe Cet attribut doit être multivaleur |
| équipes/{id}/members.userId | membres_de_l'équipe |
Liste des identifiants des membres de l'équipe Cet attribut doit être multivaleur |
Sujet ouvert : serait-il préférable de récupérer également les détails du canal (nom d'affichage, description, etc.) dans un autre attribut à valeurs multiples dans cette tâche planifiée, ou de récupérer ces canal par canal à partir du nœud d'orchestration du workflow.
Tâches basées sur les événements (actions pour) les équipes et les canaux Microsoft
Autorisations d'application Azure
Pour les actions Teams, l'application Azure nécessite des autorisations. Pour définir les autorisations appropriées, consultez : https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id et https://learn.microsoft.com/en-us/graph/permissions-reference
Tâche basée sur les événements
L'URL de la tâche basée sur les événements peut être vide. L'URL finale à appeler est créée en combinant l'URL du connecteur et celle du nœud de workflow.
Mappages pour les tâches basées sur les événements
En-tête pour la tâche basée sur les événements
Il n’est pas nécessaire de définir des en-têtes supplémentaires, la gestion des connecteurs le définit automatiquement :
| Type de contenu | application/json |
Nœud de flux de travail
Dans le nœud Orchestration du workflow, sélectionnez Orchestration, Source de données et Activité :
Sélectionnez la tâche événementielle créée pour cette action. Vous pouvez également utiliser une tâche événementielle pour plusieurs actions.
La plupart de ces actions utilisent la méthode HTTP POST. N'oubliez pas de définir la méthode appropriée pour le nœud d'orchestration du workflow pour ces actions.
Envoyer un commentaire/une notification texte au canal d'équipe
Action : POST
URL : teams/{team-id}/channels/{channel-id}/messages
Exemple de corps :
Documentation Microsoft pour API
Obtenir des informations sur la chaîne
Action : GET
URL : teams/{team-id}/channels/{channel-id}
Corps : (aucun)
Dans Workflow, analysez le jeu de résultats JSON à partir de l'attribut « Attribut de réponse REST » pour créer une carte de données de référence du canal.
Exemple de jeu de résultats json renvoyé lorsque l'équipe {team-id} contient 2 canaux :
Créer une équipe
Action : POST
URL : teams
Exemple de corps :
Documentation Microsoft pour API
Mettre à jour une équipe
Action : PATCH
URL : teams/{team-id}
Exemple de corps :
Documentation Microsoft pour API
Archiver une équipe
Action : POST
URL : équipes/{id}/archive
Exemple de corps : {"shouldSetSpoSiteReadOnlyForMembers": true}
Documentation Microsoft pour API
Ajouter un ou plusieurs membres à une équipe
Action : POST
URL : /teams/{team-id}/members
Exemple de corps :
Documentation Microsoft pour API
Supprimer un membre d'une équipe
Action : DELETE
URL : /teams/{team-id}/members/{membership-id}
Corps : (aucun)
https://learn.microsoft.com/en-us/graph/api/team-delete-members?view=graph-rest-1.0&tabs=http
Autorisations d'application Microsoft pour les équipes et les canaux
Ajoutez les autorisations appropriées en fonction des besoins de votre cas d’utilisation.
Type de portée utilisateur Application :
| Opération | Autorisation | Notes |
|---|---|---|
| Découvrir les équipes | Équipe.ReadBasic.All | Énumérer toutes les équipes du locataire. |
| Gérer les paramètres de l'équipe | Paramètres d'équipe.Lecture/écriture.Tous | Lire/mettre à jour les paramètres de l’équipe ; non pris en charge pour les comptes Microsoft personnels. |
| Créer des chaînes (n'importe quelle équipe) | Canal.Créer | Créez des canaux standard/privés dans n'importe quelle équipe. |
| Lire les chaînes (métadonnées) | Canal.ReadBasic.All | Lisez les listes de chaînes et les informations de base sur l'ensemble des locataires. |
| Lire les paramètres de la chaîne | ChannelSettings.Lire.Tout | Lire toutes les propriétés/paramètres du canal. |
| Modifier les paramètres de la chaîne | ChannelSettings.ReadWrite.All | Modifier le nom du canal, la description, les paramètres de modération. |
| Gérer les membres de l'équipe | Membre de l'équipe.Lecture/Écriture.Tous | Ajoutez/supprimez des membres et modifiez les rôles (l'ajout d'invités n'est pas pris en charge). |
| Lire l'adhésion à la chaîne | ChannelMember.Read.All | Lire l'adhésion à tous les canaux standards/privés/partagés. |
| Gérer l'adhésion aux chaînes | ChannelMember.ReadWrite.All | Ajouter/supprimer/mettre à jour des membres dans des canaux privés/partagés. |
| Lire les messages de la chaîne | ChannelMessage.Lire.Tout | Lire tous les messages du canal à l'échelle du locataire (conformité/audit). |
Restrictions connues
Restrictions dans les versions 2025.2 et antérieures
Plusieurs niveaux de sous-requêtes ne sont pas pris en charge, pour des raisons de performances.
Plus d'une sous-requête n'est pas prise en charge.
Le connecteur ne prend pas encore en charge le marquage des objets Teams/channel supprimés dans Matrix42 Core , Pro , IGA lorsque l'objet est supprimé de Microsoft Teams.