29/12/2025

Novo Módulo – GuardMail

Patch Notes – Módulo GuardMail (Monitor de E-mails)

Descrição da atualização

Disponibilizamos o módulo GuardMail, desenvolvido para monitorar a fila de e-mails do Magento e identificar possíveis problemas no envio, como falhas de CRON ou do servidor SMTP.

O módulo acompanha os e-mails pendentes na fila de disparo e, quando detecta e-mails travados por tempo excessivo, realiza a expiração controlada desses registros, evitando que a fila fique bloqueada e impedindo o envio de novos e-mails.

Além disso, o GuardMail conta com um sistema de alertas e um Modo Seguro, que ajuda a evitar a perda excessiva de e-mails em casos de falhas mais graves.

O que o módulo faz

• Monitora continuamente a fila de e-mails do Magento;

• Verifica quanto tempo o primeiro e-mail está pendente na fila;

• Expira automaticamente e-mails que ultrapassam o tempo máximo configurado;

• Mantém um contador diário de e-mails expirados;

• Envia um e-mail de alerta quando o limite diário de expirações é atingido;

• Pode ativar automaticamente um Modo Seguro, suspendendo novas expirações até o próximo dia;

• Registra logs detalhados para facilitar o diagnóstico de problemas;

• Tudo configurável diretamente pelo painel administrativo.

Onde fica

Sistema → Configuração → Vendas → E-mail de Venda → Guard Mail

Configurações disponíveis (resumo)

Habilitar
Ativa ou desativa o módulo.

Tempo Máximo em Fila antes de Expirar (segundos)
Define quanto tempo o primeiro e-mail pendente pode permanecer na fila sem ser processado.
Configurar em segundos, exemplo: 2400 = 40 minutos.

Limite Diário de Expirações para Alerta
Define quantos e-mails podem ser expirados no mesmo dia antes do módulo disparar um alerta (e-mail).
Exemplo: 3 = ao expirar 3 e-mails no dia, o alerta é enviado.

Modo Seguro após Alerta
Quando ativado, o módulo para de expirar e-mails no restante do dia após atingir o limite diário de expirações.
Essa opção ajuda a evitar a perda excessiva de e-mails em casos de falha no CRON ou SMTP.

Destinatários do Alerta
E-mails que receberão a notificação quando o limite diário de expiração for atingido.
Obs.: é enviado apenas 1 e-mail por dia.

Logs do Módulo
Ativa ou desativa os logs detalhados do módulo.

Principais vantagens

• Evita filas travadas: impede que um e-mail com problema bloqueie todos os envios seguintes;

• Diagnóstico mais rápido: alerta automaticamente quando algo foge do padrão;

• Proteção contra falhas graves: o Modo Seguro reduz o risco de perda massiva de e-mails;

• Flexível para diferentes lojas: funciona bem tanto em lojas com pouco fluxo quanto em lojas com alto volume de pedidos;

• Tudo pelo painel: sem necessidade de editar código para ajustes operacionais.

Observações importantes

• O alerta enviado pode indicar:

  • um falso positivo (ex.: e-mails inválidos ou específicos travados), ou

  • um problema real no CRON ou no servidor SMTP.

• Ao receber o alerta, recomenda-se verificar:

  1. A fila de e-mails pendentes;

  2. Os logs do GuardMail;

  3. O funcionamento do CRON;

  4. A configuração e o status do SMTP.

• O valor do limite diário deve ser ajustado conforme o perfil da loja:

  • Lojas com baixo volume: valores menores (ex.: 1 ou 2);

  • Lojas com alto volume: valores um pouco maiores.

• O Modo Seguro é altamente recomendado para ambientes críticos.