Solucionar problemas da 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, 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 ao seu bot (o bot não funciona em nenhum canal) ou a um determinado canal (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 seu bot.

Test In Web Chat

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

O bot não funciona no Webchat

Pode haver vários motivos pelos quais um bot não funciona. Provavelmente, o aplicativo bot está inoperante 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á inoperante e não pode ser acessado.
  • O bot está falhando.
  • O ponto de extremidade do bot está incorreto.
  • O bot está recebendo as mensagens com êxito, mas não consegue respondê-las.

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 no seu navegador.

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

Se o ponto de extremidade retornar um erro "Este site não pode ser acessado" ou "não é possível acessar esta página", significa que seu bot está desativado e você precisará reimplantá-lo.

O Bot funciona no Webchat, mas não em outros canais

Se o bot funciona conforme o esperado no Webchat mas falha em algum outro canal, os possíveis motivos são:

Problemas de configuração de 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 de modo incorreto ou alterados externamente. Por exemplo, um bot foi configurado com o canal do Facebook para uma página específica e a página foi posteriormente excluída. A solução mais simples é remover o canal e refazer a configuração do canal.

Para obter uma lista de canais com suporte e instruções sobre como configurar cada um, confira a Lista de canais em Conectar um bot a canais.

Comportamento específico de 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 é compatível com Ações (botões), mas é renderizada em um modo específico para canal. Se detectar diferenças em como alguns tipos de mensagem funcionam em canais distintos, confira o artigo de referência de canais.

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

Interrupção de canal

Ocasionalmente, alguns canais podem ter uma interrupção de serviço. Geralmente, essas interrupções não duram muito. No entanto, se você suspeitar de uma interrupção, confira o site ou a mídia social do canal.

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

Informações adicionais

Configura as instruções sobre como depurar um bot e outros artigos sobre depuração nesta seção.