Escolher uma configuração de teste e depurar a sua aplicação Teams

  • Artigo

Os aplicativos do Microsoft Teams contêm um ou mais recursos e as maneiras de executá-los ou até mesmo hospedá-los são diferentes. Para depuração, use uma das seguintes maneiras:

  • Puramente local: para bots, você pode testar sua experiência no Bot Emulator. Para outros conteúdos, você pode executar localmente em seu navegador e endereçar o conteúdo por meio de http://localhost.
  • Hospedado localmente no Teams: envolve executar o aplicativo localmente no software de encapsulamento e criar um pacote para carregar no Teams. Isso permite que você execute e depure facilmente seu aplicativo no cliente do Teams.
  • Hospedado na nuvem no Teams: simula verdadeiramente o suporte de nível de produção para um aplicativo do Teams. Envolve o upload de sua solução para seu servidor ou provedor de nuvem acessível externamente e criação de um pacote para carregar no Teams.

Execute a experiência em seu próprio computador para testes puramente locais ou locais do Teams. Ao fazer isso, você pode compilar e executar em seu ambiente de desenvolvimento integrado e aproveitar ao máximo as técnicas, como pontos de interrupção e depuração de etapas.

Observação

Para depuração e teste em escala de produção, recomendamos que você siga as diretrizes de sua própria empresa para garantir que possa dar suporte a testes, preparação e implantação por meio de seus próprios processos.

Use vários manifestos e pacotes para manter a separação entre os serviços de produção e desenvolvimento. Por exemplo, você pode optar por registrar bots de desenvolvimento e produção separados e criar pacotes apropriados para carregá-los em seu ambiente de teste. Também recomendamos que carregue e teste o seu pacote de produção antes de submeter a sua aplicação para publicação na nossa Microsoft Teams Store ou distribuição aos clientes.

Puramente local

Observação

A execução do bot localmente não dá acesso à funcionalidade do aplicativo Teams ou às funções de bot específicas do Teams, como chamadas de lista e outras funcionalidades específicas do canal. Além disso, algumas capacidades são permitidas pelo Bot Framework no Bot Emulator que podem não funcionar ao executar no Teams.

Seu bot pode ser executado no emulador de bot. Isso permite que você teste parte da lógica principal do bot, veja um layout aproximado de mensagens e execute testes simples. Seguem os passos:

  1. Execute o código localmente.
  2. Inicie o emulador de bot e defina a URL:
    • Node.js: http://localhost:3978/api/messages
    • .NET/C#: http://localhost:3979/api/messages
  3. Deixe a ID do aplicativo Microsoft e a senha do aplicativo Microsoft em branco para corresponder às variáveis ​​de ambiente padrão.

Hospedado localmente

O Teams é um produto totalmente baseado na cloud, requer que todos os serviços a que acede estejam disponíveis publicamente através de pontos finais HTTPS. Portanto, para permitir que seu aplicativo funcione no Teams, você precisa publicar o código na nuvem de sua escolha ou tornar nossa instância local em execução acessível externamente. Podemos fazer o último com software de tunelamento.

Embora você possa usar qualquer ferramenta de sua escolha, usamos e recomendamos o ngrok, que cria um URL endereçável externamente para uma porta que você abre localmente em seu computador.

Para configurar o ngrok em preparação para executar a sua aplicação teams localmente, siga estes passos:

  1. Acesse o diretório onde você tem o ngrok.exe instalado em um aplicativo de terminal. Você pode querer adicioná-lo como uma variável de caminho para evitar esta etapa.
  2. Execute, por exemplo, ngrok http 3978 --host-header=localhost:3978 ou substitua o número da porta conforme necessário. Isso inicia o ngrok para listar na porta que você especificar. Em troca, ele fornece uma URL endereçável externamente válida enquanto o ngrok estiver em execução.

Observação

Se você parar e reiniciar o ngrok, o URL será alterado.

Para utilizar o ngrok no seu projeto com base nas capacidades que está a utilizar, tem de substituir todas as referências de URL no seu código, configuração e manifest.json ficheiro para utilizar este ponto final de URL.

Para bots registrados no Microsoft Bot Framework, atualize o ponto de extremidade de mensagens do bot para usar esse novo ponto de extremidade ngrok. Por exemplo, https://2d1224fb.ngrok.io/api/messages. Você pode validar se o ngrok está funcionando testando a resposta do bot na janela de chat de teste do portal do Bot Framework. Mais uma vez, tal como o emulador, este teste não lhe permite aceder a funcionalidades específicas do Teams.

Observação

Para atualizar o ponto de extremidade de mensagens para um bot, você deve usar o Bot Framework. Selecione seu bot em sua lista de bots no Bot Framework. Você não precisa migrar seu bot para o Microsoft Azure. Também pode atualizar o ponto final de mensagens através do Portal do Programador do Teams.

Hospedado na nuvem

Você pode usar qualquer serviço endereçável externamente para hospedar seu código de desenvolvimento e produção e seus pontos de externamente HTTPS. Não existe nenhuma expectativa de que as suas capacidades residem no mesmo serviço. Exigimos que todos os domínios sejam acedidos a partir das suas aplicações do Teams listadas no validDomains objeto no manifest.json ficheiro.

Observação

Para garantir um ambiente seguro, seja explícito sobre o domínio e os subdomínios exatos aos quais você faz referência e esses domínios devem estar sob seu controle. Por exemplo, *.azurewebsites.net não é recomendado, mas contoso.azurewebsites.net é recomendado.

Carregar e executar a experiência

Para carregar e executar a sua experiência no Teams, tem de criar um pacote e carregá-lo para o Teams. Para saber mais, confira:

Próxima etapa

Adicione dados de teste ao seu ambiente

Confira também