Escolha uma configuração de teste e depure seu aplicativo 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 carregar e testar seu pacote de produção antes de enviar seu aplicativo para publicação em nossa Microsoft Teams Store ou distribuição para 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, alguns recursos são permitidos pelo Bot Framework no Bot Emulator que pode 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 em nuvem, requer que todos os serviços acessados estejam disponíveis publicamente usando pontos de extremidade 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 seu aplicativo teams localmente, siga estas etapas:

  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 usar o ngrok em seu projeto com base nos recursos que você está usando, você deve substituir todas as referências de URL em seu código, configuração e arquivo manifest.json para usar esse ponto de extremidade 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. Novamente, como o emulador, este teste não permite que você acesse a funcionalidade específica 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. Você também pode atualizar seu ponto de extremidade de mensagens por meio do Portal do Desenvolvedor para 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 há expectativa de que suas funcionalidades residam no mesmo serviço. Exigimos que todos os domínios sejam acessados de seus aplicativos do Teams listados no validDomains objeto no manifest.json arquivo.

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 sua experiência no Teams, você precisa criar um pacote e carregá-lo no Teams. Para saber mais, confira:

Próxima etapa

Adicione dados de teste ao seu ambiente

Confira também