WordPress with WP Mail SMTP
WP Mail SMTP: como configurar SPF, DKIM e DMARC no WordPress
O WP Mail SMTP envia o e-mail do WordPress por um mailer. Veja quais registros SPF, DKIM e DMARC esse mailer pede e como confirmar cada um.
Verifique a configuração atual:
Como o WP Mail SMTP envia o e-mail do WordPress
O WP Mail SMTP é um plugin do WordPress que reconfigura a função wp_mail(), e assim o site passa a enviar por um servidor SMTP ou pela API de um provedor de e-mail em vez da função de correio do servidor web. O plugin chama esse serviço de mailer. Os resultados de SPF, DKIM e DMARC dependem dos registros DNS que você publica para o mailer conectado.
Política DMARC existente: autenticar WordPress with WP Mail SMTP não exige redefini-la. Mantenha um único _dmarc, preserve p, as opções de subdomínio e alinhamento e acrescente o rua necessário aos destinos existentes. O exemplo com p=none abaixo vale apenas para uma implantação nova sem registro válido.
Três termos explicam o resto deste guia. SPF é um registro DNS com a lista dos servidores autorizados a enviar pelo seu domínio. DKIM é uma assinatura adicionada a cada mensagem e conferida com uma chave publicada no seu DNS. DMARC diz aos servidores de destino o que fazer quando nenhuma das duas verificações liga a mensagem ao domínio do endereço From. Essa ligação se chama alinhamento. Uma verificação alinhada basta para a mensagem passar no DMARC, e a RFC 9989 pede ao dono do domínio pelo menos uma e, de preferência, duas.
Sem mailer, o WordPress usa a função básica de e-mail do PHP. Se nenhum plugin definir outro remetente, o endereço From é wordpress@ seguido do domínio do site.
Os nomes de menus e opções aparecem em inglês, como na documentação oficial. Com o WordPress em português, alguns rótulos podem vir traduzidos.
O mailer define quais registros você precisa
O WP Mail SMTP não documenta nenhum valor de include: nem seletor DKIM próprio. Esses dados vêm do mailer. Alguns exemplos:
- Google Workspace / Gmail. O plugin envia pela API do Google. O SPF usa
include:_spf.google.com. O guia do Google Workspace explica o DKIM. - SMTP.com. A documentação do WP Mail SMTP traz
v=spf1 include:_spf.smtp.com ~allpara o SPF e um registro TXT de DKIM emsmtpcomcustomers._domainkey, com o valor copiado do SMTP.com. - Mandrill. A documentação mostra dois registros CNAME de DKIM, com os nomes de exemplo
mte1._domainkeyemte2._domainkey. - SendGrid e Brevo. Você autentica o domínio no painel do próprio provedor. Siga o guia do SendGrid ou o guia do Brevo.
- Other SMTP. Os registros são os do servidor que você informar, em geral o seu provedor de caixas postais ou a sua hospedagem. Pergunte a esse provedor qual é o valor de SPF e se ele assina com DKIM.
- Default (none). O WP Mail SMTP descreve essa opção como, na prática, igual a não usar o plugin. A sua hospedagem continua enviando.
O plugin muda só o que o WordPress envia. As suas caixas postais e ferramentas de newsletter seguem pelo caminho delas, então as entradas de SPF desses serviços precisam continuar.
Passo 1: defina o endereço From
- Abra WP Mail SMTP » Settings no WordPress.
- Em From Email, informe um endereço do domínio que você vai autenticar.
- Ative Force From Email. O endereço acima passa a valer para todas as mensagens e substitui o que outros plugins definirem.
- No plugin de formulário, coloque o endereço do visitante no campo Reply-To.
- Escolha o mailer e conecte. O Setup Wizard conduz essa etapa, e alguns mailers pedem que você verifique o domínio antes de enviar.
Cuidado: o passo 3 também troca o endereço From definido por plugins de formulário e de loja. Envie um teste de cada formulário antes de confiar nele. Antes de mudar o envio de produção do WordPress para outro provedor, verifique a autenticação do domínio. Com uma política existente p=quarantine ou p=reject, mensagens sem SPF e DKIM alinhados podem ser filtradas ou rejeitadas. Quando a opção troca um endereço e a mensagem não tem Reply-To, o plugin usa o endereço original como Reply-To.
Se você usa Other SMTP, ative também Return Path. O plugin passa a usar o From Email como remetente do envelope, o endereço de devolução que o SPF verifica. Assim, o SPF consegue alinhar quando esse servidor está no seu registro SPF. A maioria dos mailers por API, como o SendGrid, esconde essa opção, então conte com o DKIM para alinhar nesses casos.
Passo 2: publique o SPF do mailer
Publique SPF no domínio MAIL FROM indicado pelo mailer, que pode ser a raiz ou um subdomínio de retorno. Junte um include: somente ao SPF daquele nome exato. Se o mailer fornece TXT/MX ou CNAMEs em subdomínio, siga esse fluxo; adicionar o include na raiz não autentica outro domínio MAIL FROM.
- Consulte o registro atual no verificador de SPF.
- Somente nesse nome MAIL FROM, junte o
include:necessário antes do~allou-allfinal. Preserve os outros remetentes. Se não houver SPF ali, use o registro completo do mailer; não crie SPF na raiz só porque o From usa a raiz. - Mantenha as entradas das suas caixas postais e de outros remetentes.
Com caixas postais no Google Workspace e o SMTP.com para o WordPress, o registro ficaria assim:
v=spf1 include:_spf.google.com include:_spf.smtp.com ~all
Cuidado: um domínio só pode publicar um registro SPF. Com dois registros, a verificação SPF devolve permerror e o SPF deixa de passar para todo o seu e-mail. O SPF também aceita no máximo 10 termos que geram consultas DNS, e cada include: conta, junto com as consultas dentro dele. Não mude o final do registro durante os testes. Trocar ~all por -all transforma todo remetente não listado em falha definitiva.
Passo 3: ative o DKIM no mailer
O DKIM assina cada mensagem com uma chave que fica com o mailer. O plugin gratuito não tem configuração de DKIM, então esse trabalho acontece na conta do mailer e no seu DNS.
- Abra a autenticação de domínio na conta do mailer.
- Adicione os registros exatamente como aparecem. Alguns painéis de DNS acrescentam o domínio ao nome do host sozinhos, então informe só a parte pedida.
- Aguarde até 48 horas pela propagação do DNS e confirme a verificação no painel do mailer.
Com Other SMTP, só existe DKIM se o servidor conectado assinar a mensagem. O DMARC olha o domínio da assinatura. Uma mensagem assinada com o domínio do provedor passa no DKIM e mesmo assim não alinha. No alinhamento relaxado, que é o padrão, um subdomínio como mail.exemplo.com.br alinha com um From em exemplo.com.br.
Passo 4: adicione o registro DMARC
Como configurar DMARC no WordPress
Você publica o DMARC no provedor que hospeda o seu DNS. O WordPress e o plugin não mexem nesse registro.
- Entre no serviço que hospeda o seu DNS. Em geral é o painel da hospedagem, o registrador ou a CDN.
- Confira
_dmarcno painel de DNS. Se já existe DMARC, preserve a política e os endereços de relatórios; não o substitua pelo exemplo inicial abaixo. Se não existe, crie um único TXT chamado_dmarc. Vários registros DMARC no mesmo nome são todos descartados. - Use o valor abaixo com um endereço que você controle, ou monte o seu no gerador de DMARC.
Somente política nova: use este valor inicial apenas se não existe DMARC válido. Em um registro existente, mantenha a política e acrescente o endereço de relatórios, sem substituir o valor inteiro.
v=DMARC1; p=none; rua=mailto:dmarc@exemplo.com.br
p=none não expressa nenhuma preferência, então não pede aos servidores de destino que bloqueiem nada. A RFC 9989 diz que os donos de domínio costumam começar assim, com rua apontando para a caixa que recebe os relatórios agregados. Esses relatórios são resumos em XML de quais origens enviaram e-mails com o seu domínio e se passaram nas verificações.
Preserve a política existente durante a autenticação. Na primeira política, comece em p=none e reúna relatórios representativos, o que pode levar meses. Corrigidos todos os fluxos legítimos, considere p=quarantine e acompanhe novamente. Avalie p=reject separadamente: é opcional, exige DKIM alinhado em vez de depender só de SPF, e a RFC 9989 §7.4 desaconselha seu uso quando usuários postam em listas. Teste encaminhamento e alterações feitas por listas; o servidor receptor decide o tratamento final. A RFC 9989 removeu pct do formato atual da política.
Passo 5: confirme com o Email Test
- Vá em WP Mail SMTP » Tools e abra a aba Email Test.
- Envie um teste para uma caixa postal que você consiga ler. Se o plugin encontrar um problema de SPF, DKIM ou DMARC, aparece Domain Check Results com a correção.
- Abra os cabeçalhos da mensagem e cole no analisador de cabeçalhos. Procure
dkim=passcomheader.d=mostrando o seu domínio, e tambémdmarc=pass.
A mesma verificação roda no fim do Setup Wizard, e Tools > Site Health mostra o último resultado. Para fazer essa verificação, o plugin envia o seu endereço From, o mailer e o domínio de envio para o serviço dele.
Se você usa WooCommerce
O WooCommerce envia os e-mails da loja com wp_mail(), então essas mensagens seguem pelo mailer conectado no WP Mail SMTP. O WooCommerce não documenta nenhum include: nem seletor DKIM próprio, e o alinhamento DKIM dos e-mails de pedido depende desse mailer.
Em WooCommerce > Settings > Emails, os campos "From" name e "From" address ficam abaixo da lista de notificações por e-mail. Use um endereço do seu próprio domínio, porque o WooCommerce avisa que endereços públicos, como os do Gmail, podem cair em filtros de spam ou ser bloqueados. Com Force From Email ativado, o endereço que sai é o do WP Mail SMTP.
Confirmações de pedido são e-mails que o cliente espera receber. Faça um pedido de teste e confira os cabeçalhos antes de subir o DMARC além de p=none.
Problemas comuns
- Mensagens de formulário falham no DMARC. O formulário coloca o endereço do visitante no From. O Yahoo e o AOL, por exemplo, publicam
p=reject, e o seu site não tem como autenticar o domínio deles. Ative Force From Email e leve o endereço do visitante para o Reply-To. - O domínio ficou com dois registros SPF. Junte tudo em um único registro
v=spf1. Não deixe os dois publicados. - O DKIM passa e o DMARC falha. A assinatura está usando o domínio do provedor. Termine a autenticação de domínio no mailer até
header.d=mostrar o seu domínio. - Os relatórios ainda mostram a hospedagem. O plugin só reconfigura o
wp_mail(). Scripts que chamam a função de correio do PHP diretamente continuam saindo pelo caminho antigo. Confira também se o mailer não ficou em Default (none). SMTP connect() failed. O WP Mail SMTP aponta para porta, segurança ou host errados, ou para o servidor web bloqueando a conexão de saída. Muitas hospedagens compartilhadas bloqueiam certas portas, então fale com a sua hospedagem.SMTP Error: Could not authenticate.O usuário ou a senha do SMTP estão errados, ou o host exige outro método de autenticação. Registros DNS não mudam esse erro.- Force From Email aparece em cinza e não dá para alterar. O WP Mail SMTP diz que o mailer escolhido já força o From Email em todo o site.
- E-mails da Backup Connection falham no DMARC. Esse recurso do Pro envia por um segundo mailer quando o principal falha. Autentique o seu domínio nesse segundo mailer também.