Pular para o conteúdo principal

Solucao de Problemas

Problemas de Instalacao​

"Nao e possivel conectar ao banco de dados"​

  1. Tente 127.0.0.1 em vez de localhost
  2. Verifique as credenciais via phpMyAdmin
  3. Verifique os privilegios do usuario MySQL
  4. No cPanel, o host do banco de dados e sempre localhost

O instalador redireciona para a pagina inicial​

config/database.php ja existe de uma tentativa anterior. Exclua-o e tente novamente.

Login mostra pagina em branco​

Verifique o log de erros do PHP para Fatal error ou Call to undefined function. Mais comum: extensao pdo_mysql ausente.

Mensagens Nao Aparecendo​

Mensagens de webhook nao chegam​

  1. A URL do webhook esta configurada no painel do provedor?
  2. A URL usa HTTPS?
  3. O canal esta ativo (toggle ligado)?
  4. Verifique a tabela webhook_events para entradas failed

Mensagens de email nao aparecem​

  1. O cron job esta em execucao?
  2. A extensao PHP imap esta carregada?
  3. As credenciais IMAP estao corretas?

Atualizacoes em tempo real SSE nao funcionam​

  1. Verifique DevTools do navegador → Rede para a requisicao /sse
  2. Buffering do Nginx? Defina X-Accel-Buffering: no
  3. CDN/Cloudflare? Ative o modo de streaming
  4. max_execution_time do PHP deve ser pelo menos 60 segundos

Falhas de Envio​

Resposta do WhatsApp nao entregue​

  1. O Access Token e valido? Tokens temporarios expiram em ~24 horas
  2. O numero de telefone esta no formato E.164 sem +?
  3. O app Meta ainda esta no modo Development?

Respostas de email nao chegam​

mail() do PHP pode nao estar configurado no VPS. Configure o Postfix ou use uma API de email.

Erros PHP Comuns​

ErroCorrecao
Call to undefined function imap_open()Hospedagem compartilhada: cPanel → Selecionar Versao PHP → habilitar imap. VPS: sudo apt install php-imap
Permission denied: config/database.phpDefina config/ para 755 via Gerenciador de Arquivos ou chmod 755 config/
Maximum execution time exceededDefina max_execution_time = 120 no php.ini

Obtendo Mais Ajuda​

  1. Log de Erros PHP — cPanel: Logs → Log de Erros. VPS: /var/log/apache2/error.log
  2. Log de Eventos de Webhook — inspecione a tabela webhook_events no phpMyAdmin
  3. Saida do Cron — visite sua URL de cron no navegador
  4. Console do Navegador — F12 → Console para erros JavaScript