Étendre une extension de message Teams dans Microsoft 365

Les extensions de message permettent aux utilisateurs d’interagir avec votre service web à l’aide de boutons et de formulaires. Les utilisateurs peuvent rechercher ou lancer des actions dans un système externe à partir de Microsoft Teams et Outlook en étendant vos applications Teams dans Microsoft 365. Il existe deux types d’extensions de message :

• Extensions de message basées sur la recherche : autorisez les utilisateurs à rechercher un système externe et à partager les résultats via la zone de rédaction de message du client.

• Extensions de message basées sur une action : permet aux utilisateurs disposant d’une fenêtre contextuelle modale de collecter ou d’afficher des informations, de traiter l’interaction et de renvoyer les informations au client sous la forme d’un carte enrichi.

Remarque

Les extensions de message basées sur la recherche Teams sont généralement disponibles pour Outlook et les extensions de message basées sur des actions sont disponibles en préversion pour Outlook.

Les utilisateurs mobiles Outlook sur Android et iOS peuvent recevoir et effectuer des actions sur les cartes de vos applications qui leur ont été envoyées par les utilisateurs sur Outlook sur le web et Outlook pour Windows.

L’extension de message Teams dans Microsoft 365 prend également en charge le déploiement de liens qui affichent des cartes pour lancer Stageview et des boîtes de dialogue.

Configuration requise

Pour étendre votre extension de message Teams à Outlook, vérifiez les points suivants :

• Recherchez la prise en charge des extensions de message dans Outlook pour Windows pour ordinateur de bureau, web et mobile. Consultez le tableau de prise en charge dans étendre les applications Teams dans Microsoft 365.
• Un locataire de bac à sable du programme Microsoft 365 Developer. Pour l’extension de message basé sur l’action, inscrivez votre locataire développeur pour les versions ciblées Microsoft 365.
• Un environnement de test avec des applications Microsoft 365 installées à partir du canal actuel Microsoft 365 Apps.
• (Facultatif) Microsoft Visual Studio Code avec l’extension du Kit de ressources Teams.

Générer ou étendre une extension de message

Pour étendre votre extension de message Teams à Outlook, vous pouvez créer une nouvelle application d’extension de message avec teams Toolkit ou étendre une application d’extension de message Teams existante à Outlook.

Créer une application d’extension de message pour Outlook

Vous pouvez créer une application d’extension de message Teams pour Outlook via l’extension Teams Toolkit pour Visual Studio Code. Pour créer une application d’extension de message pour Outlook, vérifiez les points suivants :

• Charger votre application dans Teams
• Afficher un aperçu de votre extension de message dans Outlook

Vous pouvez créer une extension de message basée sur la recherche ou une action.

Extension de message basée sur la recherche

1. Ouvrez Visual Studio Code.

2. Sélectionnez Palette de commandes... sous l’option Affichage ou Ctrl+Maj+P.

3. Sélectionnez Teams : Créer une application.

4. Sélectionnez Extension de message dans la liste déroulante.

5. Sélectionnez Résultats de la recherche personnalisée pour télécharger l’exemple de code d’une extension de message basée sur la recherche Teams à l’aide du manifeste d’application le plus récent (précédemment appelé manifeste d’application Teams).

   

   Vous pouvez également télécharger l’exemple de code à partir du volet gauche, sous DÉVELOPPEMENT, sélectionnez Afficher les exemples. Un onglet Exemples s’affiche, dans le champ de recherche, entrez NPM Search Connector.

   

6. Sélectionnez un langage de programmation préféré.

7. Sélectionnez un emplacement sur votre ordinateur local pour le dossier de l’espace de travail et entrez le nom de votre application.

8. Sélectionnez Palette de commandes... sous l’option Affichage ou Ctrl+Maj+P.

9. Entrez Teams : Provisionnez pour créer les ressources d’application appropriées, telles que Azure App Service, App Service plan, Azure Bot et Managed Identity, dans votre compte Azure.

10. Sélectionnez un abonnement et un groupe de ressources.

11. Sélectionnez Provisionner. Vous pouvez également sélectionner Provisionner sous la section CYCLE de vie de l’extension.

12. Sélectionnez Palette de commandes... sous l’option Affichage ou Ctrl+Maj+P.

13. Entrez Teams : Déployer pour déployer l’exemple de code sur les ressources provisionnées dans Azure et démarrer l’application. Vous pouvez également sélectionner Déployer sous la section CYCLE de vie de l’extension.

14. Sélectionnez Déployer.

Extension de message basée sur l’action

1. Ouvrez Visual Studio Code.

2. Sélectionnez Palette de commandes... sous l’option Affichage ou Ctrl+Maj+P.

3. Sélectionnez Teams : Créer une application.

4. Sélectionnez Extension de message dans la liste déroulante.

5. Sélectionnez Collecter les données d’entrée de formulaire et de traitement pour télécharger l’exemple de code d’une extension de message basée sur une action Teams à l’aide du dernier manifeste d’application (précédemment appelé manifeste d’application Teams).

   

6. Sélectionnez le langage de programmation préféré.

7. Sélectionnez un emplacement sur votre ordinateur local pour le dossier de l’espace de travail et entrez le nom de votre application.

8. Sélectionnez Palette de commandes... sous l’option Affichage ou Ctrl+Maj+P.

9. Entrez Teams : Provisionnez pour créer les ressources d’application appropriées, telles que Azure App Service, App Service plan, Azure Bot et Managed Identity, dans votre compte Azure.

10. Sélectionnez un abonnement et un groupe de ressources.

11. Sélectionnez Provisionner. Vous pouvez également sélectionner Provisionner sous la section CYCLE de vie de l’extension.

12. Sélectionnez Palette de commandes... sous l’option Affichage ou Ctrl+Maj+P.

13. Entrez Teams : Déployer pour déployer l’exemple de code sur les ressources provisionnées dans Azure et démarrer l’application. Vous pouvez également sélectionner Déployer sous la section CYCLE de vie de l’extension.

14. Sélectionnez Déployer.

À présent, vous pouvez charger votre application dans Teams et afficher un aperçu de votre extension de message dans Outlook. Pour générer votre package d’application via Teams Toolkit, consultez Générer le package d’application.

Étendre une application d’extension de message Teams existante à Outlook

Pour étendre votre application d’extension de message Teams existante à Outlook, vérifiez les points suivants :

• Mettez à jour le manifeste de votre application.
• Ajoutez le canal Microsoft 365 pour votre application.
• Mettez à jour Microsoft Entra’inscription d’application pour l’authentification unique.
• Chargez votre application mise à jour dans Teams.
• Afficher un aperçu de votre extension de message dans Outlook

Mettre à jour le manifeste de l’application

Mettez à jour la version du schéma du manifeste d’application (précédemment appelé manifeste d’application Teams) ou une version 1.13 ultérieure pour permettre à votre extension de message Teams de s’exécuter dans Outlook.

Ouvrez le manifeste de votre application et mettez à jour et $schemamanifestVersion avec les valeurs suivantes :

{
"$schema" : "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
"manifestVersion" : "1.16"
}

Vous pouvez utiliser Teams Toolkit pour valider votre manifeste d’application et identifier les erreurs éventuelles.

Spécifier les exigences du runtime de l’hôte (préversion pour les développeurs)

Pour vous assurer que votre application fournit toujours aux clients des expériences de haute qualité, vous pouvez adapter le comportement de votre application dans les hôtes Microsoft 365 applicables, ou omettre son exposition dans des contextes que vous n’êtes pas prêt à prendre en charge. Utilisez le manifeste d’application pour spécifier les relations de dépendance entre les fonctionnalités de votre application et les exigences d’exécution spécifiques de vos onglets statiques, extensions de message et bots.

Pour plus d’informations, consultez comment spécifier les exigences du runtime d’hôte Microsoft 365 dans le manifeste de votre application.

Ajouter un canal Microsoft 365 pour votre application

Dans Microsoft Teams, une extension de message se compose d’un service web que vous hébergez et d’un manifeste d’application, qui définit l’emplacement d’hébergement de votre service web. Le service web tire parti du schéma de messagerie du Kit de développement logiciel (SDK) Bot Framework et du protocole de communication sécurisé via un canal Teams inscrit pour votre bot.

Pour que les utilisateurs interagissent avec votre extension de message à partir d’Outlook, vous devez activer le canal Microsoft 365 pour votre ressource de bot Azure de l’application d’extension de message.

Remarque

Si vous avez déjà activé le canal Outlook pour votre bot, vous devez activer le canal Microsoft 365 pour que votre extension de message fonctionne correctement dans Microsoft Outlook. Le canal Outlook n’est plus utilisé pour les extensions de message s’exécutant dans Outlook et peut être désactivé.

1. Accédez à Microsoft Portail Azure ou au portail Bot Framework (si vous vous y êtes déjà inscrit), accédez à votre ressource de bot.

2. À partir de Paramètres>Canaux.

3. Sous Canaux disponibles, sélectionnez Canal Microsoft 365 .

   

4. Sélectionnez Appliquer.

   

5. Vérifiez que votre canal Microsoft 365 est répertorié avec Microsoft Teams dans le volet Canaux de votre bot.

Mettre à jour Microsoft Entra’inscription d’application pour l’authentification unique

Remarque

Vous pouvez ignorer cette étape si vous créez une application pour Outlook à l’aide du Kit de ressources Teams, car le scénario n’implique pas Microsoft Entra’authentification unique.

Microsoft Entra’authentification unique (SSO) pour les extensions de message fonctionne de la même façon dans Outlook que dans Teams. Toutefois, vous devez ajouter plusieurs identificateurs d’application client à l’inscription d’application Microsoft Entra de votre bot dans le portail inscriptions d'applications de votre locataire.

1. Connectez-vous à Portail Azure avec votre compte de locataire de bac à sable.

2. Sélectionner les inscriptions d’applications.

3. Sélectionnez le nom de votre application pour ouvrir son inscription d’application.

4. Sélectionnez Gérer>Exposer une API.

5. Dans la section Applications clientes autorisées , vérifiez que toutes les valeurs suivantes Client Id sont répertoriées :

   Application client Microsoft 365	ID du client
   Bureau et mobile Teams	1fec8e78-bce4-4aaf-ab1b-5451cc387264
   Web Teams	5e3ce6c0-2b1f-4285-8d4b-75ee78787346
   Microsoft 365 web	4765445b-32c6-49b0-83e6-1d93765276ca
   Bureau Microsoft 365	0ec893e0-5785-4de6-99da-4ed124e5296c
   Microsoft 365 mobile	d3590ed6-52b3-4102-aeff-aad2292ab01c
   Version de bureau d’Outlook	d3590ed6-52b3-4102-aeff-aad2292ab01c
   Outlook Web Access	bc59ab01-8403-45c6-8796-ac3ef710b3e3
   Outlook Mobile	27922004-5251-4030-b22d-91ecd9a37ea4

Charger votre application personnalisée dans Teams

Chargez votre extension de message mise à jour (package d’application) dans Teams. Une fois que vous avez terminé, l’extension de message s’affiche dans vos applications installées à partir de la zone de rédaction des messages.

1. Créez un fichier .zip avec un manifeste d’application et des icônes d’application.

2. Accédez à Microsoft Teams et connectez-vous à l’aide de votre compte de locataire de bac à sable.

3. Sélectionnez Applications>gérer vos applications>Charger une application.

   

4. Sélectionnez l’option Charger une application personnalisée , sélectionnez votre fichier .zip, puis installez-le (ajouter) sur votre client Teams.

   

Une fois qu’il est chargé via Teams, votre extension de message est disponible dans Outlook pour le bureau et le web.

Afficher un aperçu de votre extension de message dans Outlook

Voici comment tester votre extension de message en cours d’exécution dans Outlook sur le web. Pour afficher un aperçu de votre application en cours d’exécution dans Outlook sur le web, procédez comme suit :

1. Connectez-vous à outlook.com à l’aide de vos informations d’identification de locataire de test.

2. Sélectionnez Nouveau message.

3. Sélectionnez Applications dans le ruban.

   

Votre extension de message est répertoriée. Vous pouvez l’appeler à partir de là et l’utiliser comme vous le feriez lors de la composition d’un message dans Teams.

Débogage

Lorsque vous déboguez votre extension de message, vous pouvez identifier la source (provenant de Teams et d’Outlook) des demandes de bot par le champ channelId de l’objet Activity . Lorsqu’un utilisateur exécute une requête, votre service reçoit un objet Bot Framework Activity standard. L’une des propriétés de l’objet Activity est channelId, qui a la valeur de ou m365extensions, selon l’origine de msteams la requête du bot. Pour plus d’informations, consultez Kit de développement logiciel (SDK) d’extensions de message basées sur la recherche et SDK d’extensions de messagerie basées sur des actions.

Limitations

Bien que votre extension de message mise à jour continue de s’exécuter dans Teams, vous devez connaître les limitations suivantes :

• Les extensions de message dans Outlook sont prises en charge uniquement dans le compose contexte. Dans le manifeste de l’application Teams, les contextes d’extension de message tels que commandBox et message ne sont pas pris en charge dans Outlook.

• Les extensions de message basées sur des actions qui envoient des cartes dans la zone de composition sont prises en charge dans Outlook. Toutefois, l’utilisation de bots pour remettre des cartes n’est pas prise en charge. Dans ce scénario, vous pouvez convertir votre extension de message en cartes d’envoi en zone de composition dans Outlook.

• Vous ne pouvez pas insérer plus de cinq cartes adaptatives dans un e-mail.

• Les actions de carte de type messageBack, imBack, invokeet signin ne sont pas prises en charge. openURLest la seule action carte prise en charge.

• Les actions de carte adaptative sont prises en charge. Pour Action.Submitla vue de phase et la tâche, le lancement du module est pris en charge uniquement.

Remarque

Lorsque vous testez une application avec un déploiement de lien, veillez à supprimer l’application manuellement après le test. Si plusieurs applications surveillent le même domaine, l’application installée récemment n’est peut-être pas appelée pour déployer le lien dans Outlook, comme dans Teams.

Utilisez les canaux de la communauté des développeurs Microsoft Teams pour signaler les problèmes et fournir des commentaires.

Exemple de code

Exemple de nom	Description	Node.js
Connecteur de recherche NPM	Exemple d’application teams Toolkit pour créer une application d’extension de message. Fonctionne dans Teams et Outlook.	View
Déploiement de liens Teams	Application Teams simple pour illustrer le déploiement de liens. Fonctionne dans Teams, Outlook.	View
Onglet dans Stageview	Exemple d’application d’onglet Microsoft Teams pour montrer un onglet dans Stageview. Fonctionne dans Teams, Outlook, l’application Microsoft 365.	View
Extension de message basé sur l’action Teams pour Microsoft 365	Exemple d’application teams Toolkit pour créer une application d’extension de message. Fonctionne dans Teams et Outlook.	View

Étape suivante

Publier des applications Teams pour Outlook et Microsoft 365