Solução de Problemas
Se algo não está funcionando, siga esta ordem:
- Identifique o sintoma na lista abaixo e abra a página correspondente.
- Siga os passos na ordem em que aparecem.
- Se o problema continuar, reúna as informações pedidas no final da página (logs, prints, resultado de comandos) e procure o grupo de suporte.
Dica
Dica geral: muitos problemas são causados por falta de espaço no disco, DNS incorreto ou containers parados. Se não sabe por onde começar, veja Sistema não abre ou parou de funcionar.
1️⃣ WhatsApp e Conexões
| Problema | Guia recomendado |
|---|---|
| Conexão caiu na API Oficial | A conexão caiu (API Oficial) |
| WhatsApp desconectou (QR Code) | O WhatsApp desconectou (QR Code) |
| Mensagens não chegam ou envio falha | Mensagens atrasadas ou falhando |
2️⃣ O Sistema e Servidor
| Problema | Guia recomendado |
|---|---|
| O sistema não abre / tela em branco | O sistema não carrega |
| O sistema está lento ou travando | O sistema está lento |
| Erro de site não seguro (cadeado vermelho) | Aviso de site não seguro |
| Servidor lotado / Arquivos não chegam | Meu armazenamento está cheio |
| Página em branco ou botões que não funcionam | Como verificar erros no Console do Navegador (Google Chrome) |
🔑 Acesso e Licença
| Problema | Onde resolver |
|---|---|
| Erro de licença ao acessar o sistema | Erro de licença |
🛠️ Servidor e Banco de Dados
| Problema | Onde resolver |
|---|---|
| Banco de dados sobrecarregado / muitas conexões | PgBouncer (banco de dados sobrecarregado) |
| Portas bloqueadas / sistema sem acesso externo | Como verificar e reiniciar o Firewall (UFW) no Linux |
📚 Não encontrou o seu problema?
Alguns problemas têm solução em outras seções da documentação:
- Problemas com webhooks, integrações ou ausência de resposta em integrações: seção Integrações.
- Problemas com chatbot, automações ou campanhas: seção Funcionalidades.
- Conexão de canais (API Oficial, Telegram, SMS, Instagram, Facebook, TikTok): seção Canais Disponíveis.
🆘 Quando procurar o suporte
Procure o suporte quando:
- Você seguiu os passos da página e o problema continua;
- O erro envolve dados importantes ou todos os canais ao mesmo tempo;
- O sistema não abre após uma atualização e você não tem snapshot/backup.
Ao entrar em contato, informe: o que estava fazendo, mensagens de erro, prints e os logs do sistema (veja Acessando Logs).