Quais CRONs o Mautic precisa

Quais CRONs o Mautic precisa: guia completo de configuração

Os CRONs são o motor silencioso que mantém o Mautic funcionando. Sem eles configurados corretamente, a plataforma fica virtualmente paralisada: emails não são enviados, campanhas não processam, segmentos não atualizam e leads ficam presos em limbo sem avançar no fluxo. Configurar os CRONs do Mautic corretamente é uma das etapas mais críticas — e mais negligenciadas — da instalação.

Neste guia, você vai conhecer todos os CRONs que o Mautic precisa, a frequência recomendada para cada um, como configurá-los no Linux e como verificar se estão funcionando corretamente.

O que é um CRON e por que o Mautic precisa deles

CRON é um agendador de tarefas do Linux que executa comandos em intervalos definidos. O Mautic usa CRONs porque é uma aplicação baseada em filas: em vez de processar cada ação em tempo real (o que consumiria recursos excessivos), ele acumula tarefas em fila e as processa em lotes quando o CRON correspondente roda.

Isso significa que há sempre uma defasagem entre o momento em que um evento ocorre (um lead preenche um formulário) e o momento em que a próxima ação é executada (o email de boas-vindas é enviado). Essa defasagem é igual ao intervalo do CRON — por isso frequências de 5 minutos são recomendadas para os CRONs mais críticos.

Os CRONs essenciais do Mautic

1. mautic:campaigns:trigger — O mais crítico

\*/5 \* \* \* \* php /var/www/mautic/bin/console mautic:campaigns:trigger –no-interaction

Função: Processa as ações pendentes nas campanhas — envia emails de campanha, adiciona tags, ajusta pontuações e executa todas as ações programadas no fluxo de automação. Sem este CRON, os leads entram na campanha mas nunca recebem nenhuma ação.

Frequência recomendada: A cada 5 minutos.

2. mautic:emails:send — Despacha a fila de emails

\*/5 \* \* \* \* php /var/www/mautic/bin/console mautic:emails:send –no-interaction

Função: Envia os emails que estão na fila de despacho. O campaigns:trigger coloca os emails na fila; o emails:send é quem realmente faz o envio para o SMTP. Ambos precisam estar funcionando para os emails chegarem ao destinatário.

Frequência recomendada: A cada 5 minutos.

3. mautic:campaigns:rebuild — Atualiza membros das campanhas

\*/30 \* \* \* \* php /var/www/mautic/bin/console mautic:campaigns:rebuild –no-interaction

Função: Verifica os segmentos e formulários de fonte das campanhas e adiciona/remove contatos conforme as mudanças. Um lead que entra no segmento de fonte de uma campanha só começa a percorrer o fluxo após este CRON rodar e incluí-lo na campanha.

Frequência recomendada: A cada 15 a 30 minutos.

4. mautic:segments:update — Atualiza membros dos segmentos

\*/30 \* \* \* \* php /var/www/mautic/bin/console mautic:segments:update –no-interaction

Função: Recalcula quais contatos pertencem a cada segmento dinâmico, aplicando todos os filtros configurados. Um contato que atingiu a pontuação para entrar em um segmento VIP só aparece nesse segmento após este CRON rodar.

Frequência recomendada: A cada 15 a 30 minutos.

5. mautic:emails:fetch — Processa bounces e respostas

\*/10 \* \* \* \* php /var/www/mautic/bin/console mautic:emails:fetch –no-interaction

Função: Conecta à caixa de email configurada para bounce handling e processa as devoluções (bounces hard e soft). Essencial para manter a higiene da base e proteger a reputação do domínio de envio.

Frequência recomendada: A cada 10 a 15 minutos.

6. mautic:contacts:deduplicate — Remove duplicatas

0 3 \* \* \* php /var/www/mautic/bin/console mautic:contacts:deduplicate –no-interaction

Função: Identifica e mescla contatos duplicados (mesmo email) na base. Evita que o mesmo lead receba emails múltiplos e que o pipeline tenha informações fragmentadas.

Frequência recomendada: Uma vez por dia (3h da madrugada).

7. mautic:maintenance:cleanup — Limpa dados antigos

0 2 \* \* 0 php /var/www/mautic/bin/console mautic:maintenance:cleanup –days-old=90 –no-interaction

Função: Remove logs de eventos antigos, entradas de rastreamento expiradas e dados temporários. Sem limpeza periódica, o banco de dados do Mautic cresce indefinidamente e degrada a performance.

Frequência recomendada: Uma vez por semana (domingo às 2h).

Como configurar os CRONs no Linux

# Abrir o crontab do usuário www-data (que roda o Apache/Nginx)  
sudo crontab -e -u www-data

\# Cole as linhas abaixo e salve:  
\*/5 \* \* \* \* /usr/bin/php /var/www/mautic/bin/console mautic:campaigns:trigger –no-interaction >> /dev/null 2>&1  
\*/5 \* \* \* \* /usr/bin/php /var/www/mautic/bin/console mautic:emails:send –no-interaction >> /dev/null 2>&1  
\*/30 \* \* \* \* /usr/bin/php /var/www/mautic/bin/console mautic:campaigns:rebuild –no-interaction >> /dev/null 2>&1  
\*/30 \* \* \* \* /usr/bin/php /var/www/mautic/bin/console mautic:segments:update –no-interaction >> /dev/null 2>&1  
\*/10 \* \* \* \* /usr/bin/php /var/www/mautic/bin/console mautic:emails:fetch –no-interaction >> /dev/null 2>&1  
0 3 \* \* \* /usr/bin/php /var/www/mautic/bin/console mautic:contacts:deduplicate –no-interaction >> /dev/null 2>&1  
0 2 \* \* 0 /usr/bin/php /var/www/mautic/bin/console mautic:maintenance:cleanup –days-old=90 –no-interaction >> /dev/null 2>&1

Use o caminho completo do PHP no crontab
O crontab não herda as variáveis de ambiente do usuário, então o comando php pode não ser encontrado se não usar o caminho completo. Descubra o caminho com which php — geralmente /usr/bin/php ou /usr/bin/php8.1. Da mesma forma, use o caminho completo para o console do Mautic (/var/www/mautic/bin/console). A flag –no-interaction evita que o console fique aguardando input e >> /dev/null 2>&1 suprime a saída para não gerar emails de notificação do cron daemon.

Como verificar se os CRONs estão funcionando

Após configurar, verifique se os CRONs estão executando corretamente:

• Log do sistema: sudo grep CRON /var/log/syslog | grep mautic | tail -20 — mostra execuções recentes.
• Log do Mautic: tail -f /var/www/mautic/var/logs/mautic\_prod.log — mostra atividade em tempo real.
• Painel Admin: Em Admin → System → Log você verifica o log diretamente pela interface web.
• Teste prático: Adicione um contato de teste ao segmento de fonte de uma campanha e aguarde 10 minutos — o email de boas-vindas deve chegar.

Perguntas frequentes sobre CRONs do Mautic

Posso usar o agendador de tarefas do painel de hospedagem (cPanel) em vez do crontab do Linux?

Sim, o cPanel tem um agendador de tarefas que pode ser usado para configurar os CRONs do Mautic. A sintaxe do comando é a mesma; a diferença é que você insere pela interface web do cPanel em vez do terminal. Verifique qual usuário executa os scripts na sua hospedagem (geralmente o usuário do cPanel) e ajuste as permissões se necessário. Em VPS com acesso root, o crontab via terminal é a opção mais confiável.

Por que o Mautic processa as ações com atraso mesmo com o CRON configurado?

O atraso esperado é igual ao intervalo do CRON. Com CRONs a cada 5 minutos, o atraso máximo é de 5 minutos. Se o atraso for maior, pode haver: (1) CRON configurado com intervalo maior que o esperado — verifique com crontab -l -u www-data; (2) CRON rodando mas o comando demora muito para completar — o próximo ciclo começa antes do anterior terminar; (3) Limite de memória PHP atingido — verifique o log de erros do PHP. Para volumes muito altos, considere aumentar a frequência e paralelizar os processos com o parâmetro –batch-limit.

O Mautic tem algum painel para monitorar o status dos CRONs?

O Mautic não tem um dashboard nativo de monitoramento de CRONs. Para monitoramento mais sofisticado, use ferramentas externas como Cronitor ou Healthchecks.io — elas recebem um ping de cada CRON quando ele completa com sucesso e alertam por email ou Slack quando um CRON deixa de rodar no intervalo esperado. A integração é simples: adicione uma chamada curl ao final de cada linha de CRON com a URL de ping da ferramenta.

Preciso dos CRONs se usar o Mautic Cloud (hospedado)?

Não. O Mautic Cloud (mautic.com) gerencia toda a infraestrutura, incluindo os CRONs. Essa é uma das vantagens da versão hospedada — você não precisa se preocupar com configuração de servidor. Os CRONs são necessários apenas na versão self-hosted, onde você gerencia o servidor.

Conclusão

Os CRONs são o que faz o Mautic “respirar” — sem eles, a plataforma é um shell vazio. Configure os sete CRONs apresentados neste guia imediatamente após a instalação, verifique se estão executando corretamente e monitore os logs periodicamente para garantir que tudo continua funcionando após atualizações e manutenções no servidor.

Para mais conteúdos técnicos sobre o Mautic, explore os artigos de Mautic no atraca.com.br ou consulte a documentação oficial de CRONs do Mautic.

Perguntas frequentes sobre CRONs do Mautic (FAQ)

Quais CRONs são obrigatórios no Mautic?

Os três essenciais são: mautic:segments:update (atualiza segmentos), mautic:campaigns:trigger (executa ações de campanha) e mautic:emails:send (processa fila de envio de emails).

Com que frequência devo executar os CRONs?

Recomenda-se a cada 1-2 minutos para segments:update e campaigns:trigger, e a cada 1-5 minutos para emails:send. Em servidores com recursos limitados, intervalos de 5 minutos são aceitáveis.

O que acontece se os CRONs pararem de funcionar?

Emails ficam na fila sem serem enviados, segmentos não se atualizam com novos contatos e campanhas não avançam. É essencial monitorar os CRONs com alertas.

Como verificar se os CRONs estão funcionando?

Verifique o crontab do servidor (crontab -l), cheque os logs em app/logs e observe se segmentos e campanhas estão sendo processados regularmente.

Posso executar CRONs manualmente?

Sim. Acesse o terminal e execute php /caminho/mautic/bin/console seguido do comando desejado. Útil para debug e para processar filas acumuladas após uma parada.