Compartilhar via

Configurar opções predefinidas para a aplicação Teams

  • Artigo

É comum uma aplicação suportar vários cenários no Teams, mas pode tê-la concebido com um âmbito e capacidade específicos em mente. Por exemplo, se a sua aplicação for principalmente para utilização de equipas ou canais, pode certificar-se de que a primeira opção de instalação que os utilizadores veem na Microsoft Teams Store é Adicionar a uma equipa.

Captura de ecrã a mostrar a opção Adicionar a uma equipa.

Se a capacidade principal da sua aplicação for um bot, também pode tornar o bot a capacidade predefinida quando um utilizador instala a sua aplicação numa equipa.

Configurar o âmbito de instalação predefinido da aplicação

Configure o âmbito de instalação predefinido para a sua aplicação. Só pode definir um âmbito de cada vez. Para obter mais informações, consulte o manifesto do aplicativo.

Para configurar o âmbito de instalação predefinido no manifesto da aplicação:

  1. Abra o manifesto da aplicação e adicione a defaultInstallScope propriedade .

  2. Defina o valor predefinido do âmbito de instalação como , personal, team, groupchatou meetings.

    "defaultInstallScope": "meetings",

Configurar a capacidade predefinida para âmbitos partilhados

Configure a capacidade predefinida quando a sua aplicação estiver instalada para uma equipa, reunião ou groupchat. Para obter mais informações, consulte o manifesto do aplicativo.

Observação

defaultGroupCapability fornece a capacidade predefinida que é adicionada à equipa, conversa de grupo ou reunião. Selecione um separador, bot ou conector como a capacidade predefinida para a sua aplicação, mas tem de garantir que forneceu a capacidade selecionada na definição da sua aplicação.

Para configurar detalhes no manifesto da aplicação:

  1. Abra o manifesto da aplicação e adicione a defaultGroupCapability propriedade à mesma.

  2. Defina um valor de team, groupchatou meetings.

  3. Para a capacidade de grupo selecionada, as capacidades de grupo disponíveis são, bot, tabou connector.

    Observação

    Só pode selecionar uma capacidade predefinida, bot, tabou connector para a capacidade de grupo selecionada.

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

Configurar a capacidade de destino predefinida da aplicação

Pode configurar a capacidade de destino predefinida para uma aplicação que suporta capacidades de bot e separador no âmbito pessoal. Com base nesta configuração, a aplicação é aberta como um bot ou um separador por predefinição.

Pode configurar uma das seguintes opções:

Bot como capacidade de destino predefinida

Configure a sua aplicação para abrir como um bot por predefinição:

  1. Abra o manifesto da aplicação.

  2. Em bots propriedade, defina scopes como personal.

    "bots": [
    {
        "botId":"<botId>",
        "scopes": [
        "personal"
        ]

Observação

O bot atua como a capacidade de destino predefinida se o âmbito for definido como pessoal, mesmo que não especifique entityId como conversations na staticTabs propriedade .

O exemplo seguinte demonstra como abrir uma aplicação com o bot como capacidade de destino predefinida e como um utilizador pode fazer a transição para um separador:

O gráfico mostra o processo de abertura de uma aplicação com bot como capacidade de destino predefinida.

Tabulação como capacidade de destino predefinida

Configure a sua aplicação para abrir como um separador por predefinição:

  1. Abra o manifesto da aplicação.
  2. Em staticTabs propriedade:
    1. Adicione as propriedades do separador como a primeira entrada da matriz. Para definir as propriedades do separador, veja o manifesto da aplicação.
    2. Adicione as seguintes propriedades:
      1. Definir entityId como conversations.
      2. Definir scopes como personal.

O fragmento de código seguinte é um exemplo para definir o separador como a capacidade de destino predefinida:

"staticTabs": [
   {
       "entityId": "com.contoso.helloworld.hellotab",
       "name": "Hello Tab",
       "contentUrl": "https://p4p9bji0-7130.inc1.devtunnels.ms/hello",
       "scopes": [
           "personal"
       ]
   },
   {
       "entityId":"conversations",
        "scopes":[
           "personal"
        ]
   }
]

O exemplo seguinte demonstra como abrir uma aplicação com o separador como capacidade de destino predefinida e como um utilizador pode fazer a transição para um bot:

O gráfico mostra o processo de abertura de uma aplicação com o separador como capacidade de destino predefinida.

A staticTabs propriedade também é utilizada para afixar separadores pessoais e reordenar separadores. Para obter mais informações, consulte o manifesto do aplicativo.

Bloquear aplicações por predefinição para os utilizadores até que um administrador aprove

Para melhorar a experiência de utilizador de uma aplicação do Teams, por vezes, os administradores de TI têm de intervir antes de os utilizadores utilizarem a aplicação. Por exemplo, considere uma aplicação de suporte técnico criada pela Contoso Electronics para Teams. Para garantir que a aplicação funciona corretamente, a Contoso Electronics quer que os clientes configurem primeiro propriedades específicas da aplicação.

Para garantir que os administradores de TI executam as tarefas relevantes, os programadores podem bloquear uma aplicação para os utilizadores até que um administrador permita a aplicação. Para bloquear a aplicação por predefinição, defina a defaultBlockUntilAdminAction propriedade como true no ficheiro de manifesto da aplicação. Quando a propriedade está definida como true, o status da aplicação no centro de administração do Teams é Bloqueado pelo publicador na página Gerir aplicações.

Captura de ecrã a mostrar uma aplicação bloqueada pelo publicador.

Os administradores podem realizar as devidas diligências sobre a sua aplicação e podem ler a documentação da aplicação que fornecer antes de permitirem que os utilizadores utilizem a sua aplicação. Por exemplo, os administradores podem comprar as licenças necessárias e distribuir as licenças antes de permitir que os utilizadores utilizem a aplicação. Para permitir que a aplicação com Bloqueado pelo publicador status, um administrador pode selecionar Permitir na página Gerir aplicações no centro de administração do Teams.

Captura de ecrã a mostrar a opção Permitir para a aplicação bloqueada pelo publicador.

Se não quiser que a sua aplicação seja bloqueada por predefinição, atualize a defaultBlockUntilAdminAction definição para false e submeta a sua aplicação atualizada para publicação. Depois de publicarmos a nova versão da sua aplicação, esta é permitida por predefinição.

Observação

Para aplicações personalizadas criadas para a sua organização, defaultBlockUntilAdminAction não é suportado. Se carregar uma aplicação personalizada criada para a sua organização com esta propriedade, a aplicação não será bloqueada.

Exemplo de código

Nome de exemplo Descrição .NET Node.js Manifesto
Hello mundo Este exemplo demonstra como configurar a capacidade de destino predefinida para uma aplicação que suporta capacidades de bot e separador no âmbito pessoal. View View View

Próxima etapa

Criar um pacote do aplicativo