Partilhar via

Troubleshoot bot configuration issues (Resolver problemas de configuração de bot)

  • Artigo

APLICA-SE A: SDK v4

Um bot pode gerar diferentes tipos de erros, como não ser capaz de responder, lançar erros ou trabalhar em um canal, mas não em outro. O primeiro passo na solução de problemas de um bot é testá-lo no Web Chat. Isso permitirá que você determine se o problema é específico do seu bot (bot não funciona em nenhum canal) ou de um canal específico (bot funciona em alguns canais, mas não em outros).

Teste no Chat Web

  1. Abra seu recurso de bot no portal do Azure.
  2. Abra o painel Testar no Chat da Web.
  3. Envie uma mensagem ao seu bot.

Test In Web Chat

Se o bot não responder com a saída esperada, vá para Bot não funciona no Web Chat. Caso contrário, vá para Bot funciona no Web Chat, mas não em outros canais.

Bot não funciona no Web Chat

Pode haver muitas razões pelas quais um bot não funciona. Muito provavelmente, o aplicativo bot está inativo e não pode receber mensagens, ou o bot recebe as mensagens, mas não responde. Aqui estão algumas das possíveis causas:

  • O bot está inativo e não pode ser alcançado.
  • O bot está falhando.
  • O ponto de extremidade do bot está incorreto.
  • O bot está recebendo suas mensagens com sucesso, mas não consegue responder.

Para ver se o bot está em execução:

  1. Abra o painel Visão geral .
  2. Copie o ponto de extremidade de mensagens e cole-o em seu navegador.

Se o ponto de extremidade retornar o erro HTTP 404 ou 405, isso significa que o bot está acessível e o bot é capaz de responder às mensagens. Para investigar problemas de tempo limite, consulte Tempo limite ou falha com um artigo de erro HTTP 5xx.

Se o ponto final devolver o erro “This site can't be reached" (“Não é possível aceder a este site”) ou "can't reach this page" (“não é possível aceder a esta página”), significa que o bot está inativo e que tem de o implementar.

Bot funciona no Web Chat, mas não em outros canais

Se o bot funcionar conforme esperado no chat na Web, mas falhar noutro canal, os possíveis motivos são:

Problemas de configuração do canal

É possível que os parâmetros de configuração do canal, como o nome de usuário e a senha do bot, tenham sido definidos incorretamente ou tenham sido alterados externamente. Por exemplo, um bot foi configurado com o canal do Facebook para uma página específica e a página foi excluída posteriormente. A solução mais simples é remover o canal e refazer a configuração do canal novamente.

Para obter uma lista de canais suportados e instruções sobre como configurar cada um, consulte a lista Canais em Conectar um bot a canais.

Comportamento específico do canal

A implementação de alguns recursos pode variar de acordo com o canal. Por exemplo, nem todos os canais suportam Adaptive Cards. A maioria dos canais suporta Ações (botões), mas eles são renderizados de uma maneira específica do canal. Se você vir diferenças em como alguns tipos de mensagem funcionam em canais diferentes, consulte o artigo de referência de canais.

Abaixo estão os links que podem ajudar com canais individuais:

Interrupção do canal

Ocasionalmente, alguns canais podem ter uma interrupção do serviço. Normalmente, essas interrupções não duram muito tempo. No entanto, se suspeitar de uma interrupção, consulte o site do canal ou as redes sociais.

Outra maneira de determinar se um canal tem uma interrupção é criar um bot de teste (como um Echo Bot simples) e adicionar um canal. Se o bot de teste funciona com alguns canais, mas não com outros, o problema não está no bot de produção.

Informações adicionais

Veja como depurar um bot e os outros artigos de depuração nessa seção.