Qu-est-ce qu’une application Microsoft Teams ?

Effectué

Une application élaborée sur la plateforme Microsoft Teams développe le client Microsoft Teams (web, mobile et bureau) avec les services web que vous hébergez. La plateforme Teams offre un ensemble complet et flexible de points d’extension, de concepts d’interface utilisateur et d’API dont vous pouvez tirer parti lors de la création de votre application. Votre application peut être aussi simple que d’incorporer votre site web existant dans un onglet pour votre équipe ou une application polyvalente complète qui engage vos utilisateurs dans toute la portée du client Teams. Vous pouvez décider d’intégrer une application existante ou de créer une expérience entièrement conçue pour Teams.

Grâce à la plateforme Microsoft Teams, vous pouvez élargir vos services à l’aide d’informations contextuelles accessibles à partir des différentes API Microsoft Teams, telles que des informations sur l’équipe ou le canal sur lequel votre application est installée, ou des messages à partir desquels votre application a été lancée. Vous pouvez créer des applications pour un utilisateur individuel, une équipe, votre organisation toute entière ou publier votre application sur le magasin d’applications public pour permettre à tout le monde de l’utiliser.

De quoi se compose une application Microsoft Teams ?

Les applications développées sur la plateforme Microsoft Teams sont constituées de trois principaux éléments.

  • Le client Microsoft Teams fournit des points d’extension et des éléments d’interface utilisateur que votre application utilise pour motiver vos utilisateurs.
  • Votre package d’applications Teams est le package installé dans Microsoft Teams. Il contient une petite icône, une grande icône et un fichier manifeste JSON. Le fichier manifeste contient les métadonnées de votre application (comme le nom de l'application, le nom du développeur, etc.), les points d'extensibilité que votre application utilise (comme les onglets et les extensions de messagerie) et les pointeurs vers les services web qui alimentent votre application (comme l'ID de votre robot ou l'URL de votre onglet).
  • Vos services web que vous hébergez qui fournissent les API et la logique alimentant votre application.

Il est important de garder à l’esprit que la plateforme Microsoft Teams n’est pas un service d’hébergement. Les services web qui alimentent votre application doivent être hébergés par vous et accessibles via HTTPS sur Internet.

Où pouvez-vous étendre le client Teams ?

Il existe plusieurs emplacements dans lesquels le client Microsoft Teams peut être étendu pour permettre aux utilisateurs de communiquer avec votre application. Selon votre scénario, vous pouvez décider de vous concentrer sur un point d’extension unique (par exemple, un bot de conversation personnel) ou de combiner plusieurs points d’extension.

Les équipes, canaux et conversations de groupe

Teams, canaux et discussions de groupe permettent à plusieurs personnes de collaborer. Les applications qui étendent le contexte se mettent à la disposition de tous les membres du groupe ou de la conversation, en se concentrant généralement sur l'activation d'autres flux de travail collaboratifs ou le déblocage de nouvelles interactions sociales. Votre application a accès aux API permettant d’obtenir des informations sur les membres de la conversation, les canaux d’une équipe et les métadonnées relatives à l’équipe ou à la conversation.

Elles peuvent être développées avec :

  • Les bots de conversation interagissent avec les membres de la conversation via discussion et répondent aux événements (tel que l’ajout d’un nouveau membre ou le changement de nom d’un canal). Toutes les conversations avec un robot dans ce contexte sont visibles par tous les membres du canal ou du groupe. Vous devez donc vous assurer que la conversation concerne tout le monde.
  • Les onglets du canal d'appel & de conversation de groupe fournissant une expérience web incorporée plein écran configurée pour le canal ou la conversation de groupe dans qui il est installé. Tous les membres communiquent sur la même application web partagée. Une expérience d’application d’une seule page sans état est donc représentative.
  • Les webhooks & connecteurs permettant aux services externes de publier des messages dans la conversation. Vous pouvez tirer parti de cartes et d’actions de carte pour créer des messages enrichis et actionnables. Les webhooks offrent une méthode simple, unidirectionnelle et non authentifiée pour publier des messages dans un canal, alors que les connecteurs fournissent une expérience aller-retour un peu plus fiable.

Applications personnelles

Les applications personnelles sont la partie de votre application Teams qui se concentre sur les communications avec un seul utilisateur. L’expérience est propre à chaque utilisateur individuel. Cette partie de votre application peut être épinglée au rail de navigation de gauche, ce qui permet à vos utilisateurs d’y accéder en un clic.

Elles peuvent contenir les éléments suivants :

  • Des bots de conversation ayant des conversations individuelles avec l’utilisateur. Du fait qu’il s’agit d’une conversation privée, si votre application nécessite des conversations multiples avec un utilisateur, ou doit fournir une notification à un seul utilisateur, il est généralement préférable d’effectuer cette communication dans une application personnelle.
  • Les onglets personnels offrant une expérience web intégrée plein écran.

Messages

Les messages sont au cœur de la collaboration dans Teams. Avec une commande d’action d’extension de messagerie, votre application peut permettre aux utilisateurs d’appeler l’API de votre application à partir d’un message, en envoyant le contenu du message vers votre application pour traitement ou action. Votre application peut répondre en présentant un formulaire (un module de tâche) à l’utilisateur pour recueillir davantage d’informations, envoyer une réponse au courrier d’origine ou envoyer un message directement à l’utilisateur.

Rédaction de messages

Votre application aide les utilisateurs à créer des messages plus performants en permettant leurs recherches ou en prenant des mesures dans un système externe, et à insérer les résultats dans un format structuré complet avec des boutons actionnables.

Votre application peut permettre aux utilisateurs de créer des messages plus performants de trois manières :

  • Extension de messagerie : les commandes d’action présentent à votre utilisateur une feuille modale (un module de tâche), envoient les résultats de la feuille à votre application, puis insèrent directement un message dans la conversation ou créent une portion du message que l’utilisateur peut modifier avant de l’envoyer vers la conversation.
  • Extension de messagerie : les commandes de recherche leur permettant d’effectuer une recherche rapide dans un système externe, de prévisualiser les résultats de la recherche, puis d’insérer les résultats dans la conversation sous forme de carte enrichie.
  • Extension de messagerie : le déploiement de lien permet à votre application de contrôler les domaines web qui vous intéressent. Lorsqu’une URL contenant ce domaine est collée dans la boîte de dialogue de composition de message, l’API de votre application est appelée, ce qui vous permet d’ajouter une carte enrichie au message contenant des informations supplémentaires sur l’élément qui est lié.

Éléments de l’interface utilisateur (IU)

Outre les points d’extension, la plateforme Microsoft Teams fournit des éléments d’interface utilisateur flexibles dont les applications peuvent tirer parti. Ces éléments vous permettent de créer des expériences enrichies, natives pour le client Teams.

Cartes et actions de carte

Les cartes sont des conteneurs d’interface utilisateur définis par JSON schématisé pouvant posséder plusieurs propriétés et pièces jointes. Elles peuvent contenir du texte mis en forme, des multimédias, des contrôles (tels que des zones de liste déroulantes et des cases d’option), ainsi que des boutons déclenchant des actions de carte. Les actions de carte peuvent envoyer des charges utiles vers l’API de votre application, ouvrir un lien, démarrer des flux d’authentification ou envoyer des messages vers les conversations. La plateforme Microsoft Teams prend en charge plusieurs types de cartes (cartes adaptatives, cartes Heroes, cartes miniatures, et bien plus encore). Elles peuvent être combinées dans des collections de cartes et affichées dans une liste ou un carrousel.

Modules de tâches

Les modules de tâches vous permettent de créer des expériences de menu contextuel modal dans votre application Teams. Dans le menu contextuel, vous pouvez exécuter votre propre code HTML/JavaScript personnalisé, afficher un <iframe> tel qu’une vidéo YouTube ou Microsoft Stream ou afficher une carte adaptative. Ils sont particulièrement utiles pour commencer et effectuer des tâches, ou afficher des informations enrichies, telles que des vidéos ou des tableaux de bord Power BI. Une expérience contextuelle est souvent plus naturelle pour les utilisateurs qui commencent et effectuent des tâches, par rapport à une expérience d’onglet ou de bot basée sur une conversation.

Votre application peut créer des liens URL profonds pour permettre à votre utilisateur de parcourir votre application et le client Teams. Vous pouvez créer un lien profond pour la plupart des entités au sein de Teams, et certaines (par exemples, une nouvelle demande de réunion) vous permettent de pré-renseigner des informations à l’aide de chaînes de requête dans l’URL. Par exemple, votre robot conversationnel pourrait envoyer un message à un canal avec un lien profond vers un module de tâche qui aboutit à l'envoi d'une carte sous forme de message individuel à un utilisateur, qui contient à son tour un lien profond pour créer une nouvelle réunion avec un utilisateur spécifique à une certaine date/heure. Utilisez des liens profonds pour vous connecter aux différents points d'extension disponibles dans votre application, afin de maintenir l'utilisateur dans le bon contexte.

Pages de contenu web

Une page de contenu web est une page web que vous hébergez et qui peut être incorporée dans un onglet ou un module de tâche. Pour autoriser l’incorporation de votre page web dans un client Microsoft Teams, celle-ci doit :

  • Être hébergée sur un site HTTPS.
  • Être incorporée dans un <iframe> par le client Teams.
  • Inclure le kit de développement logiciel (SDK) de client JavaScript Microsoft Teams et appeler la méthode initialize() du kit de développement au chargement de la page.

Synthèse

Une application Microsoft Teams est un ensemble de services web hébergés en externe dans Microsoft Teams, qui tire parti des points d’extension et des éléments de l’interface utilisateur mis à disposition via la plateforme Microsoft Teams.