Activer et configurer les applications pour les meetings

Chaque équipe a une façon différente de communiquer et de collaborer des tâches. Pour effectuer ces différentes tâches, personnalisez Teams avec des applications pour les réunions. Activez vos applications pour Teams réunions et configurez-les pour qu’elles soient disponibles dans l’étendue de la réunion dans leur manifeste d’application.

Configuration requise

Avec les applications pour Teams réunions, vous pouvez étendre les fonctionnalités de vos applications tout au long du cycle de vie des réunions. Avant de travailler avec des applications pour Teams réunions, vous devez remplir les conditions préalables suivantes :

Activer votre application pour Teams réunions

Pour activer votre application pour Teams réunions, mettez à jour le manifeste de votre application et utilisez les propriétés de contexte pour déterminer où votre application doit apparaître.

Mettre à jour le manifeste de l’application

Les fonctionnalités de l’application de réunions sont déclarées dans le manifeste de votre application à l’aide des configurableTabstableaux , scopeset context des tableaux. L’étendue définit qui peut accéder et le contexte définit l’emplacement où votre application est disponible.

Notes

  • Les applications dans les réunions nécessitent une groupchat étendue. L’étendue team fonctionne uniquement pour les onglets dans les canaux.
  • Les applications dans les réunions peuvent utiliser les contextes suivants : meetingChatTab, meetingDetailsTab, meetingSidePanel et meetingStage.

L’extrait de code suivant est un exemple d’onglet configurable utilisé dans une application pour les réunions Teams :


"configurableTabs": [
    {
      "configurationUrl": "https://contoso.com/teamstab/configure",
      "canUpdateConfiguration": true,
      "scopes": [
        "team",
        "groupchat"
      ],
      "context":[
        "channelTab",
        "privateChatTab",
        "meetingChatTab",
        "meetingDetailsTab",
        "meetingSidePanel",
        "meetingStage"
     ]
    }
  ]

Propriété du contexte

La propriétécontext détermine ce qui doit être affiché lorsqu'un utilisateur appelle une application dans une réunion en fonction de l'endroit où l'utilisateur appelle l'application. L’onglet context et scopes les propriétés vous permettent de déterminer où votre application doit apparaître. Les onglets de l’étendue ou groupchat de l’étendue team peuvent avoir plusieurs contextes.

Prenez en charge l’étendue groupchat pour activer votre application dans les conversations de pré-réunion et de post-réunion. Grâce à l'expérience des applications de pré-réunion, vous pouvez trouver et ajouter des applications de réunion et effectuer les tâches de pré-réunion. L'expérience de l'application post-réunion vous permet d'afficher les résultats de la réunion, tels que les résultats des sondages ou les honoraires.

Voici les valeurs de la context propriété à partir de laquelle vous pouvez utiliser la totalité ou une partie des valeurs :

Valeur Description
channelTab Onglet dans l’en-tête d’un canal d’équipe
privateChatTab Onglet dans l’en-tête d’une conversation de groupe entre un ensemble d’utilisateurs, et non dans le contexte d’une équipe ou d’une réunion.
meetingChatTab Un onglet dans l'en-tête d'une conversation de groupe entre un ensemble d'utilisateurs pour une réunion planifiée. Vous pouvez spécifier soit meetingChatTab ou meetingDetailsTab pour vous assurer que les applications fonctionnent sur mobile.
meetingDetailsTab Un onglet dans l'en-tête de la vue des détails de la réunion du calendrier. Vous pouvez spécifier soit meetingChatTab ou meetingDetailsTab pour vous assurer que les applications fonctionnent sur mobile.
meetingSidePanel Un panneau en réunion s'est ouvert à travers le bar unifié (U-bar).
meetingStage Une application de meetingSidePanel peut être partagée à l'étape de la réunion. Vous ne pouvez pas utiliser cette application sur les clients mobiles ou de salle Teams.

Une fois que vous avez activé votre application pour Teams réunions, vous devez configurer votre application avant une réunion, pendant une réunion et après une réunion.

Configurer votre application pour les scénarios de réunion

Teams réunions offre une expérience collaborative à votre organisation. Configurez votre application pour différents scénarios de réunion et pour améliorer l’expérience de réunion. Vous pouvez maintenant identifier les actions qui peuvent être effectuées dans les scénarios de réunion suivants :

Avant une réunion

Avant une réunion, les utilisateurs peuvent ajouter des onglets, des bots et des extensions de message. Les utilisateurs disposant de rôles d’organisateur et de présentateur peuvent ajouter des onglets à une réunion.

Pour ajouter un onglet à une réunion :

  1. Dans votre calendrier, sélectionnez une réunion à laquelle vous souhaitez ajouter un onglet.

  2. Sélectionnez l’onglet Détails , puis sélectionnez Plus button.

    Pre-meeting experience
  3. Dans la galerie d’onglets qui s’affiche, sélectionnez l’application que vous souhaitez ajouter et suivez les étapes nécessaires. L’application est installée sous forme d’onglet.

Pour ajouter une extension de message à une réunion :

  1. Sélectionnez les points de suspension ●●● situés dans la zone de composition du message dans la conversation.
  2. Sélectionnez l’application que vous souhaitez ajouter et suivez les étapes nécessaires. L’application est installée en tant qu’extension de message.

Pour ajouter un bot à une réunion :

Dans une conversation de réunion, entrez la @ clé et sélectionnez Obtenir des bots.

Notes

  • La boîte de dialogue en réunion affiche une boîte de dialogue dans une réunion et publie simultanément une carte adaptative dans la conversation de réunion auxquelles les utilisateurs peuvent accéder. La carte adaptative dans la conversation de réunion aide les utilisateurs lors de la participation à la réunion ou si l’application Teams est réduite.
  • L’identité de l’utilisateur doit être confirmée à l’aide de l’authentification unique des onglets. Après l’authentification, l’application peut récupérer le rôle d’utilisateur à l’aide de l’API GetParticipant .
  • En fonction du rôle d’utilisateur, l’application peut fournir des expériences spécifiques au rôle. Par exemple, une application d’interrogation autorise uniquement les organisateurs et les présentateurs à créer un sondage.
  • Les attributions de rôles peuvent être modifiées pendant qu’une réunion est en cours. Pour plus d’informations, consultez Partager du contenu dans une réunion Teams.

Lors d'une réunion

Pendant une réunion, vous pouvez utiliser la notification ou la meetingSidePanel notification en réunion pour créer des expériences uniques pour vos applications.

SidePanel de réunion

Le meetingSidePanel vous permet de personnaliser les expériences d’une réunion qui permettent aux organisateurs et aux présentateurs d’avoir différents ensembles de vues et d’actions. Dans le manifeste de votre application, vous devez l’ajouter meetingSidePanel au tableau de contextes. Dans la réunion et dans tous les scénarios, l’application est affichée dans un onglet de la réunion de 320 pixels de largeur. Pour plus d'informations, consultez l'interface FrameInfo (connue sous le nom de FrameContext avant TeamsJS v.2.0.0).

Vous pouvez utiliser le contexte de l'utilisateur pour acheminer les requêtes. Pour plus d’informations, consultez Flux d’authentification Teams pour les onglets. Le flux d’authentification pour les onglets est similaire au flux d’authentification pour les sites web. Les onglets peuvent utiliser OAuth 2.0 directement. Pour plus d'informations, consultezPlateforme d'identité Microsoft et flux de code d'autorisation OAuth 2.0.

L’extension de message fonctionne comme prévu lorsqu’un utilisateur est en mode réunion. L’utilisateur peut publier des cartes d’extension de message de composition. AppNameen réunion est une info-bulle qui indique le nom de l’application dans la barre U de la réunion.

Notes

Utilisez la version 1.7.0 ou ultérieure de Teams SDK, car les versions antérieures ne prennent pas en charge le panneau latéral.

Notification en réunion

La notification en réunion est utilisée pour impliquer les participants pendant la réunion et collecter des informations ou des commentaires pendant la réunion. Utilisez une charge utile de notification en réunion pour déclencher une notification en réunion. Dans le cadre de la charge utile de la demande de notification, incluez l’URL où le contenu à afficher est hébergé.

La notification en réunion ne doit pas utiliser le module de tâche. Le module de tâche n’est pas appelé dans la conversation de la réunion. Une URL de ressource externe est utilisée pour afficher la notification en réunion. Vous pouvez utiliser la submitTask méthode pour envoyer des données dans une conversation de réunion.

Exemple montrant comment utiliser une boîte de dialogue en réunion.

Vous pouvez également ajouter l’image d’affichage Teams et la carte de contacts de l’utilisateur à la notification en réunion en fonction du jeton onBehalfOf avec l’utilisateur NULL et le nom d’affichage transmis dans la charge utile. Voici un exemple de charge utile :

    {
       "type": "message",
       "text": "John Phillips assigned you a weekly todo",
       "summary": "Don't forget to meet with Marketing next week",
       "channelData": {
           onBehalfOf: [
             { 
               itemId: 0, 
               mentionType: 'person', 
               mri: context.activity.from.id, 
               displayname: context.activity.from.name 
             }
            ],
           "notification": {
           "alertInMeeting": true,
           "externalResourceUrl": "https://teams.microsoft.com/l/bubble/APP_ID?url=<url>&height=<height>&width=<width>&title=<title>&completionBotId=BOT_APP_ID"
            }
        },
       "replyToId": "1493070356924"
    }

Exemple montrant comment l’image d’affichage Teams et la carte de contacts sont utilisées avec la boîte de dialogue en réunion.

Étape de réunion partagée

La phase de réunion partagée permet aux participants à la réunion d’interagir et de collaborer sur le contenu de l’application en temps réel. Vous pouvez partager vos applications à l’étape de la réunion collaborative des manières suivantes :

Partager l’intégralité de l’application en plusieurs étapes

Les participants peuvent partager l'ensemble de l'application avec la scène de la réunion collaborative en utilisant le bouton Partager la scène du panneau latéral de l'application.

Share full app

Pour partager l’ensemble de l’application à mettre en scène, dans le manifeste de l’application, vous devez configurer meetingStage et meetingSidePanel en tant que contextes d’image. Par exemple :

"configurableTabs": [
    {
      "configurationUrl": "https://contoso.com/teamstab/configure",
      "canUpdateConfiguration": true,
      "scopes": [
        "groupchat"
      ],
      "context":[
        "meetingSidePanel",
        "meetingStage"
     ]
    }
  ]

Pour plus d'informations, voir app manifest

Partager des parties spécifiques de l’application à mettre en scène

Les participants peuvent partager des parties spécifiques de l'application vers la fenêtre de partage collaborative en utilisant les API de partage vers la scène. Les API sont disponibles dans le SDK du client Teams et sont invoquées à partir du panneau latéral de l'application.

Share specific parts of the app

Pour partager des parties spécifiques de l'application sur scène, vous devez invoquer les API correspondantes dans la bibliothèque SDK du client Teams. Pour plus d'informations, consultez la référence de l’API.

Notes

  • Pour partager des parties spécifiques de l’application à mettre en scène, utilisez Teams manifeste version 1.12 ou ultérieure.
  • Le partage de parties spécifiques de l’application à l’étape est pris en charge pour Teams clients de bureau uniquement.

Après une réunion

Les configurations d’après et d’avant les réunions sont les mêmes .

Exemple de code

Exemple de nom Description C# Node.js
Application de réunion Démontre comment utiliser l'application Meeting Token Generator pour demander un jeton. Le jeton est généré de manière séquentielle afin que chaque participant ait une occasion équitable de contribuer à une réunion. Ce jeton est utile dans des situations telles que les réunions de mêlée et les séances de questions-réponses. View View
Exemple de phase de réunion Exemple d’application pour afficher un onglet dans la phase de réunion pour la collaboration View View
Panneau latéral de la réunion Exemple d’application pour montrer comment ajouter un ordre du jour dans un panneau latéral de la réunion View -

Guides détaillés

  • Suivez le guide pas à pas pour générer un jeton de réunion dans votre réunion Teams.
  • Suivez le guide pas à pas pour générer un panneau latéral de réunion dans votre réunion Teams.
  • Suivez le guide pas à pas pour partager l’affichage de la vue des étapes dans votre réunion Teams.
  • Suivez le guide pas à pas pour générer une bulle de contenu de réunion dans votre réunion Teams.

Étape suivante

Voir aussi