Étendre une extension Teams message à travers Microsoft 365

Notes

L’extension d Teams de message Microsoft 365 est actuellement disponible uniquement en prévisualisation pour les développeurs publics. Les fonctionnalités incluses dans la prévisualisation peuvent ne pas être terminées et peuvent faire l’objet de modifications avant de devenir disponibles dans la version publique. Elles sont fournies uniquement à des fins de test et d’exploration. Elles ne doivent pas être utilisées dans les applications de production.

Les extensions de messagerie basées sur la recherche permettent aux utilisateurs de rechercher un système externe et de partager des résultats via la zone de composition de message du client Microsoft Teams client. En étendant vos applications Teams sur Microsoft 365 (prévisualisation),vous pouvez désormais apporter vos extensions de message Teams basées sur la recherche à Outlook pour les expériences de bureau et web Windows.

Le processus de mise à jour de votre extension Teams de message basée sur la Outlook nécessite les étapes suivantes :

  • Mettre à jour le manifeste de votre application
  • Ajouter un canal Outlook pour votre bot
  • Chargez une version de version de votre application mise à jour dans Teams

Le reste de ce guide vous guide tout au long de ces étapes et vous montre comment afficher un aperçu de votre extension de message dans les deux Outlook pour Windows bureau et web.

Conditions préalables

Pour terminer ce didacticiel, vous aurez besoin des instructions ci-après :

  • Un client Microsoft 365 programme pour les développeurs en bac à sable (sandbox)
  • Votre client bac à sable (sandbox) inscrit à Office 365 releases ciblées
  • Un environnement de test avec Office applications installées à partir du canal Microsoft 365 Apps bêta
  • Visual Studio Code avec l’extension Teams Shared Computer Toolkit (prévisualisation) (facultatif)

Préparer votre extension de messagerie pour la mise à niveau

Si vous avez une extension de messagerie existante, faites une copie ou une branche de votre projet de production pour tester et mettez à jour votre ID d’application dans le manifeste de l’application pour utiliser un nouvel identificateur (distinct de l’ID d’application de production).

Si vous souhaitez utiliser un exemple de code pour suivre ce didacticiel, suivez les étapes de configuration de l’exemple de recherche d’extension de messagerie Teams pour créer et inscrire rapidement un bot.

Mettre à jour le manifeste de l’application

Vous devez utiliser le schéma de manifeste d’aperçu Teams développeur et la version du manifeste pour permettre à votre extension de messagerie Teams de s’exécuter m365DevPreview dans Outlook.

Vous avez deux options pour mettre à jour votre manifeste d’application :

  1. Ouvrez la palette de commandes: Ctrl+Shift+P
  2. Exécutez la Teams: Upgrade Teams manifest to support Outlook and Office apps commande et sélectionnez votre fichier manifeste d’application. Les modifications seront apportées en place.

Si vous avez utilisé Teams Shared Computer Toolkit pour créer votre application d’extension de messagerie, vous pouvez l’utiliser pour valider les modifications apportées à votre fichier manifeste et identifier les erreurs éventuelles. Ouvrez la palette de commandes et recherchez Teams : Valider le fichier manifeste ou sélectionnez l’option dans le menu Déploiement de l’Teams Shared Computer Toolkit (recherchez l’icône Teams sur le côté gauche de Ctrl+Shift+P Visual Studio Code).

Teams Shared Computer Toolkit’option « Valider le fichier manifeste » sous le menu « Déploiement »

Ajouter un canal Outlook pour votre bot

Dans Microsoft Teams, une extension de messagerie se compose d’un service web que vous hébergez et d’un manifeste d’application, qui définit l’endroit où votre service web est hébergé. Le service web tire parti du schéma de messagerie du SDK Bot Framework et du protocole de communication sécurisée via un canal Teams enregistré pour votre bot.

Pour que les utilisateurs interagissent avec votre extension de messagerie à partir Outlook, vous devez ajouter un canal Outlook à votre bot :

  1. À partir du portail Azure (ou du portail Bot Framework si vous vous y êtes inscrit précédemment), accédez à votre ressource bot.

  2. À partir Paramètres, sélectionnez Canaux.

  3. Cliquez sur Outlook, sélectionnez l’onglet Extensions de message, puis cliquez sur Enregistrer.

    Ajouter un Outlook canal « Extensions de message » pour votre bot à partir du volet Canaux du bot Azure

  4. Confirmez que votre canal Outlook est répertorié avec Microsoft Teams dans le volet Canaux de votre bot :

    Volet Canaux des bots Azure répertoriant les canaux Microsoft Teams et Outlook’équipe

Chargez une version de votre extension de messagerie mise à jour dans Teams

La dernière étape consiste à recharger une version de votre extension de messagerie mise à jour(packaged’application) dans Microsoft Teams. Une fois terminé, votre extension de messagerie s’affiche dans vos applications installées à partir de la zone composer un message.

  1. Compressez votre application Teams (icônes de manifeste et d’application)dans un fichier zip. Si vous avez utilisé Teams Shared Computer Toolkit pour créer votre application, vous pouvez facilement le faire à l’aide de l’option package de métadonnées Zip Teams dans le menu Déploiement de Teams Shared Computer Toolkit :

    Option « Zip Teams package de métadonnées » dans l’extension Teams Shared Computer Toolkit pour Visual Studio Code

  2. Connectez-vous à Teams avec votre compte de client bac à sable et vérifiez que vous êtes sur la prévisualisation publique du développeur en cliquant sur le menu des ellipses (...) en fonction de votre profil utilisateur et en ouvrant Sur le point de vérifier que l’option d’aperçu développeur est bas de page.

    À Teams menu des ellipses, ouvrez « À propos de » et vérifiez que l’option « Aperçu développeur » est cochée

  3. Ouvrez le volet Applications, puis cliquez sur Télécharger une application personnalisée, puis Télécharger pour moi ou mes équipes.

    Bouton « Télécharger application personnalisée » dans le volet Teams applications

  4. Sélectionnez votre package d’application, puis cliquez sur Ouvrir.

Une fois le chargement de version Teams, votre extension de messagerie sera disponible dans Outlook sur le web.

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

Vous êtes maintenant prêt à tester votre extension de messagerie en cours d’exécution Outlook sur Windows bureau et sur le web. Bien que votre extension de messagerie mise à jour continue de s’exécuter dans Teams avec la prise en charge complète des fonctionnalités pour les extensions de messagerie, il existe des limitationsdans cet aperçu préliminaire de l’expérience Outlook-activé à prendre en compte :

  • Les extensions de messagerie Outlook sont limitées au contexte de composition de messagerie. Même si votre extension Teams message inclut en tant que contexte dans son manifeste, l’aperçu actuel est limité à commandBox l’option de composition de courrier ( compose ). L’vot d’une extension de message à partir de la zone Outlook recherche n’est pas pris en charge.
  • Les commandes d’extension de messagerie basées sur l’action ne sont pas prises en charge dans Outlook. Si votre application dispose de commandes basées sur la recherche et l’action, elle s’Outlook mais le menu d’action n’est pas disponible.
  • L’authentification sans authentification unique n’est pas prise en charge pour les extensions de messagerie Outlook.
  • L’insertion de plus de cinq cartes adaptatives dans un e-mail n’est pas prise en charge . Les cartes adaptatives v1.4 et ultérieures ne sont pas pris en charge.
  • Les actions de carte de type , et ne sont pas prises en charge messageBack pour les cartes imBack invoke signin insérées. La prise en charge est limitée à : sur clic, l’utilisateur est openURL redirigé vers l’URL spécifiée dans un nouvel onglet.

Lorsque vous testez votre extension de messagerie, vous pouvez identifier la source (provenant de Teams par rapport à Outlook) des demandes de bot par le channelId de l’objet Activity. Lorsqu’un utilisateur effectue une requête, votre service reçoit un objet Bot Framework Activity standard. L’une des propriétés de l’objet Activity est , qui aura la valeur de ou, en fonction de l’origine de la channelId msteams demande de outlook bot. Pour plus d’informations, voir le SDK des extensions de messagerie basées sur la recherche.

Outlook

Pour afficher un aperçu de l’exécution de votre application Outlook sur Windows bureau, Outlook connecté avec les informations d’identification de votre client de test. Cliquez sur Nouveau courrier électronique. Ouvrez le menu volant Plus d’applications dans le ruban supérieur. Votre extension de message sera répertoriée. Vous pouvez l’appeler à partir de là et l’utiliser comme vous le feriez lors de la composition d’un message Teams.

Outlook sur le web

Pour afficher un aperçu de l’exécution de votre application Outlook sur le web, connectez-vous outlook.com à l’aide des informations d’identification de votre client de test. Cliquez sur Nouveau message. Ouvrez le menu volant Plus d’applications en bas de la fenêtre de composition. Votre extension de message sera répertoriée. Vous pouvez l’appeler à partir de là et l’utiliser comme vous le feriez lors de la composition d’un message Teams.

Étapes suivantes

Outlook extensions de messagerie Teams activées sont en prévisualisation et ne sont pas pris en charge pour une utilisation en production. Voici comment distribuer votre extension de messagerie Outlook pour afficher un aperçu des audiences à des fins de test.

Distribution d’un seul client

Outlook onglets personnels Office et activés pour l’aperçu peuvent être distribués à une audience en prévisualisation sur un client de test (ou de production) de l’une des trois manières ci-après :

Teams client

Dans le menu Applications, sélectionnez Gérer vos applications > Envoyer une application à votre organisation. Cela nécessite l’approbation de votre administrateur informatique.

Microsoft Teams Admin Center

En tant Teams, vous pouvez télécharger et préinstaller le package d’application pour le client de votre organisation à partir de https://admin.teams.microsoft.com/ . Pour plus d Télécharger, voir Télécharger vos applications personnalisées dans le centre Microsoft Teams’administration.

Centre d’administration Microsoft

En tant qu’administrateur général, vous pouvez télécharger et préinstaller le package d’application à partir de https://admin.microsoft.com/ . Pour plus d’informations, voir Tester et déployer Microsoft 365 Apps par des partenaires dans le portail des applications intégrées.

Distribution multi-locataires

La distribution dans Microsoft AppSource n’est pas encore prise en charge pendant cette prévisualisation préliminaire pour les développeurs Outlook’extensions Teams message.