1QR Code não conecta na primeira tentativa
Ao escanear o QR Code, a conexão pode falhar silenciosamente. Clique no botão "Atualizar QR Code", aguarde cerca de 3 segundos para o novo código aparecer e tente escanear novamente.
Em casos raros pode ser necessário repetir o processo 5 vezes ou mais até conectar. É um comportamento esporádico do WhatsApp Web — apenas insista.
2Limite de 4 dispositivos conectados no WhatsApp atingido
O WhatsApp permite no máximo 4 dispositivos vinculados por conta (fora o celular principal). Se você já estiver no limite, o QR Code do WhatsBot não vai conectar nunca, por mais que você tente.
3Windows Defender SmartScreen bloqueia o windows_start.bat
Ao executar o .bat pela primeira vez, o Windows pode mostrar a tela azul "O Windows protegeu o computador". Como o arquivo não é assinado digitalmente, o SmartScreen bloqueia por padrão.
4Antivírus removendo ou bloqueando o bin/gowa.exe
O gowa.exe é um binário Go que frequentemente é marcado como falso-positivo por antivírus (Avast, AVG, Kaspersky, Bitdefender, Defender). Se aparecer o erro [ERRO] bin\gowa.exe nao encontrado! mesmo após extrair o ZIP, é quase certeza que o antivírus colocou em quarentena.
.bat novamente.5Porta 8080 já em uso por outro programa
O WhatsBot sobe o painel web na porta 8080. Se você tiver outro app usando essa porta (Jenkins, Tomcat, XAMPP, Docker Desktop, Spring Boot, etc.), o navegador vai abrir mas mostrar a interface do outro programa, ou o uvicorn vai falhar ao iniciar.
netstat -ano | findstr :8080 no Prompt de Comando.6Falha ao baixar o Python 3.12 automaticamente
Na primeira execução, o .bat baixa o instalador do Python direto do site oficial via PowerShell. Se você estiver em rede corporativa com proxy, firewall agressivo ou sem internet no momento, a etapa falha com [ERRO] Falha ao baixar o Python.
.bat novamente.7Instalar dentro de pasta protegida ou sincronizada (OneDrive, Program Files, Área de Trabalho do OneDrive)
Pastas como C:\Program Files, C:\Windows exigem privilégios de administrador para escrita — a criação da venv e o pip install vão falhar.
Pastas sincronizadas pelo OneDrive (incluindo Área de Trabalho e Documentos se estiverem com backup ativo) podem causar lentidão extrema, corrupção da venv ou conflitos de lock no SQLite (whatsbot.db-wal).
C:\WhatsBot ou D:\WhatsBot.8pip install falha com erro de SSL ou timeout
Se sua conexão for instável, estiver atrás de proxy corporativo ou tiver problemas de certificado, o pip install -r requirements.txt pode travar ou falhar com erros tipo SSL: CERTIFICATE_VERIFY_FAILED / ReadTimeoutError.
.bat (o pip retoma de onde parou), ou em rede corporativa peça ao TI para liberar pypi.org e files.pythonhosted.org.9PowerShell com Execution Policy restritiva
O .bat usa comandos powershell -Command para baixar o Python e matar processos. Em alguns ambientes corporativos a política de execução está como Restricted, e os comandos falham silenciosamente.
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, depois execute o .bat novamente.10Caminho da instalação com acentos, espaços ou caracteres especiais
Pastas como C:\Usuários\João\Área de Trabalho\WhatsBot podem causar falha na criação da venv ou no carregamento de DLLs do Python no Windows.
C:\WhatsBot.11Python instalado mas corrompido (instalação anterior incompleta)
Se já existia um Python 3.12 instalado mas faltando módulos básicos (caso comum após interrupção de instalação ou desinstalação parcial), aparece a mensagem [!] Python encontrado mas com instalacao corrompida. Reinstalando.... O .bat tenta resolver sozinho desinstalando e reinstalando.
.bat de novo.12Após restart do PC, o GOWA não reconecta sozinho
Depois de reiniciar o Windows, o WhatsBot precisa ser iniciado manualmente — não há serviço de inicialização automática.
windows_start.bat e ele restaura a sessão do WhatsApp anterior (não precisa escanear o QR Code de novo, a menos que tenha passado muito tempo desconectado).