Configurer les options par défaut pour l’application Teams

Il est courant qu’une application prend en charge plusieurs scénarios dans Teams, mais vous l’avez peut-être conçue avec une étendue et une fonctionnalité spécifiques à l’esprit. Par exemple, si votre application est principalement destinée à l’utilisation d’une équipe ou d’un canal, vous pouvez vous assurer que la première option d’installation que les utilisateurs voient dans le Microsoft Teams Store est Ajouter à une équipe.

Si la fonctionnalité principale de votre application est un bot, vous pouvez également faire du bot la fonctionnalité par défaut lorsqu’un utilisateur installe votre application dans une équipe.

Configurer l’étendue d’installation par défaut de votre application

Configurez l’étendue d’installation par défaut pour votre application. Vous ne pouvez définir qu’une seule étendue à la fois. Pour plus d'informations, voir app manifest

Pour configurer l’étendue d’installation par défaut dans le manifeste de votre application :

1. Ouvrez le manifeste de votre application et ajoutez la defaultInstallScope propriété .

2. Définissez la valeur d’étendue d’installation par défaut comme , personalteam, groupchatou meetings.

   "defaultInstallScope": "meetings",
   

Configurer la fonctionnalité par défaut pour les étendues partagées

Configurez la fonctionnalité par défaut lorsque votre application est installée pour une équipe, une réunion ou une conversation de groupe. Pour plus d'informations, voir app manifest

Remarque

defaultGroupCapability fournit la fonctionnalité par défaut ajoutée à l’équipe, à la conversation de groupe ou à la réunion. Sélectionnez un onglet, un bot ou un connecteur comme fonctionnalité par défaut pour votre application, mais vous devez vérifier que vous avez fourni la fonctionnalité sélectionnée dans votre définition d’application.

Pour configurer les détails dans le manifeste de l’application :

1. Ouvrez le manifeste de votre application et ajoutez-y la defaultGroupCapability propriété .

2. Définissez la valeur team, groupchatou meetings.

3. Pour la fonctionnalité de groupe sélectionnée, les fonctionnalités de groupe disponibles sont , bottabou connector.

   Remarque

   Vous ne pouvez sélectionner qu’une seule fonctionnalité par défaut, bot, tabou connector pour la fonctionnalité de groupe sélectionnée.

   "defaultGroupCapability": {
       "team": "bot",
       "groupchat": "bot",
       "meetings": "tab"
   }
   

Bloquer les applications par défaut pour les utilisateurs jusqu’à ce qu’un administrateur approuve

Pour améliorer l’expérience utilisateur d’une application Teams, parfois, les administrateurs informatiques doivent intervenir avant que les utilisateurs utilisent l’application. Par exemple, considérez une application de support technique créée par Contoso Electronics pour Teams. Pour garantir le bon fonctionnement de l’application, Contoso Electronics souhaite d’abord que les clients configurent des propriétés spécifiques de l’application.

Pour s’assurer que les administrateurs informatiques effectuent les tâches appropriées, les développeurs peuvent bloquer une application pour les utilisateurs jusqu’à ce qu’un administrateur autorise l’application. Pour bloquer l’application par défaut, définissez la defaultBlockUntilAdminAction propriété true sur dans le fichier manifeste de l’application. Lorsque la propriété est définie sur true, l’état de l’application dans le Centre d’administration Teams est Bloqué par l’éditeur dans la page Gérer les applications .

Les administrateurs peuvent faire preuve de diligence à l’égard de votre application et lire la documentation de l’application que vous fournissez avant d’autoriser leurs utilisateurs à utiliser votre application. Par exemple, les administrateurs peuvent acheter les licences requises et les distribuer avant d’autoriser les utilisateurs à utiliser l’application. Pour autoriser l’application avec l’état Bloqué par l’éditeur , un administrateur peut sélectionner Autoriser dans la page Gérer les applications du Centre d’administration Teams.

Si vous ne souhaitez pas que votre application soit bloquée par défaut, mettez à false jour le defaultBlockUntilAdminAction paramètre sur et envoyez votre application mise à jour pour publication. Une fois que nous avons publié la nouvelle version de votre application, elle est autorisée par défaut.

Remarque

Pour les applications personnalisées créées pour votre organisation, defaultBlockUntilAdminAction n’est pas pris en charge. Si vous chargez une application personnalisée conçue pour votre organisation avec cette propriété, l’application n’est pas bloquée.

Étape suivante

Créer votre package d’application