Testar e depurar seu bot do Microsoft Teams

Importante

Este artigo baseia-se no SDK v3 do Bot Framework. Se estiver à procura da versão atual da documentação 4.6 ou posterior do SDK, consulte a secção bots de conversação .

Ao testar o bot, tem de ter em consideração o(s) contexto(s) em que pretende que o bot seja executado e qualquer funcionalidade que tenha adicionado ao bot que necessite de dados específicos do Microsoft Teams. Certifique-se de que o método que escolheu para testar o bot está alinhado com a respetiva funcionalidade.

Testar carregando no Teams

A maneira mais abrangente de testar seu bot é criando um pacote de aplicativos e carregando-o no Teams. Carregar a aplicação para o Teams é o único método para testar todas as funcionalidades disponíveis para o bot, em todos os âmbitos.

Há dois métodos para carregar seu aplicativo. Pode utilizar o Portal do Programador para o Teams ou pode criar manualmente um pacote de aplicações e carregar a sua aplicação. Se precisar de alterar o manifesto e recarregar a aplicação, deve eliminar o bot antes de carregar o pacote de aplicações alterado.

Depurar seu bot localmente

Se estiver a alojar o bot localmente durante o desenvolvimento, terá de utilizar um serviço de túnel como o ngrok para testar o bot. Depois de baixar e instalar o ngrok, execute o comando abaixo para iniciar o serviço de túnel. Talvez seja necessário adicionar o ngrok ao caminho.

ngrok http <port> --host-header=localhost:<port>

Use o ponto de extremidade https fornecido pelo ngrok no manifesto do aplicativo. Se fechar a janela de comandos e reiniciar, obterá um novo URL e terá de atualizar o endereço do ponto final do bot para utilizá-lo também.

Testando seu bot sem carregar no Teams

Ocasionalmente, é necessário testar seu bot sem instalá-lo como um aplicativo no Teams. Testar o bot sem o instalar como uma aplicação pode ser útil para garantir que o bot está disponível e a responder. No entanto, não lhe permitirá testar toda a gama de funcionalidades do Teams que possa ter adicionado ao bot. Se você precisar testar o bot completamente, siga as instruções para testar carregando.

Usar o Bot Emulator

O Bot Framework Emulator é um aplicativo da área de trabalho que permite aos desenvolvedores de bot testar e depurar seus bots, localmente ou remotamente. Usando o emulador, você pode conversar com seu bot e inspecionar as mensagens que seu bot envia e recebe. Isto pode ser útil para verificar se o bot está disponível e a responder. No entanto, o emulador não lhe permitirá testar qualquer funcionalidade específica do Teams que tenha adicionado ao bot, nem as respostas do bot serão uma representação visual precisa da forma como são compostas no Teams. Se você precisar testar qualquer uma dessas coisas, não é melhor carregar o bot.

Instruções completas sobre o Bot Framework Emulator podem ser encontradas aqui.

Bloqueando um bot no chat pessoal

Observe que os usuários podem optar por impedir que seu bot envie mensagens de chat pessoais. Eles podem alternar isso clicando com o botão direito do mouse no bot no canal de chat e escolhendo Bloquear conversas com bot. Isso significa que seus bots continuarão a enviar mensagens, mas o usuário não receberá essas mensagens.

Removendo um bot de uma equipe

Os usuários podem excluir o bot escolhendo o ícone de lixeira na lista de bots no modo de exibição de equipes. Observe que isso apenas remove o bot do uso dessa equipe, os usuários individuais podem interagir no contexto pessoal.

Os bots no contexto pessoal não podem ser desativados ou removidos por um utilizador, a não ser remover completamente o bot do Teams.

Desabilitando um bot no Teams

Para interromper o recebimento de mensagens pelo bot, acesse o Painel de Bot e edite o canal do Microsoft Teams. Desmarque a opção Habilitar no Microsoft Teams. Desativar um bot no Teams impede que os utilizadores interajam com o bot, mas continuará a ser detetável e os utilizadores podem adicioná-lo às equipas.

Excluindo um bot do Teams

Para remover completamente o bot do Teams, acesse o Painel de Bot e edite o canal do Microsoft Teams. Escolha o botão Excluir na parte inferior. Eliminar um bot do Teams impede que os utilizadores descubram, adicionem ou interajam com o bot. Eliminar um bot do Teams não remove o bot das instâncias do Teams de outros utilizadores, embora também deixe de funcionar para eles.

Removendo seu bot do AppSource

Se você quiser remover o bot do aplicativo Teams no AppSource (antes chamado de Office Store), deverá remover o bot do manifesto do aplicativo e reenviar seu aplicativo para validação. Para saber mais, confira Publicar seu aplicativo do Microsoft Teams no AppSource.