Pular para o conteúdo

Configurar SMTP no Mautic

O Mautic monta campanhas, segmentos e automações, mas não entrega e-mail sozinho: ele precisa de um servidor de envio. Configurado com o SMTP da iPORTO, cada e-mail do Mautic sai por um servidor que autentica o seu domínio, e o envio aparece no histórico do painel do SMTP, com o status da entrega.

  • Uma conta no SMTP da iPORTO. Se ainda não tem, veja os planos do SMTP — dá para testar por 7 dias, sem cartão.
  • Um domínio cadastrado com Tipo de envio → Marketing. O Mautic envia campanha, e campanha é marketing: o SMTP só aceita envio de marketing em domínio criado como Marketing. O tipo é escolhido na hora de cadastrar o domínio — veja Adicionar um domínio de envio.
  • Os registros DNS desse domínio publicados — veja Publicar os registros DNS do domínio.
  • Uma credencial SMTP nesse domínio, como [email protected] — veja Criar uma credencial SMTP.
  • Acesso de administrador ao Mautic.
  • O servidor do Mautic precisa permitir conexões de saída na porta 587 — ou, se ela estiver bloqueada, na 465.
  1. No Mautic, clique na engrenagem (Configurações), no alto da tela, e depois em Configuração.
  2. Abra a aba Configurações de email.
Campo O que preencher Onde achar
Nome utilizado ao enviar este e-mail O nome que o destinatário vai ver, como Sua Empresa —
Enviar email a partir do endereço Um endereço do domínio de marketing, como [email protected] O domínio cadastrado no painel do SMTP
Remetente é dono Não —
Esquema (em DSN de E-mail) smtp —
Host smtp-avancado.com —
Porta 587 —
Caminho Vazio —
Usuário A credencial completa, como [email protected] Painel do SMTP: Infraestrutura → Domínios (SMTP) → o domínio → aba Credenciais
Senha A senha da credencial No card da credencial, em Senha, pelo botão de copiar

Os demais campos ficam como estão — inclusive Endereço de caminho de retorno personalizado (bounce), vazio, e Disable unsubscribe link in header, em Não. Clique em Salvar.

  • Digite o usuário com o @ normalmente. O Mautic converte para o formato da DSN ao salvar. Só quem edita a DSN direto no arquivo de configuração do Mautic precisa escrever o @ como %40.
  • Por que “Remetente é dono” em Não. Com Sim, cada e-mail sai em nome do usuário do Mautic dono do contato — e o endereço desse usuário pode não ser do seu domínio de marketing. A mensagem chegaria ao destino em nome de um domínio que você não autenticou. É o valor padrão para os e-mails que você criar daqui em diante.
  1. Depois de salvar, ainda na aba Configurações de email, clique em Enviar email de teste, no bloco DSN de E-mail.
  2. O Mautic envia o teste para o e-mail do seu usuário — o que você usa para entrar no Mautic.
  3. Se deu certo, aparece Sucesso!. Abra o painel do SMTP e confira o envio em Histórico de envio.
  • Os e-mails de segmento saem pelas tarefas agendadas do Mautic (o cron do servidor dele), e não na hora em que você publica. Com elas rodando, cada envio aceito pelo servidor entra no Histórico de Envio do painel do SMTP, com o status da entrega.
  • Descadastro em um clique. Nos e-mails com link de descadastro, o Mautic já inclui os cabeçalhos que fazem Gmail e Yahoo mostrarem o botão Cancelar inscrição — veja Ativar o descadastro em um clique. Para isso, Disable unsubscribe link in header precisa ficar em Não.
  • Devoluções (bounces). O Mautic não fica sabendo sozinho dos e-mails que voltaram: elas ficam no histórico do painel do SMTP, e o próprio SMTP passa a bloquear novos envios para os endereços que devolveram — veja Entender por que um e-mail não foi entregue.

Aceito pelo servidor não quer dizer entregue na caixa de entrada: o destino ainda pode recusar, adiar ou filtrar a mensagem — e é o histórico que mostra o que aconteceu.

Sintoma Causa provável O que fazer
Failed to authenticate on SMTP server with username "…", com 535 Incorrect authentication data Usuário ou senha errados, ou o usuário foi informado sem o @domínio Use a credencial completa como usuário e copie a senha de novo pelo botão do painel. Confira também se o Status da credencial está ativo
Connection could not be established with host "ssl://smtp-avancado.com:587", com wrong version number Esquema está como smtps, que não funciona na porta 587 Use smtp. Com smtp, o Mautic escolhe a criptografia certa sozinho: STARTTLS na 587 e SSL na 465
Connection could not be established with host "smtp-avancado.com:587", com Connection timed out, depois de cerca de um minuto O servidor do Mautic não consegue sair pela porta 587 Troque a Porta para 465, mantendo o Esquema smtp. Se também falhar, peça ao provedor do servidor para liberar conexões de saída na 587 ou na 465 para smtp-avancado.com
O botão Enviar email de teste está desativado Algum campo da DSN mudou e ainda não foi salvo Clique em Salvar e teste de novo
O teste funciona, mas o e-mail de segmento não sai As tarefas agendadas (cron) do Mautic não estão rodando Confira com quem administra o servidor do Mautic se o cron está configurado
O e-mail sai com um remetente diferente do configurado Remetente é dono está em Sim Mude para Não
O e-mail aparece no histórico como recusado ou devolvido O destino recusou a mensagem depois de o servidor aceitá-la Veja Entender por que um e-mail não foi entregue