Solucionar problemas de configuração do bot

APLICA-SE A: SDK v4

Um bot pode gerar diferentes tipos de erros, como não conseguir responder, gerar erros ou trabalhar em um canal, mas não em outro. A primeira etapa na solução de problemas de um bot é testá-lo no WebChat. Isso permitirá que você determine se o problema é específico para o bot (o bot não funciona em nenhum canal) ou para um canal específico (o bot funciona em alguns canais, mas não em outros).

Testar no Webchat

  1. Abra o recurso de bot no portal do Azure.
  2. Abra o painel Testar no Webchat.
  3. Envie uma mensagem ao bot.

Testar no WebChat

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

O bot não funciona no WebChat

Pode haver muitos motivos pelos quais um bot não funciona. Provavelmente, o aplicativo de 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 acessado.
  • O bot está falhando.
  • O ponto de extremidade do bot está incorreto.
  • O bot está recebendo suas mensagens com êxito, mas não pode responder.

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

  1. Abra o painel Visão Geral .
  2. Copie o endpoint de mensagens e cole-o no navegador.

Se o endpoint retornar o Erro HTTP 404 ou 405, isso significa que o bot pode ser acessado e responder às mensagens. Para investigar problemas de tempo limite, confira os artigos expira ou falha com erro HTTP 5xx.

Se o endpoint retornar um erro "Este site não pode ser acessado" ou "não pode acessar esta página", isso significa que o bot está fora do ar e você precisa reimplantar.

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

Se o bot funcionar conforme o esperado no WebChat, mas falhar em algum outro canal, os possíveis motivos serão:

Problemas de configuração de canal

É possível que os parâmetros de configuração de 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 com suporte e instruções sobre como configurar cada um deles, consulte a lista Canais em Conectar um bot aos canais.

Comportamento específico do canal

A implementação de alguns recursos pode ser diferente por canal. Por exemplo, nem todos os canais dão suporte a Cartões Adaptáveis. A maioria dos canais dá suporte a Ações (botões), mas eles são renderizados de maneira específica do canal. Se você perceber diferenças em como alguns tipos de mensagem funcionam de forma diferente em canais distintos, consulte o artigo de referência de canais.

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

Interrupção de canal

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

Outra maneira de determinar se um canal tem uma interrupção é criar um bot de teste (como um Bot de Eco simples) e adicionar um canal. Se o bot de teste funcionar 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 nesta seção.

  • Last updated on