Pular para o conteúdo principal

FAQ e Solução de Problemas

Problemas de Instalação​

A página está em branco após a instalação​

Uma página em branco quase sempre significa um erro PHP que está sendo suprimido silenciosamente.

  1. Abra o arquivo storage/logs/laravel.log em um gerenciador de arquivos (o Gerenciador de Arquivos do seu painel de hospedagem, ou FTP). Olhe as últimas linhas — haverá uma mensagem de erro explicando o que deu errado.
  2. Causas comuns:
    • Extensões PHP ausentes (verifique a página de requisitos)
    • Permissões de arquivo incorretas (consulte a seção de permissões abaixo)
    • Credenciais de banco de dados incorretas no arquivo de configuração

Erro 500 Internal Server Error​

Significa que o servidor encontrou um erro do qual não conseguiu se recuperar.

  1. Verifique storage/logs/laravel.log para a mensagem de erro real.
  2. Verifique o log de erros do seu servidor web — no cPanel, está em Logs → Log de Erros.
  3. Causas mais comuns:
    • Credenciais de banco de dados incorretas
    • O valor APP_KEY está faltando ou é muito curto no arquivo de configuração
    • Uma extensão PHP necessária não está habilitada

O instalador continua me redirecionando para o início​

Isso geralmente significa que o instalador não consegue escrever no disco. O processo de instalação cria um arquivo chamado storage/installed.lock quando termina. Se não conseguir criar esse arquivo, ele pensa que a instalação nunca foi concluída.

Solução: Certifique-se de que a pasta storage/ e tudo dentro dela seja gravável. No gerenciador de arquivos da sua hospedagem, clique com o botão direito na pasta storage e defina as permissões para 755 ou 775.

Falha na conexão com o banco de dados​

A mensagem de erro no instalador dirá "Connection refused" ou "Access denied".

  • Verifique o nome do host do banco de dados, o nome do banco de dados, o nome de usuário e a senha. Tudo isso é definido quando você cria um banco de dados no cPanel.
  • O nome do host do banco de dados para hospedagem cPanel é quase sempre localhost.
  • Certifique-se de que o usuário do banco de dados tem permissões completas no banco de dados.

Erros de permissão (não é possível escrever em storage ou cache)​

LeadHub precisa escrever em determinadas pastas. Se você vir erros sobre não conseguir escrever arquivos:

No gerenciador de arquivos da sua hospedagem, certifique-se de que essas pastas estejam definidas com permissão 755 (alguns hosts precisam de 775):

  • storage/
  • storage/logs/
  • storage/framework/
  • storage/app/
  • bootstrap/cache/

Problemas de E-mail​

E-mails não estão sendo enviados​

  1. Vá em Configurações → E-mail e verifique se todos os campos estão preenchidos corretamente.
  2. Clique em Enviar E-mail de Teste e insira seu próprio endereço de e-mail.
  3. Se o e-mail de teste não chegar, verifique o arquivo storage/logs/laravel.log para qualquer erro SMTP.
  4. Certifique-se de que o cron job está em execução — e-mails passam pela fila de tarefas, que precisa do cron job para processar. Consulte a seção Cron Job abaixo.

E-mails estão indo para spam​

  • A causa mais comum é o endereço "From Email" não corresponder a um domínio autorizado pelo seu provedor SMTP.
  • Adicione registros SPF e DKIM às configurações DNS do seu domínio. Seu provedor de e-mail (SendGrid, Mailgun, etc.) dirá exatamente o que adicionar.
  • Evite usar Gmail pessoal ou endereços de e-mail gratuitos como endereço remetente para e-mail transacional. Use um serviço de envio profissional.

E-mail de teste falha​

  • Verifique suas credenciais SMTP — mesmo um caractere errado causa falha.
  • Para Gmail, você deve usar uma Senha de App, não sua senha regular.
  • A porta 587 pode estar bloqueada em hospedagem compartilhada. Tente a porta 465 com SSL em vez disso.
  • Pergunte ao seu provedor de hospedagem se SMTP de saída é permitido na porta que você está usando.

Problemas com Cron Job​

Automações não estão rodando / Relatórios não estão sendo entregues​

LeadHub usa um cron job para processar todo o trabalho em segundo plano: automações, envio de e-mails, entrega de relatórios e tarefas agendadas.

O comando do cron job é:

php /path/to/your/leadhub/cron.php

Substitua /path/to/your/leadhub/ pelo caminho real no seu servidor.

Para configurar no cPanel:

  1. Faça login no cPanel.
  2. Vá em Cron Jobs.
  3. Defina a frequência como A Cada Minuto (preencha * para todos os cinco campos).
  4. O comando: php /home/yourusername/public_html/cron.php
  5. Clique em Adicionar Novo Cron Job.

Se você não tiver certeza do caminho, verifique com seu provedor de hospedagem, ou veja o caminho completo mostrado no Gerenciador de Arquivos do cPanel quando você navega para a pasta raiz do seu site.

Não há outros comandos para executar. Não tente executar comandos artisan a partir do cron — use apenas cron.php.

Como verificar se o cron job está rodando​

No cPanel, vá em Cron Jobs e veja o cron job que você criou. Se estiver listado lá, está agendado. Para verificar se está realmente executando, você pode adicionar temporariamente >> /tmp/crontest.log 2>&1 ao final do comando, aguardar um minuto e depois verificar o arquivo para saída.

Problemas com Fontes de Leads​

Webhook não está recebendo leads​

  1. Verifique se a URL do webhook que você configurou no serviço externo (Facebook, Typeform, etc.) está exatamente correta, incluindo o token no final.
  2. No LeadHub, vá para as configurações de integração ou fonte de leads e procure um botão "Test" ou "Ping" — use-o para verificar a conexão.
  3. Verifique storage/logs/laravel.log para quaisquer erros de webhook de entrada.
  4. Certifique-se de que seu servidor está acessível pela internet (não atrás de um firewall bloqueando conexões de entrada).

Caixa de entrada IMAP não está sendo verificada​

A verificação IMAP (verificar uma caixa de entrada de e-mail em busca de leads) requer que o cron job esteja em execução. Consulte a seção Cron Job acima. Se o cron job está rodando mas o IMAP ainda não está verificando:

  1. Verifique as configurações de conexão IMAP na configuração de integração.
  2. Certifique-se de que a extensão PHP php-imap está instalada no seu servidor.
  3. Verifique storage/logs/laravel.log para erros de conexão IMAP.

Problemas de Desempenho em Hospedagem Compartilhada​

O aplicativo está lento ou expira​

Hospedagem compartilhada tem recursos limitados. Algumas coisas que você pode fazer:

Aumentar o limite de memória PHP: Adicione esta linha ao arquivo .htaccess na pasta raiz do seu site:

php_value memory_limit 256M

Ou peça ao seu provedor de hospedagem para aumentá-lo nas suas configurações PHP.

Ativar cache: Certifique-se de que seu arquivo de configuração tem CACHE_DRIVER=file ou CACHE_DRIVER=database. Estes funcionam em hospedagem compartilhada sem configuração extra.

Reduzir tamanhos de lote da fila: Se o seu servidor está com dificuldades com importações grandes ou operações em massa, processe lotes menores.

Como Verificar os Logs​

O arquivo de log principal está em:

storage/logs/laravel.log

Você pode visualizá-lo no gerenciador de arquivos da sua hospedagem navegando até ele e clicando para abrir. Olhe a parte inferior do arquivo — é onde os erros mais recentes aparecem.

O arquivo de log pode ficar grande com o tempo. Você pode excluí-lo com segurança (o app cria um novo automaticamente).

Como Limpar o Cache​

Se você vir dados desatualizados ou páginas que não refletem mudanças recentes, limpar o cache pode ajudar.

Faça isso pelo gerenciador de arquivos da sua hospedagem:

  1. Navegue até bootstrap/cache/
  2. Exclua todos os arquivos dentro desta pasta (mas não a pasta em si)
  3. Navegue até storage/framework/cache/data/
  4. Exclua todos os arquivos e subpastas dentro desta pasta

O cache é reconstruído automaticamente no próximo carregamento de página.

Não exclua as próprias pastas — apenas o conteúdo.

Como Executar o Instalador Novamente​

Se você precisar passar pelo assistente de instalação novamente (por exemplo, após mover para um novo banco de dados):

  1. No gerenciador de arquivos da sua hospedagem, navegue até a pasta storage/.
  2. Exclua o arquivo chamado installed.lock.
  3. Visite seu site em um navegador — o instalador iniciará automaticamente.

Isso não exclui seus dados. Apenas permite que o instalador execute novamente. Seu banco de dados e arquivos permanecem intactos.

Erros Comuns no Arquivo de Configuração​

O arquivo de configuração (.env) na pasta raiz do seu site controla muitas configurações. Erros comuns:

  • APP_KEY ausente — deve ser uma string aleatória de 32 caracteres. Se estiver ausente ou errado, o app não iniciará.
  • DB_HOST incorreto — para hospedagem compartilhada, isso é quase sempre localhost. Não use seu nome de domínio.
  • Espaços ao redor de = — o formato é KEY=value sem espaços. KEY = value não funciona.
  • Valores com caracteres especiais sem aspas — se sua senha do banco de dados contém # ou &, envolva todo o valor em aspas duplas: DB_PASSWORD="my#p@ss&word"

Obtendo Ajuda​

Se você não conseguir resolver um problema usando esta documentação:

  1. Verifique o arquivo de log em storage/logs/laravel.log primeiro. A mensagem de erro lá frequentemente diz exatamente o que está errado.
  2. Pesquise nos comentários do CodeCanyon na página do produto LeadHub — muitos problemas comuns foram respondidos lá.
  3. Abra um ticket de suporte no CodeCanyon indo à página do produto LeadHub e clicando em Suporte. Anexe a seção relevante do seu arquivo de log ao fazer isso.

Ao contatar o suporte, sempre inclua:

  • Seu ambiente de hospedagem (hospedagem compartilhada / VPS, qual provedor)
  • A versão PHP que seu servidor executa
  • As últimas linhas de storage/logs/laravel.log