QR Code Expirado
QR Code Expirado
Descrição do Problema
O QR Code para conectar ao WhatsApp expira antes de você conseguir escanear. Mensagens como:
QR Code expired. Please restart to generate a new one.
Timeout waiting for QR scan
Session expired before authentication
Possíveis Causas
- Demora para escanear - QR Code tem validade de ~60 segundos
- Problemas de rede - Conexão lenta impedindo autenticação
- WhatsApp no celular sem internet - Celular offline
- Câmera com problema - QR Code não está sendo lido corretamente
- Versão antiga do WhatsApp - App desatualizado no celular
Soluções
1. Gerar Novo QR Code Rapidamente
# Reiniciar gateway para novo QR
clawdbot gateway restart
# Ou parar e iniciar
clawdbot gateway stop
clawdbot gateway start
2. Aumentar Timeout do QR Code
# No arquivo de configuração
whatsapp:
qr_timeout: 120 # 2 minutos
auto_reconnect: true
3. Usar QR Code no Terminal
# Exibir QR Code como ASCII no terminal
clawdbot gateway start --qr-terminal
# Isso permite escanear diretamente do terminal
# sem precisar abrir navegador
4. Verificar Conexão do Celular
- Abra o WhatsApp no celular
- Envie uma mensagem para qualquer contato
- Se funcionar, o celular está online
- Tente escanear o QR Code novamente
5. Limpar Cache e Tentar Novamente
# Limpar sessão antiga
rm -rf ~/.clawdbot/whatsapp-session/
# Limpar cache do navegador se usar Web
# Ctrl+Shift+Delete no navegador
# Reiniciar gateway
clawdbot gateway restart
6. Verificar Versão do WhatsApp
No celular:
- Vá na App Store / Play Store
- Procure por WhatsApp
- Atualize se houver versão nova
Dicas para Escanear Mais Rápido
- Prepare o celular antes - Abra a câmera de QR do WhatsApp
- Boa iluminação - Certifique-se que a tela está visível
- Distância correta - Nem muito perto nem muito longe
- Tela limpa - Limpe a tela do celular e monitor
Problemas Relacionados
Prevenção
- Configure reconexão automática
- Salve credenciais para não precisar escanear sempre
- Mantenha o celular sempre conectado à internet