Tempo de leitura: 4 minutos
Faturas que não são geradas, e-mails de cobrança que não saem, serviços que não suspendem no prazo. Quando isso acontece no WHMCS, o culpado quase sempre é o mesmo: o cron do WHMCS parou de rodar. Ele é o motor de toda a automação, e vale conferir com método antes de mexer em qualquer outra coisa.
Revenda de hospedagem depende de automação funcionando todos os dias, e isso começa com uma instalação bem feita. Se você ainda não tem onde rodar isso, a Licença WHMCS oficial já entrega o servidor pronto.
O que o cron faz no WHMCS
O cron chama um script do WHMCS em intervalos curtos. Esse script cuida de gerar faturas, enviar lembretes de vencimento, suspender e encerrar serviços, aplicar cobranças recorrentes, fechar tickets inativos e outras rotinas diárias. Sem ele, nada disso acontece sozinho.
Passo 1: conferir o Automation Status
No painel administrativo, abra Utilities > System > Automation Status (em português, algo como Utilitários > Sistema > Status da Automação). A tela mostra:
- A data e hora da última execução do cron.
- Quantas tarefas cada rotina executou.
- Avisos, quando a automação não rodou no horário esperado.
Se a última execução tem horas ou dias, o cron parou. Se aparece como recente, mas as tarefas diárias não rodaram, o problema é outro (por exemplo, a hora da rotina diária).
Passo 2: ver como o cron está configurado
No cPanel, abra Trabalhos do Cron (Cron Jobs). O comando padrão do WHMCS tem este formato, rodando a cada 5 minutos:
*/5 * * * * /usr/local/bin/php -q /home/USUARIO/public_html/whmcs/crons/cron.phpConfira:
- O caminho do
phpé válido (descubra comwhich php). - O caminho da pasta
cronsestá correto. Em instalações que moveram essa pasta para fora dopublic_html, o local é definido no arquivoconfiguration.php. - O intervalo é de 5 minutos, que é o recomendado.
Passo 3: rodar o comando na mão
O melhor teste é executar o mesmo comando no terminal, como o mesmo usuário do cron:
/usr/local/bin/php -q /home/USUARIO/public_html/whmcs/crons/cron.php all -vvvO -vvv mostra tudo o que ele faz e os erros na tela. Os erros mais comuns que aparecem aqui:
- ionCube Loader ausente: o PHP de linha de comando precisa do ionCube, e muitas vezes só o PHP do site o tem.
- Versão do PHP incompatível: o PHP do terminal pode ser diferente do PHP do site.
- Permissão negada: o usuário do cron não consegue ler a pasta.
- Erro de conexão com o banco: credenciais do
configuration.phpincorretas.
Passo 4: conferir a versão do PHP
O WHMCS exige uma versão específica de PHP. Rode php -v pelo mesmo caminho do cron e confirme a versão e se o ionCube aparece na lista. Se estiver diferente do site, use no cron o caminho do PHP correto (por exemplo, /opt/cpanel/ea-php82/root/usr/bin/php).
Passo 5: conferir a hora da rotina diária
Em Configuration > System Settings > General Settings, na aba de automação, existe a hora da rotina diária. Se essa hora estiver mal configurada ou o cron só rodar uma vez ao dia, parte das tarefas pode não executar como você espera.
Passo 6: registros de atividade
Veja Utilities > Logs > Activity Log para erros recentes e confira o log de erros do PHP da conta. Muitas vezes, a mensagem exata está lá.
Erros comuns e soluções rápidas
- O cron foi criado pelo usuário errado: recrie o trabalho no cPanel da conta correta.
- Atualizou o PHP do servidor e o cron parou: ajuste o caminho do PHP no comando.
- Servidor com firewall ou bloqueio: confira se o servidor consegue acessar o banco e os gateways.
- A hospedagem tem limite de tempo de execução: o cron do WHMCS pode precisar de mais tempo em bases grandes.
Como evitar o problema
Use um monitoramento que avise quando o cron para. Veja também 10 automações que todo revendedor precisa ativar e PIX no WHMCS.
Automação confiável começa com uma licença oficial
Uma instalação bem feita e com suporte evita horas de diagnóstico. Na Licença WHMCS oficial você conta com licença oficial, instalação com suporte humano via WhatsApp e ticket e preço fixo em reais. Fale com a equipe pelo WhatsApp e escolha o plano ideal para o seu projeto.
