Comment mettre à jour une étiquette dans Teams avec HTTP PATCH

  • Last update on June 5th, 2025

Workflows ne sont pas disponibles dans la Essentials solution.

 

Dans ce guide, nous allons parcourir les étapes pour mettre à jour une étiquette d’équipe dans Microsoft Teams à l’aide de l’action HTTP PATCH.

Prérequis

  • Génération d’un jeton applicatif : vous avez besoin d’un jeton d’application avec les autorisations nécessaires pour modifier une étiquette d’équipe. Ce jeton est utilisé pour authentifier les requêtes auprès de Microsoft Graph API.
  • ID de l’équipe et ID de l’étiquette : récupérez l’identifiant du groupe Teams et de l’étiquette que vous souhaitez modifier. Ces informations sont accessibles via le Centre d’administration Teams ou par des requêtes Graph API. 

Pour plus d’informations sur les autorisations et la génération du jeton, consultez la documentation Microsoft Graph sur les autorisations.

Entrées d’exécution

Préparez les informations suivantes, qui seront requises par l’opérateur pour exécuter le flux de travail :

  • ID de l’équipe : identifiant unique de l’équipe.
  • ID de l’étiquette : identifiant unique de l’étiquette au sein de l’équipe.
  • Nouveau nom de l’étiquette : le nouveau nom souhaité pour l’étiquette.

Modification d’une étiquette d’équipe

Étape 1 : Configurer l’action

Ajoutez une nouvelle action à votre flux de travail. Rendez-vous dans la catégorie « HTTP Integrations » et sélectionnez l’action « HTTP API PATCH ».

Étape 2 : Configurer l’URL

Définissez l’URL pour cibler précisément l’étiquette d’équipe à mettre à jour. Utilisez le format suivant :

 https://graph.microsoft.com/beta/teams/{team-Id}/tags/{teamworkTag-Id}.

Remplacez {team-Id} et {teamworkTag-Id} par l’ID de l’équipe et l’ID de l’étiquette que vous avez préparés.

Étape 3 : Ajouter la clé secrète

Saisissez la clé secrète nécessaire à l’autorisation auprès de Microsoft Graph API. Pour plus d’informations sur la clé secrète, consultez cet article sur l’envoi d’une requête POST.

Étape 4 : Configurer le corps de la requête

Indiquez les modifications à apporter à l’étiquette dans le corps de la requête. Par exemple, pour changer le nom de l’étiquette, renseignez cette section en conséquence.

Étape 5 : S’assurer du code d’état de succès

Activez la fonction « S’assurer du code d’état de succès » pour garantir que l’action échouera si le code d’état de réponse indique une erreur, ce qui facilite le dépannage.

Exécution du flux de travail

Après avoir configuré l’action, enregistrez et publiez votre flux de travail. Lors de l’exécution, il vous sera demandé de saisir les entrées d’exécution définies précédemment.

Après une exécution réussie, l’étiquette d’équipe ciblée sera mise à jour comme spécifié. Vous pouvez vérifier la modification dans Microsoft Teams ou en interrogeant l’étiquette via Graph API.