Revisão técnica: 08/09/2026. O cron do WHMCS executa rotinas que podem gerar faturas, enviar avisos e acionar o provisionamento conforme as configurações. Por isso, sua validação deve considerar os efeitos da automação, além de confirmar que o comando inicia.
Use o comando da própria instalação
Em uma instalação administrada por você, consulte Automation Settings e copie o comando indicado para o ambiente. Não reutilize o caminho antigo admin/cron.php deste tutorial. O local do diretório de cron e o executável PHP dependem da instalação. No WHMCS Cloud, a automação é gerenciada pelo serviço.
Confira o caminho absoluto do PHP de linha de comando e sua compatibilidade com a versão do WHMCS. O PHP usado pelo site e o utilizado pelo cron podem ser diferentes. Verifique também extensões necessárias e permissões de leitura e execução.
Separe frequência e tarefas diárias
A documentação recomenda executar o cron a cada cinco minutos. O horário das tarefas diárias é configurado na automação e não deve ser confundido com limitar o cron a uma execução por dia. No agendador, os cinco campos dessa frequência são:
*/5 * * * *Acrescente o comando exibido na sua instalação. Antes de criar a entrada, procure agendamentos existentes para evitar duplicidade. Documente em qual conta e servidor a tarefa está cadastrada.
Confira resultados e falhas
Acompanhe Automation Status e os registros de atividade. Uma execução recente não prova que todas as tarefas terminaram: confira a rotina que deveria ocorrer e seu resultado. Se houver erro, examine caminho, PHP, permissões e mensagem produzida antes de mudar a frequência.
Mantenha a saída de diagnóstico em local restrito enquanto investiga. Ela pode conter dados operacionais e de clientes. Não publique o log integral em chamados abertos ou fóruns.
Evite testes com efeitos inesperados
Uma execução manual pode processar ações reais. Revise a configuração e siga o procedimento de diagnóstico da versão instalada; não force repetidamente a automação nem exponha o script pela web só para testá-lo. Para mudanças maiores, use uma instalação de testes isolada das credenciais e mensagens de produção.
Referências: System Cron do WHMCS e configuração do agendamento.
