Ir para o conteúdo
Promovaweb

E-mails e entregabilidade no Mautic

Um e-mail enviado sem retorno não diz se o contato abriu, clicou ou saiu da lista. O Mautic personaliza cada mensagem com os campos da ficha, entrega pela fila e pelo provedor configurado na instância e registra as aberturas, os cliques, os descadastros e os bounces devolvidos pelo provedor.

Ficha e sumário da página

Referência técnica
Mautic 7.2.2
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. E-mail de modelo e e-mail de segmento
  2. Da campanha ao provedor de envio
  3. Abertura e clique
  4. Descadastro e central de preferências
  5. Bounces e o que pesa na entrega

E-mail de modelo e e-mail de segmento

O Mautic tem dois tipos de e-mail, com comportamentos diferentes no envio. O tipo escolhido na criação define quantas vezes o mesmo contato pode receber a mensagem e por qual caminho ela sai.

E-mail de modelo

  • Transacional por padrão.
  • Sai pelas campanhas, pelas ações de formulário e pelos gatilhos de pontos.
  • O mesmo contato pode receber a mensagem mais de uma vez.
  • Serve para boas-vindas, confirmação de cadastro e cada etapa de uma campanha.

E-mail de segmento

  • Marketing por padrão.
  • Vai para os contatos dos segmentos escolhidos, como uma lista de envio.
  • Cada contato recebe uma vez só.
  • Sai pelo comando mautic:broadcasts:send no cron, na data agendada.

Os dois usam o mesmo construtor e os mesmos tokens. O token {contactfield=firstname|amigo} coloca o primeiro nome do contato e usa a palavra depois da barra quando o campo está vazio. Outros tokens montam o rodapé da mensagem, como {unsubscribe_url} para o descadastro, {webview_url} para a versão no navegador e {tracking_pixel} para a imagem que registra a abertura.

O e-mail de segmento aceita teste A/B. O público de teste corresponde a 10% dos contatos no padrão, dividido igualmente entre as variantes ativas. O prazo padrão é de 24 horas. Depois desse intervalo, o comando mautic:email:sendwinner seleciona a variante vencedora e encaminha o envio ao restante pelo comando de broadcast. Você escolhe a métrica usada na comparação, como a taxa de cliques.

Da campanha ao provedor de envio

O envio passa por uma fila quando a instância está configurada para isso. Nesse modo, o Mautic grava a mensagem num transporte de fila durante a execução da campanha. Um worker lê essa fila e envia, com o comando messenger:consume email. Se o processo for iniciado pelo cron, a documentação orienta usar --memory-limit, --limit ou --time-limit para encerrá-lo depois de um teto de memória, de mensagens ou de tempo. Um worker mantido por um supervisor pode continuar em execução para consumir as próximas mensagens.

  1. Campanha

    mautic:campaigns:trigger

    O cron executa a ação Send Email do contato.

  2. Fila

    MAUTIC_MESSENGER_DSN_EMAIL

    A mensagem entra no transporte de fila de e-mails.

  3. Worker

    messenger:consume email

    O container mautic_worker lê a fila e envia.

  4. Provedor

    Amazon SES, SendGrid, Mailjet

    O serviço transmite a mensagem ao servidor de destino.

  5. Retorno

    /mailer/callback

    O webhook do provedor avisa o Mautic sobre bounces.

O caminho de um e-mail de campanha na stack de estudo: a campanha grava a mensagem na fila, o worker consome a fila, o provedor envia e o webhook do provedor devolve o resultado ao Mautic. Os nomes vêm da documentação 7.2 e do README da imagem oficial.

Na imagem oficial do Docker, o worker é o container com o papel mautic_worker. A variável DOCKER_MAUTIC_WORKERS_CONSUME_EMAIL define quantos processos consomem a fila de e-mails, com 2 no padrão. Os nomes das variáveis do transporte de fila estão na referência de variáveis de ambiente do Mautic.

Existe ainda uma segunda fila, para os limites de frequência. Quando um contato atinge o limite de mensagens definido na ficha dele ou na configuração geral, os e-mails de campanha e de segmento vão para essa fila e saem mais tarde pelo comando mautic:messages:send. As mensagens de prioridade alta ficam no topo da fila do dia. Cada mensagem tem um número máximo de tentativas. A mensagem que passa desse número não é enviada, mesmo pendente.

Abertura e clique

A abertura depende de uma imagem. Com o rastreamento ligado, o Mautic insere um pixel na mensagem e registra a abertura quando esse arquivo é carregado. Alguns programas não carregam imagens. Outros carregam todas antes de entregar a mensagem ao contato. Por isso o total pode omitir leituras ou incluir aberturas automáticas. Você não consegue concluir, só pelo pixel, que o contato leu a mensagem.

O rastreamento de cliques usa um redirecionamento pelo Mautic antes de abrir o destino original. A aba Click Counts mostra os cliques por link. Um link que não deve passar por esse caminho recebe o atributo data-mautic-disable-tracking="true". O clique e a abertura registrados entram no histórico do contato e podem acionar eventos de espera nas campanhas. O endereço público do Mautic precisa estar acessível para o redirecionamento funcionar.

Descadastro e central de preferências

O token {unsubscribe_url} aponta para a central de preferências quando ela está ativa. Sem ela, aponta para a tela de descadastro. Com a central ativa, o token {dnc_url} oferece a saída de todas as mensagens de marketing. Já o {resubscribe_url} refaz a inscrição, o que a documentação indica para campanhas de dupla confirmação de saída. Com uma pasta de descadastro configurada na caixa monitorada, o Mautic também acrescenta o endereço ao cabeçalho List-Unsubscribe, que os programas de e-mail usam para mostrar o botão de descadastro.

A opção de enviar para contatos descadastrados existe para mensagens transacionais, como a confirmação de uma compra. A documentação desaconselha o uso dela em conteúdo de marketing.

Bounces e o que pesa na entrega

O bounce é o e-mail devolvido pelo servidor de destino, por endereço inexistente ou caixa cheia. Desde o Mautic 5, todos os transportes usam o mesmo webhook de retorno, no caminho /mailer/callback da sua instância. A documentação lista o suporte a esse retorno no Amazon SES, no SendGrid, no Mailjet, no SparkPost, no Mandrill e no Elastic Email.

O caminho alternativo é a caixa monitorada por IMAP. O Mautic lê essa caixa pelo comando mautic:email:fetch e procura bounces e solicitações de descadastro. A documentação avisa que alguns serviços reescrevem o cabeçalho return-path, entre eles o Gmail e o Amazon SES. Com o cabeçalho reescrito, a leitura por IMAP não encontra os bounces.

O e-mail é uma das ações que um formulário dispara no envio. O próximo assunto é a captura no seu site, na página Formulários e landing pages.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.