<h2>Quais CRONs o Mautic precisa: guia completo de configuração</h2>

<p>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.</p>
<p>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.</p>

<div class=”resumo-rapido”>
<strong>CRONs do Mautic em 30 segundos (resumo rápido)</strong>
<ul>
<li><strong>Críticos (a cada 5 min):</strong> campaigns:trigger e emails:send — sem eles, nada funciona.</li>
<li><strong>Importantes (a cada 15–30 min):</strong> campaigns:rebuild, segments:update, import.</li>
<li><strong>Manutenção (diário/semanal):</strong> deduplicate, maintenance:cleanup, social:monitoring.</li>
<li><strong>Configuração:</strong> Use <code>crontab -e -u www-data</code> no servidor Linux.</li>
<li><strong>Verificação:</strong> Logs em <code>var/logs/mautic_prod.log</code> e Admin → System → Log.</li>
</ul>
</div>

<h2>O que é um CRON e por que o Mautic precisa deles</h2>
<p>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.</p>
<p>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.</p>

<h2>Os CRONs essenciais do Mautic</h2>

<h3>1. mautic:campaigns:trigger — O mais crítico</h3>
<pre><code>*/5 * * * * php /var/www/mautic/bin/console mautic:campaigns:trigger –no-interaction</code></pre>
<p><strong>Função:</strong> 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.</p>
<p><strong>Frequência recomendada:</strong> A cada 5 minutos.</p>

<h3>2. mautic:emails:send — Despacha a fila de emails</h3>
<pre><code>*/5 * * * * php /var/www/mautic/bin/console mautic:emails:send –no-interaction</code></pre>
<p><strong>Função:</strong> 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.</p>
<p><strong>Frequência recomendada:</strong> A cada 5 minutos.</p>

<h3>3. mautic:campaigns:rebuild — Atualiza membros das campanhas</h3>
<pre><code>*/30 * * * * php /var/www/mautic/bin/console mautic:campaigns:rebuild –no-interaction</code></pre>
<p><strong>Função:</strong> 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.</p>
<p><strong>Frequência recomendada:</strong> A cada 15 a 30 minutos.</p>

<h3>4. mautic:segments:update — Atualiza membros dos segmentos</h3>
<pre><code>*/30 * * * * php /var/www/mautic/bin/console mautic:segments:update –no-interaction</code></pre>
<p><strong>Função:</strong> 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.</p>
<p><strong>Frequência recomendada:</strong> A cada 15 a 30 minutos.</p>

<h3>5. mautic:emails:fetch — Processa bounces e respostas</h3>
<pre><code>*/10 * * * * php /var/www/mautic/bin/console mautic:emails:fetch –no-interaction</code></pre>
<p><strong>Função:</strong> 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.</p>
<p><strong>Frequência recomendada:</strong> A cada 10 a 15 minutos.</p>

<h3>6. mautic:contacts:deduplicate — Remove duplicatas</h3>
<pre><code>0 3 * * * php /var/www/mautic/bin/console mautic:contacts:deduplicate –no-interaction</code></pre>
<p><strong>Função:</strong> 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.</p>
<p><strong>Frequência recomendada:</strong> Uma vez por dia (3h da madrugada).</p>

<h3>7. mautic:maintenance:cleanup — Limpa dados antigos</h3>
<pre><code>0 2 * * 0 php /var/www/mautic/bin/console mautic:maintenance:cleanup –days-old=90 –no-interaction</code></pre>
<p><strong>Função:</strong> 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.</p>
<p><strong>Frequência recomendada:</strong> Uma vez por semana (domingo às 2h).</p>

<table>
<thead>
<tr>
<th>CRON</th>
<th>Frequência</th>
<th>Criticidade</th>
<th>Sem este CRON</th>
</tr>
</thead>
<tbody>
<tr>
<td>campaigns:trigger</td>
<td>*/5</td>
<td>Crítico</td>
<td>Campanhas não processam</td>
</tr>
<tr>
<td>emails:send</td>
<td>*/5</td>
<td>Crítico</td>
<td>Emails não são enviados</td>
</tr>
<tr>
<td>campaigns:rebuild</td>
<td>*/30</td>
<td>Alto</td>
<td>Novos leads não entram nas campanhas</td>
</tr>
<tr>
<td>segments:update</td>
<td>*/30</td>
<td>Alto</td>
<td>Segmentos dinâmicos não atualizam</td>
</tr>
<tr>
<td>emails:fetch</td>
<td>*/10</td>
<td>Médio</td>
<td>Bounces não são processados</td>
</tr>
<tr>
<td>contacts:deduplicate</td>
<td>Diário</td>
<td>Médio</td>
<td>Base acumula duplicatas</td>
</tr>
<tr>
<td>maintenance:cleanup</td>
<td>Semanal</td>
<td>Baixo</td>
<td>Banco de dados cresce sem controle</td>
</tr>
</tbody>
</table>

<h2>Como configurar os CRONs no Linux</h2>
<pre><code># 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</code></pre>

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

<h2>Como verificar se os CRONs estão funcionando</h2>
<p>Após configurar, verifique se os CRONs estão executando corretamente:</p>
<ul>
<li><strong>Log do sistema:</strong> <code>sudo grep CRON /var/log/syslog | grep mautic | tail -20</code> — mostra execuções recentes.</li>
<li><strong>Log do Mautic:</strong> <code>tail -f /var/www/mautic/var/logs/mautic_prod.log</code> — mostra atividade em tempo real.</li>
<li><strong>Painel Admin:</strong> Em Admin → System → Log você verifica o log diretamente pela interface web.</li>
<li><strong>Teste prático:</strong> Adicione um contato de teste ao segmento de fonte de uma campanha e aguarde 10 minutos — o email de boas-vindas deve chegar.</li>
</ul>

<h2>Perguntas frequentes sobre CRONs do Mautic</h2>

<div class=”faq-item”>
<h3>Posso usar o agendador de tarefas do painel de hospedagem (cPanel) em vez do crontab do Linux?</h3>
<p>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.</p>
</div>

<div class=”faq-item”>
<h3>Por que o Mautic processa as ações com atraso mesmo com o CRON configurado?</h3>
<p>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 <code>crontab -l -u www-data</code>; (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 <code>–batch-limit</code>.</p>
</div>

<div class=”faq-item”>
<h3>O Mautic tem algum painel para monitorar o status dos CRONs?</h3>
<p>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.</p>
</div>

<div class=”faq-item”>
<h3>Preciso dos CRONs se usar o Mautic Cloud (hospedado)?</h3>
<p>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.</p>
</div>

<h2>Conclusão</h2>
<p>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.</p>
<p>Para mais conteúdos técnicos sobre o Mautic, explore os artigos de <a href=”/category/mautic/”>Mautic no atraca.com.br</a> ou consulte a <a href=”https://docs.mautic.org/en/setup/cron-jobs” target=”_blank” rel=”noopener noreferrer”>documentação oficial de CRONs do Mautic</a>.</p>

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.