[Extensão] Como monitorar os erros dos fluxos do seu chatbot com a extensão Logs e monitoramento de erros

1. Introdução

2. Funcionalidades

3. Instalação e configuração

4. Como analisar os erros monitorados

5. Como configurar alertas por e-mail

6. Logs por contato

7. Suporte

Descrição breve: Monitore os erros dos fluxos do seu chatbot na Blip, veja quais contatos foram impactados e receba alertas por e-mail para corrigir falhas antes que elas afetem mais usuários.

Introdução

A extensão Logs e monitoramento de erros registra as falhas que acontecem durante a execução dos fluxos do seu chatbot na Blip. Você acompanha cada erro em um painel único, com a mensagem técnica, o bloco do fluxo onde a falha ocorreu e a lista de contatos afetados. Assim você identifica falhas silenciosas e age antes que o problema se repita com outros usuários.

Por exemplo, se um bloco de requisição HTTP passa a falhar porque uma API ficou fora do ar, o erro aparece no painel agrupado com todas as ocorrências dos últimos 7 dias. Você vê quantos contatos foram impactados, abre os detalhes técnicos da falha e recebe um e-mail automático assim que ela acontece.

Funcionalidades

• Painel com os erros dos fluxos agrupados por tipo, mostrando a quantidade de ocorrências e um gráfico dos últimos 7 dias.

• Detalhes técnicos de cada erro: contato impactado, bot de origem, bloco do fluxo, tipo de ação, entrada do usuário e tempo de execução.

• Exportação em CSV dos contatos impactados por um erro.

• Alertas por e-mail quando um erro ocorre no fluxo, com opção de enviar apenas na primeira ocorrência.

• Alertas por e-mail baseados em eventos rastreados, filtrados por categoria.

• Aba Logs por contato para consultar os traces de um contato específico.

• Monitoramento automático de todos os bots conectados quando a extensão é instalada em um Roteador.

Suportada nos seguintes canais: todos os canais disponíveis na plataforma Blip.

Instalação e configuração

1. Ative a extensão Logs e monitoramento de erros na Blip Store e instale no bot que você quer monitorar. Se a sua operação usa um Roteador, instale a extensão no Roteador para monitorar automaticamente todos os bots conectados a ele.

2. No painel do bot, abra o menu de opções (ícone de três pontos) para localizar a extensão instalada.

3. Clique na extensão para abrir o painel de monitoramento. A partir desse momento a extensão passa a registrar os erros dos fluxos automaticamente, sem configuração adicional.

Atenção: os erros e os logs ficam disponíveis por 7 dias. Após esse período, os registros mais antigos são removidos automaticamente e deixam de aparecer no painel.

Como analisar os erros monitorados

O painel lista os erros agrupados por tipo. Cada item mostra a mensagem da falha, um gráfico com a distribuição das ocorrências nos últimos 7 dias, o total de ocorrências no período e o horário da última vez em que o erro aconteceu. Use o botão Atualizar para recarregar a lista.

Clique em um erro para expandir os detalhes da última ocorrência. Nesse painel você consulta o contato impactado, a data, o bot de origem, o bloco do fluxo onde a falha ocorreu, o tempo de execução, o tipo de ação e a entrada enviada pelo usuário. O ícone de depuração abre a configuração completa da ação em formato JSON, útil para entender a causa técnica do erro.

Analise cada erro observando em qual bloco ele acontece, se é recorrente, quantos contatos foram impactados e se alguma alteração recente no fluxo pode ter causado a falha. Com esses detalhes você identifica se o problema vem de uma condição mal configurada no Builder, de uma requisição HTTP com falha ou de uma variável que não foi preenchida.

No painel expandido, clique em Baixar CSV com usuários impactados para exportar a lista de contatos afetados pelo erro. Use o arquivo para cruzar os dados com outras informações ou disparar uma ação de recuperação com esses contatos. Para remover um erro já tratado, clique em Apagar erro.

Como configurar alertas por e-mail

1. No painel de monitoramento, clique em Gerenciar alertas.

2. Preencha o campo Email para receber alertas com o endereço que vai receber as notificações.

3. Ative Habilitar alertas de erro para receber um e-mail sempre que um erro ocorrer no chatbot. Marque Enviar somente quando o erro aparecer pela primeira vez para evitar e-mails repetidos de um mesmo erro.

4. Ative Habilitar alertas baseados em eventos para ser avisado sobre eventos específicos. Selecione as Categorias de evento que deseja monitorar e, se quiser, marque a opção para enviar somente na primeira ocorrência.

5. Clique em Salvar. Os alertas passam a valer para os próximos erros e eventos registrados.

Logs por contato

Na aba Logs por contato, você consulta o histórico de um contato específico. Busque pelo id do contato ou selecione um dos últimos contatos que conversaram com o bot para ver os traces registrados durante o atendimento. Isso ajuda a investigar um problema relatado por um usuário sem precisar procurar o erro no painel geral.

Suporte

Em caso de dúvidas durante a instalação ou a análise dos erros, fale com o time de suporte da Wiv pelo e-mail support@wiv.com.br.

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃