Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les extensions de message permettent aux utilisateurs d’interagir avec votre service web via des boutons et des formulaires dans le client Microsoft Teams. Les utilisateurs effectuer des recherches ou lancer des actions, dans un système externe à partir de la zone de rédaction de message, de la zone de commande ou directement d’un message. Vous pouvez renvoyer les résultats de ces interactions au client Teams sous la forme d’une carte enrichie.
Importante
Les extensions de message sont disponibles dans Government Community Cloud (GCC), GCC High, Department of Defense (DoD) et Teams gérés par les environnements 21Vianet .
Cet article fournit une vue d’ensemble des extensions de message, des cas d’usage, des fonctionnalités, des commandes d’action et de recherche, ainsi que du déploiement de liens.
L’image suivante présente les emplacements à partir desquels les utilisateurs peuvent appeler des extensions de message :
Remarque
- Vous ne pouvez pas @mention envoyer de message aux extensions dans la zone de rédaction.
- Teams ne prend pas en charge les options d’extension de message pour les conversations de groupe avec des utilisateurs externes.
Scénarios dans lesquels les extensions de message sont utilisées
| Scénario | Exemple |
|---|---|
| Vous avez besoin d’un système externe pour effectuer une action et renvoyer le résultat à votre conversation. | Réservez une ressource et autorisez le canal à connaître l’intervalle de temps réservé. |
| Vous devez rechercher un élément dans un système externe et partager les résultats avec la conversation. | Recherchez un élément de travail dans Azure DevOps et partagez-le avec le groupe en tant que carte adaptative. |
| Vous souhaitez terminer une tâche complexe impliquant plusieurs étapes ou de grandes quantités d’informations dans un système externe et partager les résultats dans une conversation. | Créez un bogue dans votre système de suivi sur la base d’un message Teams, attribuez ce bogue et envoyez une carte au thread de conversation avec les détails du bogue. |
Comprendre le fonctionnement des extensions de message
Une extension de message est composée d’un service web que vous hébergez et d’un manifeste d’application qui définit l’emplacement où votre service web est appelé dans le client Teams. Le service web utilise le schéma de messagerie et le protocole de communication sécurisé de Bot Framework. Vous devez donc inscrire votre service web en tant que bot dans Bot Framework.
Remarque
Bien que vous puissiez créer le service web manuellement, utilisez le SDK Bot Framework pour utiliser le protocole.
Dans le manifeste de l’application (anciennement appelé manifeste de l’application Teams), vous définissez une extension de message unique avec jusqu’à 10 commandes différentes. Chaque commande définit un type, tel qu’une action ou une recherche, ainsi que les emplacements dans le client où l’extension de message est invoquée. Les emplacements d’appel comprennent la zone de rédaction du message, la barre de commandes et le message. Lorsque vous appelez l’extension de message, le service web reçoit un message HTTPS avec une charge utile JSON qui contient toutes les informations pertinentes. Répondez avec une charge utile JSON pour informer le client Teams de la prochaine interaction à activer.
Types de commandes d’extension de message
Il existe deux types de commandes d’extension de message : les commandes d’action et les commandes de recherche. Le type de commande d’extension de message définit les éléments d’interface utilisateur et les flux d’interaction disponibles pour votre service web. Les deux types de commandes fournissent des interactions pour l’authentification et la configuration.
Commandes d’action
Utilisez les commandes d’action pour présenter aux utilisateurs une fenêtre contextuelle modale afin de collecter ou d’afficher des informations. Lorsque l’utilisateur envoie le formulaire, votre service web répond en insérant un message directement dans la conversation ou dans la zone de rédaction du message. Plus tard, l’utilisateur peut envoyer le message. Pour les flux de travail plus complexes, vous pouvez lier plusieurs formulaires entre eux.
Déclenchez des commandes d’action à partir de la zone de rédaction d’un message, de la zone de commande ou d’un message. Lorsque vous appelez la commande à partir d’un message, la charge utile JSON initiale envoyée à votre bot inclut l’intégralité du message à partir duquel elle a été appelée. L’image suivante affiche la boîte de dialogue de commande Action d’extension de message (appelée module de tâche dans TeamsJS v1.x) :
Commandes de recherche
Les commandes de recherche vous permettent de rechercher des informations dans un système externe. Pour utiliser les commandes de recherche, entrez une requête manuellement dans la zone de recherche ou insérez un lien vers un domaine surveillé dans la zone de rédaction du message, puis incorporez les résultats de la recherche dans un message. Dans un flux de commande de recherche simple, le message d’appel initial inclut la chaîne de recherche envoyée par l’utilisateur. Vous répondez avec une liste de cartes et d’aperçus de cartes. Le client Teams affiche une liste d’aperçus de carte pour l’utilisateur. Lorsque l'utilisateur sélectionne une carte dans la liste, la carte en taille réelle est insérée dans la zone de composition du message.
Vous déclenchez les cartes à partir de la zone de composition du message ou de la boîte de commande, mais pas à partir d’un message. Vous ne pouvez pas les déclencher à partir d’un message. L’image suivante affiche la boîte de dialogue de commande Recherche d’extension de message :
Remarque
Pour plus d’informations sur les cartes, voir ce que sont les cartes.
Déploiement de lien
Remarque
Le déploiement de liens est pris en charge uniquement pour les extensions de message basées sur un bot.
Lorsque vous collez une URL dans la zone de rédaction d’un message, Teams appelle un service web. Cette fonctionnalité est appelée déploiement de liens. Vous pouvez vous abonner pour recevoir un message d’appel lorsque des URL contenant un domaine spécifique sont collées dans la zone de rédaction du message. Votre service web peut déployer l’URL dans une carte détaillée, fournissant plus d’informations que la carte d’aperçu de site web standard. Vous pouvez ajouter des boutons pour permettre aux utilisateurs d’agir immédiatement sans quitter le client Teams. Les images suivantes affichent la fonctionnalité de déploiement de lien lorsqu’un lien est collé dans une extension de message :
Build d’extensions de messages
Pour créer une extension de message, utilisez l’une des méthodes suivantes :
Générer des extensions de message à l’aide de l’API (basée sur l’API) : créez une extension de message à partir d’une API existante. Cette méthode nécessite un document de description OpenAPI (OAD).
Créer des extensions de message à l’aide de Bot Framework (basé sur un bot) : créez une extension de message à partir d’un bot si vous souhaitez une expérience de conversation individuelle.
Remarque
Les agents offrent une expérience plus flexible, plus intelligente et prête pour l’avenir, qui permet un raisonnement plus riche, un développement plus simple et un meilleur alignement avec l’évolution de Teams et de la plateforme Microsoft 365. Nous vous recommandons d’explorer et de créer des agents.
Pour plus d’informations, voir Créer des agents déclaratifs et Créer des agents dans Teams.
Si vous disposez d’une extension de message basée sur un bot, vous pouvez également l’étendre en tant qu’agent .
Le tableau suivant vous aide à sélectionner un type d’extension de message pour commencer :
Extension de message basée sur l’API
- Plus simple et plus rapide à créer et à gérer.
- L’extension de message utilise une API.
- Aucun code ou ressource supplémentaire n’est requis pour la logique du bot.
- Idéal pour les scénarios où l’extension de message a uniquement besoin de communiquer avec un service web et n’a pas besoin d’une logique complexe ou d’une gestion d’état.
- Le trafic est privatisé car il ne dépend pas de l’infrastructure de bot Azure.
- Prend en charge les commandes de recherche.
Extension de message basée sur un bot
- Plus flexible.
- L’extension de message utilise une infrastructure de robot.
- Peut utiliser toutes les fonctionnalités d’un bot.
- Idéal pour les scénarios où l’extension de message doit communiquer avec plusieurs services, gérer une logique complexe ou des interactions utilisateur, ou maintenir l’état entre les sessions.
- Prend en charge les commandes d’action, les commandes de recherche et le déploiement de liens.
Sélectionnez une option pour commencer à créer une extension de message :
Exemple de code
| Exemple de nom | Description | .NET | Node.js | Python |
|---|---|---|---|---|
| Extension de message avec des commandes basées sur des actions | Cet échantillon montre comment créer des extensions de message Action-Based pour Microsoft Teams, permettant aux utilisateurs de générer du contenu de manière interactive. Il comprend des bots, des extensions de message et une intégration transparente avec les entrées utilisateur pour des fonctionnalités améliorées. | View | View | View |
| Extension de message avec des commandes basées sur la recherche | Cet exemple montre comment créer une extension de message dans Microsoft Teams qui permet aux utilisateurs d’effectuer des recherches et de récupérer des résultats. | View | View | View |
| Aperçu de l’action d’extension de message | Cet exemple d’application illustre comment utiliser les aperçus d’action dans les extensions de message Teams, ce qui permet aux utilisateurs de créer des cartes à partir d’entrées dans un module de tâche. Il présente les interactions de bot qui améliorent l’engagement des utilisateurs en attribuant des messages aux utilisateurs. | View | View | N/A |
| Action d’extension de message pour la planification des tâches | Cet exemple illustre une extension de message qui permet aux utilisateurs de planifier des tâches et de recevoir des cartes de rappel dans Microsoft Teams. | View | View | N/A |
| Extension de message d’inventaire Northwind | Cet exemple implémente une extension de message Teams que vous pouvez utiliser comme plug-in pour Microsoft 365 Copilot. L’extension de message permet aux utilisateurs d’interroger la base de données Northwind. | N/A | View | N/A |
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.