Que sont les extensions de message ?

  • 5 minutes

Lorsque vous générez une extension de message, vous créez une application pour Microsoft Teams étendue à Microsoft 365. L’extension de l’application lui permet d’apparaître dans Microsoft Outlook et dans Microsoft 365 Copilot sous la forme d’un plug-in.

Une application Microsoft Teams étendue est appelée application Microsoft 365. Une application Microsoft 365 utilise un manifeste d’application commun, un format d’empaquetage d’application et des outils de développement et d’administration que vous utilisez pour créer une application pour Microsoft Teams.

Une extension de message est une fonctionnalité d’application, qui utilise un bot pour communiquer entre l’utilisateur et le système externe.

Fonctionnalités d’extension de message

Les fonctionnalités de votre extension de message, la façon dont elle apparaît dans l’interface utilisateur et les interactions qu’elle peut prendre en charge sont définies dans le manifeste de l’application.

Les commandes et les gestionnaires de messages sont des fonctionnalités qu’une extension de message peut avoir. Une extension de message peut utiliser une combinaison de commandes de recherche et d’action, ainsi que de gestionnaires de messages.

Il existe deux types de commandes :

  • Les commandes de recherche permettent aux utilisateurs de rechercher des systèmes externes et d’insérer les résultats de cette recherche dans un message sous la forme d’un carte.
  • Les commandes d’action permettent aux utilisateurs d’agir sur les messages dans Teams, affichant une fenêtre contextuelle modale qui peut être utilisée pour collecter ou afficher des informations.

Infographie montrant les différences visuelles et fonctionnelles entre une commande de recherche et une commande d’action dans l’interface utilisateur de Microsoft Teams.

Les gestionnaires de messages permettent à votre extension de message de déployer des liens lorsqu’une URL avec un domaine particulier est collée dans la zone de rédaction du message.

Capture d’écran d’un lien dans la zone de message de rédaction de Microsoft Teams. Un carte adaptatif s’affiche incorporé dans la zone de composition des messages.

Commandes de recherche

Les commandes de recherche sont utilisées pour rechercher des systèmes externes et retourner les résultats sous forme de cartes au format enrichi. Lorsque vous créez un plug-in d’extension de message Microsoft 365 Copilot, vous avez besoin d’une application qui contient une commande de recherche d’extension de message.

Capture d’écran des résultats de la recherche retournés par une extension de message basée sur la recherche dans Microsoft Teams.

Comment fonctionne une extension de message ?

Les extensions de message utilisent un bot inscrit auprès de Bot Framework pour communiquer entre un client et le système externe.

Bot Framework est une plateforme fournie par Microsoft, qui vous fournit les outils et services dont vous avez besoin pour créer, tester, déployer et gérer des bots.

Une extension de message se compose d’une ressource de bot, d’une inscription d’application Microsoft Entra et d’un code qui utilise le Kit de développement logiciel (SDK) Bot Framework pour gérer les interactions utilisateur.

L’image suivante montre une structure générale d’une extension de message :

Diagramme montrant la structure générale d’une extension de message.

Le service bot inscrit un bot auprès de Bot Framework et reçoit des demandes du client lorsque l’utilisateur interagit avec l’extension de message. Il envoie des requêtes à un service web, qui contient le code du bot. Le service web utilise les informations d’identification d’inscription de l’application bot dans Microsoft Entra pour s’authentifier auprès du service bot. Il collecte les données du système externe et retourne les données au service bot, qui est transmis au client.

Supposons qu’un utilisateur lance une recherche à l’aide d’une extension de message. Le diagramme de séquence suivant montre les interactions :

Diagramme montrant les interactions entre les composants d’extension de message lorsqu’un utilisateur lance une recherche et que l’extension de message retourne les résultats de la recherche à l’utilisateur.

  1. L’utilisateur ouvre l’extension de message dans le client et entre une requête de recherche.
  2. Le client envoie une requête au service de bot via un point de terminaison de canal, contenant des informations sur la requête de l’utilisateur.
  3. Le service bot envoie une requête à un point de terminaison de messagerie exposé sur le service web pour gérer la requête de l’utilisateur.
  4. Le point de terminaison de messagerie reçoit la demande et appelle l’adaptateur de bot. L’adaptateur de bot utilise le bot Microsoft Entra informations d’identification d’inscription d’application pour sécuriser la communication entre le service web et le service bot.
  5. L’adaptateur de bot appelle la OnTeamsMessageExtensionQuery méthode sur la classe de gestionnaire d’activité du bot, qui contient la logique pour gérer la requête entrante.
  6. Le gestionnaire d’activités du bot obtient des données du système externe. Il crée un MessageExtensionResult, qui contient les données externes sous forme de cartes au format enrichi et un MessageExtensionResponse, qui contient le MessageExtensionResult.
  7. L’adaptateur de bot reçoit la réponse du gestionnaire d’activités du bot et crée une réponse HTTP.
  8. Le point de terminaison de messagerie retourne la réponse au service de bot.
  9. Le service bot retourne la réponse via le point de terminaison de canal à l’extension de message.
  10. L’extension de message affiche la réponse dans le client et affiche les résultats de la recherche à l’utilisateur.

Que votre extension de message prenne en charge les commandes de recherche ou d’action, ou le déploiement de liens, le même flux se produit. Le service bot transfère une requête à votre service web qui la gère et y répond.