Erros Comuns no Mautic 4: Identificação e Correções Avançadas

Introdução
O Mautic é uma plataforma poderosa de automação de marketing, mas sua flexibilidade também pode levar a desafios técnicos. Esta documentação visa listar alguns problemas comuns que podem ser resolvidos por usuários com conhecimento avançado em servidores, bancos de dados e configurações do Mautic.

IMPORTANTE: Se você não tem familiaridade com linha de comando, configuração de servidores ou MySQL, recomendamos buscar suporte especializado para evitar problemas maiores na plataforma.

Erro de Permissões no Diretório Cache

Problema: O Mautic pode apresentar lentidão ou falhar ao carregar se houver problemas com as permissões do diretório de cache.

Solução:

• Acesse o servidor via SSH.
• Execute os seguintes comandos:

  rm -rf var/cache/*

  chown -R www-data:www-data .

  chmod -R 755 .

• Limpe o cache com o comando:

  php bin/console cache:clear

Problemas com Cron Jobs

Problema: Contatos e campanhas não são atualizados corretamente.

Solução:

• Verifique se os cron jobs estão configurados corretamente no painel de controle do servidor.
• Certifique-se de que os seguintes jobs estão ativos:

  php7.4 /caminho/do/mautic/bin/console mautic:segments:update

  php /caminho/do/mautic/bin/console mautic:campaigns:update

  php /caminho/do/mautic/bin/console mautic:campaigns:trigger

• Execute os comandos manualmente via SSH para testar a execução.

Problema com Envio de Emails

Problema: Emails não estão sendo enviados ou aparecem na fila sem processamento.

Solução:

• Verifique as configurações de SMTP em Configurações > Configurações de Email.
• Teste a senha do email com o Ultramail.
• Verifique logs de erro em Configurações > Informações do Sistema > Log.
• Se a fila de envio estiver ativa, processe os emails manualmente via SSH:

  php7.4 bin/console mautic:emails:send

Erro de Banco de Dados ou Tabelas Corrompidas

Problema: O Mautic não carrega ou apresenta erros relacionados ao banco de dados.

ATENÇÃO: Antes de executar esses procedimentos, faça backup do banco de dados.

Solução:

• Acesse o MySQL via SSH e execute um check nas tabelas:

  mysql -u usuario -p

  use nome_do_banco;

  CHECK TABLE campanha, leads;

• Para reparar tabelas corrompidas, execute:

  REPAIR TABLE campanha, leads;

• Otimize as tabelas para melhorar a performance:

  OPTIMIZE TABLE campanha, leads;

Emojis Causando Erros em Emails

Problema: Alguns emojis podem causar erros na entrega de emails.

Solução:

• Remova emojis dos emails de teste e identifique quais causam o problema.
• Utilize apenas emojis suportados por UTF-8.
• Se precisar manter emojis, altere a collation do banco de dados:

  ALTER DATABASE banco_mautic CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Excedentes de Espaço em Disco Web/MySQL

Problema: O Mautic gera registros que se acumulam indevidamente, aumentando o banco de dados e ultrapassando o limite contratado.

Solução:

• Acesse o banco de dados do Mautic via PHPMyAdmin.
• Via SSH, execute os seguintes comandos, um por vez, ajustando para o prefixo correto das tabelas:

  use nome_do_banco;

  update prefixo_email_stats set tokens = NULL, open_details = NULL, last_opened = NULL where date_sent < (NOW() - INTERVAL 25 DAY);

  delete from prefixo_audit_log where date_added < (NOW() - INTERVAL 30 DAY);

  delete from prefixo_campaign_lead_event_log where date_triggered < (NOW() - INTERVAL 30 DAY);

  OPTIMIZE TABLE prefixo_email_stats;

Erro no log: Unable to load dynamic library

Problema: Biblioteca imagick não instalada no servidor.

Solução: Solicite via Helpdesk que a biblioteca imagick seja incluída no servidor.

Erro no log: Cannot send message without a sender address

Problema: O arquivo de configuração do Mautic está com um parâmetro NULL.

Solução:

• Acesse o servidor via FTP (pode utilizar o FileZilla).
• Localize e edite o arquivo local.php, encontrado em:

  pasta-do-mautic/app/config/

• Altere o parâmetro em ‘mailer_mailjet_sandbox_default_mail’ de NULL para o email de disparo do Mautic.

Erro no log: Name or service not known

Problema: Host de conexão do banco de dados incorreto.

Solução:

• Acesse o painel de controle do Mautic e localize o host correto do banco de dados.
• Via FTP, edite o arquivo local.php:

  pasta-do-mautic/app/config/

• Altere a linha 4 em ‘db_host’ para o host correto do banco de dados.

Erro ao Clonar Emails do Mautic

Problema: Alguns emails do Mautic não possuem um idioma definido.

Solução: Acesse o email a ser clonado e defina um idioma.

Fila de Envio Travada

Problema: Limite de espaço atingido, com isso a fila de envio fica corrompida.

ATENÇÃO: Antes de executar esses procedimentos, faça backup seguindo as instruções recomendadas.

Solução:

• Acesse o servidor via SSH.
• Localize o diretório de fila com o comando:

  cd pasta-do-mautic/var/spool

• Confira a fila atual com o comando:

  ls

• Zere a fila do Mautic com:

  ls | xargs rm -

• Clone os emails e dispare-os novamente.

Conclusão

Esses são alguns dos problemas comuns enfrentados por usuários do Mautic que podem ser resolvidos por aqueles com conhecimento avançado. Se as soluções acima não resolverem seu problema, é recomendável abrir um Helpdesk para sua ocorrência.

Para mais informações, acesse a documentação oficial do Mautic.