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.

Capture d’écran montrant l’option 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 qui sera ajoutée à l’équipe, au chat 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 de l’application Teams, vous pouvez bloquer une application pour les utilisateurs par défaut jusqu’à ce que l’administrateur autorise 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. L’application est bloquée par défaut et n’est disponible pour les utilisateurs qu’après qu’un administrateur l’a autorisé.

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é a la valeur true, la status de l’application dans le Centre d’administration Teams est bloquée par l’éditeur dans la page Gérer les applications.

Capture d’écran montrant une application bloquée par l’éditeur.

L’administrateur obtient une demande d’action avant qu’un utilisateur puisse accéder à l’application. Dans la page Gérer les applications du Centre d’administration Teams, un administrateur peut sélectionner Autoriser pour autoriser l’application avec bloqué par l’éditeur status.

Capture d’écran montrant l’option Autoriser pour l’application bloquée par l’éditeur.

Si, par défaut, vous ne souhaitez pas que l’application soit masquée, vous pouvez mettre à jour la propriété defaultBlockUntilAdminAction sur false. Lorsque la nouvelle version de l’application est approuvée, par défaut, l’application est autorisée tant que l’administrateur n’a pas effectué d’action explicite.

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 organization avec cette propriété, l’application n’est pas bloquée.

Étape suivante

Voir aussi

Distribuer votre application Microsoft Teams