Notifications Teams avec les Adaptive Cards dans Power Automate

Lorsqu'un flux est déclenché dans Power Automate, un simple message texte dans Teams ne suffit souvent pas. Une étape d'approbation, un vote d'équipe ou un retour sur une commande nécessitent plus qu'une simple information, ils nécessitent un moyen de réagir directement dans le chat. C'est exactement à cela que servent les Adaptive Cards : des cartes interactives que Power Automate publie directement dans un chat ou un canal via le connecteur Microsoft Teams, et dont le flux attend ensuite la réponse.

Cet article présente les actions que le connecteur Teams propose pour les Adaptive Cards, la manière de créer une première carte interactive et les limitations à prendre en compte lors de la conception selon la documentation officielle de Microsoft. Tu gardes ainsi le contrôle dès le départ sur la façon dont ta collaboratrice numérique communique avec ton équipe, au lieu de devoir chercher dans la documentation après la première erreur.

Ce qui distingue les Adaptive Cards d'un simple message Teams

Selon la documentation Microsoft sur les cartes adaptatives pour Teams les Adaptive Cards sont une méthode indépendante de la plateforme pour partager et afficher des blocs d'informations, sans avoir à adapter de CSS ou de HTML. Tu décris la carte au format JSON, et Teams convertit automatiquement cette description en une interface native adaptée à l'hôte concerné lors de l'affichage.

La différence décisive par rapport à un message de chat normal réside dans l'interactivité : une Adaptive Card peut contenir des champs de texte, des listes de choix et des boutons permettant aux destinataires de répondre directement dans le chat. Power Automate récupère cette réponse et poursuit le flux avec les données saisies, sans formulaire séparé ni application supplémentaire.

Les actions du connecteur Microsoft Teams en un coup d'œil

Selon la documentation, le connecteur Teams distingue les cartes destinées à des personnes individuelles des cartes destinées à des canaux entiers, et dans chaque cas entre une variante avec et sans fonction d'attente :

• Publier sa propre carte adaptative en tant que bot de flux auprès d'un utilisateur : la carte apparaît dans le chat et dans les activités du destinataire, sans que celui-ci doive être membre d'une instance Teams particulière. Seuls les boutons URL fonctionnent ici, ils redirigent simplement vers une adresse configurée dans le flux.
• Publier une carte adaptative en tant que bot de flux auprès d'un utilisateur Teams et attendre une réponse : le flux se met en pause jusqu'à ce que la personne ait réagi à la carte, puis renvoie exactement une réponse par destinataire et par carte sous forme de contenu dynamique.
• Publier sa propre carte adaptative en tant que bot de flux dans un canal : comme ci-dessus, sauf que la carte apparaît dans un canal d'équipe auquel tu dois toi-même avoir accès.
• Publier une carte adaptative en tant que bot de flux dans un canal Teams et attendre une réponse : le flux attend qu'un membre du canal réponde, puis traite sa saisie.

Pour les messages proactifs émis par un agent Copilot Studio, selon la documentation sur les messages Teams proactifs les actions Post adaptive card in a chat or channel et Post adaptive card and wait for a response sont également disponibles. Tu sélectionnes ici Microsoft Copilot Studio agent comme Post as et indiques le destinataire ainsi que l'agent souhaité.

Créer ta première Adaptive Card interactive

Avant de commencer, l'application Workflows doit, selon la documentation, être installée dans Microsoft Teams, sinon l'exécution du flux échoue avec un message d'erreur explicite. Voici comment créer la première carte :

1. Connecte-toi à Power Automate et crée un flux cloud instantané avec le déclencheur Déclencher un flux manuellement.

2. Ajoute comme nouvelle étape l'action Publier une carte adaptative dans un canal Teams et attendre une réponse et sélectionne l'équipe ainsi que le canal.

3. Colle le code JSON de ta carte dans le champ Message. Pour commencer, une structure avec un titre, un texte, un Input.ChoiceSet pour les options de choix et un bouton Action.Submit à la fin suffit.

4. Saisis dans le champ Message de mise à jour le texte que la carte doit afficher après la réponse. Sans cette indication, la carte se réinitialise simplement après chaque envoi, ce qui, selon la documentation, incite à des envois multiples inutiles.

5. Traite ensuite la réponse dans une étape suivante, par exemple via un e-mail contenant la valeur sélectionnée issue du contenu dynamique de l'action d'attente de réponse.

Lorsque tu exécutes le flux, le repère d'attente dans le journal d'exécution te montre que Power Automate attend effectivement la réponse. Ce n'est qu'après l'envoi par le destinataire que le flux se poursuit avec les valeurs saisies, comme décrit en détail dans le guide de création de la première carte adaptative.

Traiter la réponse dans le flux

Au sein d'une Adaptive Card avec wait-for-a-response, chaque élément de saisie renvoie sa valeur via l'ID défini dans le JSON, par exemple `acPollChoices` pour une liste de choix dans l'exemple de la documentation. Tu retrouves cet ID à l'étape suivante sous forme de contenu dynamique et peux l'utiliser directement dans des e-mails, des entrées de liste ou d'autres conditions.

Si tu utilises à la place une carte proactive via un agent Copilot Studio, la réponse renvoie, selon la documentation, la variable `submitActionId`, dont la valeur correspond au titre de l'action sélectionnée. Pour les deux variantes : des détails supplémentaires comme l'ID utilisateur de la personne ayant répondu ne sont disponibles comme contenu dynamique qu'après l'action d'attente de réponse ; pour des données de profil complètes, tu as en plus besoin du connecteur Utilisateurs Office 365.

Limitations connues à connaître

La documentation liste plusieurs points qui prêtent souvent à confusion dans la pratique :

• Sans action d'attente de réponse, aucune donnée ne peut être collectée à partir d'une carte, chaque bouton autre qu'Action.OpenUrl renvoie alors une erreur.
• Chaque carte avec wait-for-a-response ne peut être envoyée qu'une seule fois, tous les envois suivants sont ignorés silencieusement.
• Après l'envoi, la carte affiche exclusivement le texte du champ Message de mise à jour, sinon elle reste inchangée et incite à un nouvel envoi inutile.
• Les Adaptive Cards utilisant la fonction de templating de la spécification générale Adaptive Cards ne sont pas prises en charge par Power Automate.
• Dans l'environnement du Département de la Défense américain, les cartes adaptatives ne sont généralement pas disponibles, mais cela ne concerne qu'un cercle d'utilisateurs très spécifique.

Sources d'erreurs typiques avec les cartes adaptatives

Outre les limitations structurelles, Microsoft cite dans ses propres conseils de dépannage trois schémas d'erreur récurrents :

• Application Workflows manquante : si l'application Workflows n'est pas installée dans Teams, l'exécution du flux échoue. L'application doit être configurée dans l'instance Teams concernée avant le premier test.
• Code JSON mal formaté : le plus souvent, ce sont des guillemets courbes au lieu de guillemets droits, ou des guillemets manquants autour des valeurs de texte, qui en sont la cause. Un test dans le concepteur Adaptive Cards révèle de manière fiable ce type d'erreurs avant que tu n'insères la carte dans Power Automate.
• URL d'image invalides : les Adaptive Cards ne prennent pas en charge les fichiers image intégrés, chaque image doit être intégrée via une URL accessible publiquement. En cas de doute, vérifie l'URL directement dans le navigateur avant de l'inscrire dans la carte.

Quiconque passe en revue ces trois points avant la mise en production s'épargne la plupart des messages d'erreur qui n'apparaissent en pratique qu'après la première exécution productive. Celles et ceux qui utilisent Power Automate comme collaboratrice numérique et attachent de l'importance à des notifications Teams bien construites et peu contraignantes à entretenir trouveront auprès du conseil Power Automate de NordFlux un soutien pour la création des Adaptive Cards et la gestion des erreurs associée.

Questions fréquentes

Puis-je utiliser une Adaptive Card sans action d'attente de réponse pour les saisies ?

Non. Selon la documentation, les cartes sans cette action renvoient une erreur pour tous les boutons sauf Action.OpenUrl ; les données des champs de saisie ne peuvent donc être collectées qu'avec l'une des deux variantes d'attente de réponse.

Combien de fois peut-on répondre à une même Adaptive Card ?

Une seule fois. Après le premier envoi, le flux se poursuit ; chaque envoi supplémentaire de la même carte est ignoré selon la documentation, sans qu'une nouvelle réponse ne soit renvoyée.

Pourquoi ma carte a-t-elle toujours exactement le même aspect après la réponse ?

Parce que le champ Message de mise à jour n'a pas été rempli. Sans cette indication, la carte se réinitialise simplement après chaque envoi, ce qui incite facilement les destinataires à un second envoi inutile.

Les Adaptive Cards fonctionnent-elles avec les fonctions de templating dans Power Automate ?

Non, la documentation indique explicitement que la fonction de templating de la spécification générale Adaptive Cards n'est pas prise en charge par Power Automate. Construis plutôt la carte avec un JSON entièrement rempli, sans modèles à espaces réservés.

Dois-je écrire le code JSON à la main pour concevoir une carte ?

Pas nécessairement. Le concepteur Adaptive Cards propose une interface visuelle de glisser-déposer à partir de laquelle tu copies le code JSON final directement dans le champ de message de l'action Power Automate.