Solucionar problemas da configuração de bot
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
- Abra o recurso de bot no portal do Azure.
- Abra o painel Testar no Webchat.
- Envie uma mensagem ao seu bot.
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:
- Abra o painel Visão geral.
- 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:
- Adicionar bots aos aplicativos do Microsoft Teams
- Facebook: introdução à plataforma do Messenger
- Skype para Desenvolvedores
- Slack: habilitar as interações com os bots
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.