Erros Comuns
Este guia apresenta os erros mais frequentes que os usuários encontram na plataforma WhatsBotGPT e fornece soluções passo a passo para resolvê-los rapidamente.
Erros de Conexão do WhatsApp
Erro: "QR Code expirado"
Sintomas:
- O QR code na tela de conexão mostra a mensagem "Expirado"
- Não é possível escanear o código com o WhatsApp
Solução:
- Clique no botão Atualizar QR Code para gerar um novo código
- Escaneie o novo código imediatamente
- Certifique-se de que seu telefone está com internet estável
- Se o problema persistir, limpe o cache do navegador e tente novamente
Erro: "Telefone não conectado"
Sintomas:
- Mensagem de erro "Telefone não conectado" no painel
- Assistentes não conseguem enviar ou receber mensagens
Solução:
- Verifique se o WhatsApp está aberto no seu telefone
- Confirme se o telefone está conectado à internet
- No painel do WhatsBotGPT, vá para Configurações > Conexões
- Clique em Reconectar WhatsApp
- Siga as instruções para reconectar seu dispositivo
Erro: "Múltiplas sessões detectadas"
Sintomas:
- Mensagem de erro indicando que o WhatsApp está conectado em múltiplos lugares
- Desconexão automática do WhatsBotGPT
Solução:
- Abra o WhatsApp no seu telefone
- Vá para Configurações > WhatsApp Web/Desktop
- Clique em Desconectar de todos os dispositivos
- Volte ao WhatsBotGPT e inicie uma nova conexão
- Escaneie o QR code com seu telefone
Erros de Assistentes
Erro: "Assistente não responde"
Sintomas:
- O assistente recebe mensagens, mas não envia respostas
- Status do assistente aparece como "Ativo", mas não há interação
Solução:
- Verifique se o assistente está realmente ativado (botão verde)
- Confirme se a conexão do WhatsApp está funcionando
- Vá para Assistentes > selecione o assistente > Configurações
- Verifique se as instruções não contêm contradições
- Reinicie o assistente: desative e ative novamente
- Para uma solução mais detalhada, consulte Meu bot não está respondendo
Erro: "Respostas inadequadas ou fora de contexto"
Sintomas:
- O assistente responde, mas com informações irrelevantes
- Respostas não seguem as instruções configuradas
Solução:
- Simplifique as instruções, removendo ambiguidades
- Adicione exemplos concretos de como o assistente deve responder
- Se estiver usando base de conhecimento, verifique se os documentos são relevantes
- Teste o assistente com perguntas simples para verificar o comportamento básico
Erro: "Limite de tokens excedido"
Sintomas:
- Mensagem de erro sobre limite de tokens
- Assistente para de responder em conversas longas
Solução:
- Considere fazer upgrade do seu plano para obter limites maiores
Erros de Faturamento e Conta
Erro: "Pagamento recusado"
Sintomas:
- Notificação de falha no pagamento
- Impossibilidade de renovar assinatura
Solução:
- Tente adicionar um método de pagamento alternativo
- Se o problema persistir, entre em contato com seu banco para verificar se há restrições
Erro: "Conta suspensa"
Sintomas:
- Impossibilidade de acessar recursos da plataforma
- Mensagem indicando suspensão da conta
Solução:
- Entre em contato com o suporte através do e-mail [email protected]
Erro: "Limite de uso atingido"
Sintomas:
- Notificações sobre limite de uso
- Impossibilidade de criar novos assistentes ou conexões
Solução:
- Para necessidades temporárias, verifique se há opções de expansão pontual de limites
Erros de Importação e Exportação
Erro: "Falha na importação de contatos"
Sintomas:
- Mensagem de erro durante o processo de importação
- Contatos não aparecem na lista após tentativa de importação
Solução:
- Para mais detalhes, consulte Importando Contatos
Erro: "Falha na exportação de relatórios"
Sintomas:
- Mensagem de erro ao tentar exportar relatórios
- Download do arquivo não inicia ou arquivo corrompido
Solução:
- Reduza o período de dados selecionado
- Selecione menos métricas para exportação
- Tente um formato de arquivo diferente (tente CSV se PDF falhar)
- Verifique a conexão de internet
- Limpe o cache do navegador e tente novamente
Erros de Integrações
Erro: "Falha na conexão com serviço externo"
Sintomas:
- Mensagens de erro ao tentar usar integrações
- Funcionalidades integradas não respondem
Solução:
- Verifique se o serviço externo está funcionando normalmente
- Confirme se as permissões concedidas são suficientes
- Para mais detalhes, consulte Configurando Serviços e Integrações
Erro: "API Key inválida"
Sintomas:
- Mensagem específica sobre API Key inválida
- Integrações param de funcionar repentinamente
Solução:
- Teste a integração para confirmar que está funcionando
- Verifique se há limites de uso na API do serviço externo
Erros de Performance
Erro: "Lentidão no painel de controle"
Sintomas:
- Interface responde lentamente
- Carregamento demorado de páginas e listas
Solução:
- Verifique sua conexão de internet
Erro: "Assistente com tempo de resposta lento"
Sintomas:
- Assistente demora muito para responder
- Clientes reclamam de espera prolongada
Solução:
- Simplifique as instruções do assistente
- Reduza o tamanho da base de conhecimento
- Verifique se há integrações que podem estar causando atrasos
- Otimize o fluxo de conversa para reduzir a necessidade de processamento complexo
- Considere dividir um assistente complexo em múltiplos assistentes com funções específicas
Erros de Segurança e Acesso
Erro: "Não foi possível fazer login"
Sintomas:
- Mensagem de erro na tela de login
- Impossibilidade de acessar a conta mesmo com credenciais corretas
Solução:
- Se o problema persistir, entre em contato com o suporte
Erro: "Acesso negado a recurso"
Sintomas:
- Mensagem "Acesso negado" ou "Permissão insuficiente"
- Impossibilidade de acessar certas áreas ou funcionalidades
Solução:
- Se você é administrador, verifique se sua assinatura inclui o recurso
- Para usuários adicionais, peça ao administrador para revisar suas permissões
- Tente sair e entrar novamente na plataforma
Erros de Compatibilidade
Erro: "Navegador não suportado"
Sintomas:
- Mensagem indicando que o navegador não é suportado
- Funcionalidades que não carregam corretamente
Solução:
- Desative extensões que possam interferir no funcionamento da plataforma
Erro: "Incompatibilidade com dispositivo móvel"
Sintomas:
- Layout quebrado em dispositivos móveis
- Funcionalidades que não respondem corretamente em smartphones ou tablets
Solução:
- Use a versão desktop para funcionalidades administrativas complexas
- Para acesso móvel, use dispositivos com telas maiores (tablets em vez de smartphones)
- Gire a tela para modo paisagem para melhor visualização
- Considere usar o aplicativo móvel WhatsBotGPT (se disponível para seu dispositivo)
Como Reportar Erros Não Listados
Se você encontrar um erro que não está listado neste guia:
- Anote a mensagem de erro exata
- Registre os passos que levaram ao erro
- Faça capturas de tela se possível
- Anote data e hora da ocorrência
- E-mail: [email protected]
- Chat ao vivo: Disponível no canto inferior direito do painel
- WhatsApp: +55 11 97123-9515
- Sua conta (e-mail cadastrado)
- Navegador e sistema operacional utilizados
- Descrição detalhada do problema
- Capturas de tela ou gravações de tela, se possível
Nossa equipe de suporte está disponível de segunda a sexta, das 9h às 18h, e responderá sua solicitação o mais rápido possível.
Prevenindo Erros Futuros
Para minimizar a ocorrência de erros:
- Mantenha tudo atualizado: Navegadores, sistema operacional e aplicativo do WhatsApp
- Faça backup regularmente: Exporte seus dados importantes periodicamente
- Monitore o uso: Fique atento aos limites do seu plano
- Siga as melhores práticas: Consulte nossa documentação para implementações recomendadas
- Treine sua equipe: Certifique-se de que todos os usuários sabem utilizar a plataforma corretamente
Para problemas específicos com a conexão do WhatsApp, consulte nosso guia detalhado sobre Problemas de Conexão com WhatsApp.