Testar e depurar o bot do Microsoft Teams

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

Teste carregando para o Teams

A forma mais abrangente de testar o seu bot é criar um pacote de aplicações e carregá-lo para o Teams. Carregar a aplicação para o Teams é o único método para testar todas as funcionalidades disponíveis para o seu bot, em todos os âmbitos.

Existem dois métodos para carregar a aplicação. 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 voltar a carregar a aplicação, deve eliminar o bot antes de carregar o pacote de aplicações alterado.

Depurar seu bot localmente

Se você estiver hospedando seu bot localmente durante o desenvolvimento, precisará usar um serviço de tunelamento como o ngrok para testar seu bot. Depois de baixar e instalar o ngrok, execute o comando abaixo para iniciar o serviço de encapsulamento. Talvez seja necessário adicionar ngrok ao seu caminho.

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

Use o ponto de extremidade https fornecido pelo ngrok em seu manifesto de aplicativo. Se você fechar a janela de comando e reiniciar, obterá uma nova URL e precisará atualizar o endereço de ponto de extremidade do bot para usá-la também.

Testar o bot sem carregar para o Teams

Por vezes, é necessário testar o bot sem o instalar como uma aplicação 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 amplitude de funcionalidades do Teams que possa ter adicionado ao seu bot. Se precisar testar completamente o bot, siga as instruções para testar por upload.

Usar o emulador de bot

O Bot Framework Emulator é um aplicativo de desktop que permite aos desenvolvedores de bots testar e depurar seus bots, local ou remotamente. Usando o emulador, você pode conversar com seu bot e inspecionar as mensagens que seu bot envia e recebe. Isso pode ser útil para verificar se seu bot está disponível e responder, no entanto, o emulador não permitirá que você teste nenhuma funcionalidade específica do Teams que você adicionou ao seu bot, nem as respostas do seu bot serão uma representação visual precisa de como eles são renderizados no Teams. Se você precisar testar qualquer uma dessas coisas, não é melhor carregar seu bot.

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

Bloquear um bot no chat pessoal

Os utilizadores podem optar por bloquear o envio de mensagens de chat pessoais ao seu bot. Eles podem alternar isso clicando com o botão direito do mouse em seu bot no canal de bate-papo e escolhendo Bloquear conversa do bot. Isso significa que seus bots continuarão a enviar mensagens, mas o usuário não receberá essas mensagens.

Remover um bot de uma equipa

Os utilizadores podem eliminar o bot ao selecionar o ícone de caixote do lixo na lista de bots na respetiva vista de equipas. Observe que isso apenas remove o bot do uso dessa equipe, os usuários individuais podem interagir em contexto pessoal.

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

Desativar um bot no Teams

Para impedir que o seu bot receba mensagens, aceda ao seu Dashboard do Bot e edite o canal do Microsoft Teams. Desmarque a opção Ativar no Microsoft Teams . Desativar um bot no Teams impede que os utilizadores interajam com o bot, mas este continuará a ser detetável e os utilizadores poderão adicioná-lo às equipas.

Eliminar um bot do Teams

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

Removendo seu bot do AppSource

Se quiser remover o bot da aplicação Teams na AppSource (anteriormente Loja Office), tem de remover o bot do manifesto da aplicação e submeter novamente a aplicação para validação. Para mais informações, consulte Publicar a sua aplicação Microsoft Teams no AppSource.