Configurar opções padrão para o aplicativo teams

É comum que um aplicativo dê suporte a vários cenários no Teams, mas você pode tê-lo projetado com um escopo e funcionalidade específicos em mente. Por exemplo, se seu aplicativo for principalmente para uso de equipe ou canal, você pode garantir que a primeira opção de instalação que os usuários veem na Microsoft Teams Store seja Adicionar a uma equipe.

A captura de tela mostra a opção Adicionar a uma equipe.

Se o recurso principal do seu aplicativo for um bot, você também poderá tornar o bot o recurso padrão quando um usuário instala seu aplicativo em uma equipe.

Configurar o escopo de instalação padrão do aplicativo

Configure o escopo de instalação padrão para seu aplicativo. Você pode definir apenas um escopo por vez. Para obter mais informações, consulte o manifesto do aplicativo.

Para configurar o escopo de instalação padrão no manifesto do aplicativo:

  1. Abra o manifesto do aplicativo e adicione a defaultInstallScope propriedade.

  2. Defina o valor de escopo de instalação padrão como , personal, team, groupchatou meetings.

    "defaultInstallScope": "meetings",
    

Configurar o recurso padrão para escopos compartilhados

Configure o recurso padrão quando seu aplicativo estiver instalado para uma equipe, reunião ou groupchat. Para obter mais informações, consulte o manifesto do aplicativo.

Observação

defaultGroupCapability fornece o recurso padrão que será adicionado à equipe, à conversa em grupo ou à reunião. Selecione uma guia, bot ou conector como o recurso padrão para seu aplicativo, mas você deve garantir que você tenha fornecido o recurso selecionado em sua definição de aplicativo.

Para configurar detalhes no manifesto do aplicativo:

  1. Abra o manifesto do aplicativo e adicione a defaultGroupCapability propriedade a ele.

  2. Defina um valor de team, groupchatou meetings.

  3. Para o recurso de grupo selecionado, os recursos de grupo disponíveis são, bot, ou tabconnector.

    Observação

    Você pode selecionar apenas um recurso padrão, bot, tabou connector para o recurso de grupo selecionado.

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

Bloquear aplicativos por padrão para usuários até que um administrador aprove

Para aprimorar a experiência do usuário de um aplicativo do Teams, às vezes, os administradores de TI devem intervir antes que os usuários usem o aplicativo. Por exemplo, considere um aplicativo de help desk criado pela Contoso Electronics for Teams. Para garantir que o aplicativo funcione corretamente, a Contoso Electronics deseja que os clientes configurem as propriedades específicas do aplicativo primeiro.

Para garantir que os administradores de TI executem as tarefas relevantes, os desenvolvedores podem bloquear um aplicativo para usuários até que um administrador permita o aplicativo. Para bloquear o aplicativo por padrão, defina a defaultBlockUntilAdminAction propriedade como true no arquivo de manifesto do aplicativo. Quando a propriedade é definida como true, o status do aplicativo no centro de administração do Teams é bloqueado pelo editor na página Gerenciar aplicativos.

A captura de tela mostra um aplicativo bloqueado pelo editor.

Os administradores podem fazer a devida diligência sobre seu aplicativo e podem ler a documentação do aplicativo que você fornece antes que eles permitam que seus usuários usem seu aplicativo. Por exemplo, os administradores podem comprar as licenças necessárias e distribuir as licenças antes de permitir que os usuários usem o aplicativo. Para permitir que o aplicativo com Bloqueado pelo editor status, um administrador pode selecionar Permitir na página Gerenciar aplicativos no centro de administração do Teams.

A captura de tela mostra a opção Permitir para o aplicativo bloqueado pelo editor.

Se você não quiser que seu aplicativo seja bloqueado por padrão, atualize a defaultBlockUntilAdminAction configuração para false e envie seu aplicativo atualizado para publicação. Depois de publicarmos a nova versão do seu aplicativo, ela será permitida por padrão.

Observação

Para aplicativos personalizados criados para sua organização, defaultBlockUntilAdminAction não há suporte. Se você carregar um aplicativo personalizado criado para sua organização com essa propriedade, o aplicativo não será bloqueado.

Próxima etapa

Confira também

Distribuir seu aplicativo Microsoft Teams