Carregar seu aplicativo no Teams

Você pode carregar aplicativos do Microsoft Teams sem precisar publicar em sua organização ou na Loja do Microsoft Teams nos seguintes cenários:

  • Você deseja testar e depurar um aplicativo localmente por conta própria ou com outros desenvolvedores.
  • Você criou um aplicativo para você mesmo para automatizar um fluxo de trabalho.
  • Você criou um aplicativo para um pequeno conjunto de usuários, como seu grupo de trabalho.

Importante

  • O upload de aplicativo personalizado só é possível na GCC (Nuvem da Comunidade Governamental) e não é possível no GCC High, no DoD (Departamento de Defesa) e no Teams operado pela 21Vianet.
  • O carregamento e a instalação de aplicativos têm suporte no Teams para área de trabalho e Web (a disponibilidade depende das políticas de configuração do aplicativo e do ambiente de nuvem da sua organização)
  • Recomendamos que você evite vários uploads de seu aplicativo de extensão de mensagem para o Teams, pois isso resulta em várias instâncias da extensão de mensagem.

Os usuários não podem conversar com bots que não estão conectados a um aplicativo do Microsoft Teams, como bots do Azure criados por meio do Bot Framework ou Power Virtual Agents. Recomendamos que você crie um novo aplicativo Teams conectado ao Bot do Azure usando o Portal do Desenvolvedor, publique-o no Teams e permita que os usuários instalem o aplicativo usando as políticas de permissão de aplicativo.

Se quiser testar o aplicativo, você pode atribuir aos usuários uma política de configuração de aplicativo que permite carregar aplicativos personalizados e conversar com o bot do Azure por meio de um link direto para um chat.

Pré-requisitos

Carregar seu aplicativo

Você pode carregar seu aplicativo em uma equipe, chat, reunião ou para uso pessoal, dependendo de como configurou o escopo do aplicativo.

  1. Acesse o cliente do Teams com sua conta de desenvolvimento Microsoft 365.

  2. Selecione Aplicativos>,gerencie seus aplicativos e carregue um aplicativo.

    A captura de tela mostra a opção de carregar um aplicativo destacada em vermelho.

  3. Selecione Fazer o upload de um aplicativo personalizado.

    A captura de tela mostra a opção de carregar um aplicativo personalizado.

  4. Selecione o arquivo .zip do pacote do aplicativo.

  5. Selecione Adicionar.

    Captura de tela da caixa de diálogo do aplicativo personalizado com a opção Adicionar destacada.

  6. Selecione Abrir para abrir o aplicativo no escopo pessoal.

    Como alternativa, você pode pesquisar e selecionar o escopo necessário ou selecionar um canal ou chat na lista e percorrer a caixa de diálogo para selecionar Ir.

    Captura de tela da caixa de diálogo de seleção de escopo com a lista de escopos compartilhados.

Solução de problemas

Se o aplicativo não puder carregar ou encontrar problemas para carregar, marque as seguintes opções:

  1. Certifique-se de seguir todas as instruções para criar o pacote do aplicativo.
  2. Carregue o pacote do aplicativo e valide-o.
  3. Verifique se o manifesto do aplicativo corresponde ao esquema mais recente.

Gerenciar seus aplicativos

Gerenciar seus aplicativos permite que os usuários tenham um local dedicado para gerenciar, atualizar e remover seus aplicativos, permissões e assinaturas no cliente do Teams. Os usuários podem instalar os aplicativos a partir de Gerenciar seus aplicativos.

Acessar seus aplicativos

Para acessar aplicativos por meio de Gerenciar seus aplicativos, siga as etapas:

  1. Acesse Aplicativos e selecione Gerenciar seus aplicativos no Teams para exibir os aplicativos instalados em todos os seus canais ou para uso pessoal em um formato de lista.

    A captura de tela mostra a lista de aplicativos instalados que aparece quando você seleciona gerenciar seus aplicativos.

  2. Selecione a lista suspensa do aplicativo para exibir a lista de escopos em que o aplicativo está instalado.

    A captura de tela mostra a lista de escopos em que o aplicativo está instalado.

  3. Selecione o escopo do aplicativo para ir para o aplicativo no canal ou no modo de exibição pessoal. A lista de escopos consiste apenas em escopo pessoal e escopo de equipes. Os aplicativos instalados no escopo do chat em grupo não são exibidos neste modo de exibição.

O Teams fornece várias maneiras de abrir aplicativos. Para obter mais informações, consulte acessar seus aplicativos no Teams.

Atualize seu aplicativo

Você não precisará carregar seu aplicativo personalizado novamente se fizer alterações de código (elas são refletidas no Teams em tempo real). No entanto, você deverá reinstalar se alterar as configurações do aplicativo. Para obter mais informações, confira Função de um administrador na atualização de aplicativos do Teams.

Quando um aplicativo Teams recebe uma atualização, o usuário deve consentir em atualizar o aplicativo em qualquer contexto, e o aplicativo é atualizado automaticamente em todos os contextos relacionados (chats, canais e reuniões) em que o aplicativo está instalado. O usuário pode atualizar o aplicativo de qualquer contexto.

Se houver uma atualização disponível para seu aplicativo, siga estas etapas para atualizar seu aplicativo da Teams Store:

  1. Vá para o Microsoft Teams.

  2. Selecione Aplicativos>Gerencie seus aplicativos.

    A captura de tela mostra as atualizações disponíveis para aplicativos instalados na opção gerenciar seus aplicativos.

  3. Na guia Aplicativos, marque a opção Atualizar ao lado do aplicativo.

  4. Selecione Atualizar.

    A captura de tela mostra a opção de selecionar atualizar para o aplicativo Teams.

  5. Selecione Atualizar agora.

    A captura de tela mostra a opção de atualizar o aplicativo instalado no Teams.

    O aplicativo é atualizado automaticamente em todos os contextos relacionados (chats, canais e reuniões) em que o aplicativo está instalado.

Remover seu aplicativo

Para remover o aplicativo do Teams, siga as etapas:

  1. Encontre o aplicativo em Gerenciar seus aplicativos.

  2. Selecionar Captura de tela mostra o ícone excluir para remover o aplicativo no Teams. no escopo do aplicativo instalado.

    A captura de tela mostra a opção de remover o aplicativo em um canal destacado em vermelho.

  3. Selecione Remover para remover seu aplicativo.

    A captura de tela mostra a opção para selecionar a opção remover no teams.

Observação

  • Você não pode remover totalmente a atividade do bot pessoal. Se você remover o aplicativo e adicioná-lo novamente, a nova comunicação com o bot acrescentará à conversa anterior com ele.
  • Não é possível migrar seu aplicativo personalizado para a Teams Store. Se você deseja listar seu aplicativo na Teams Store, veja como publicar seu aplicativo na Teams Store.

Próxima etapa

Confira também