VTEX: emails transacionais não chegam, como resolver

Se você usa VTEX e está vendo emails transacionais caindo no spam — confirmações de pedido, faturas, rastreamentos — o problema quase sempre é o mesmo: o domínio de envio não tem autenticação correta ou a integração com a plataforma de email está configurada de forma incompleta. Diferente de campanhas de marketing, emails transacionais lidam com dados críticos, então os provedores (Gmail, Outlook, UOL, BOL, iCloud) são ainda mais rigorosos. Vamos resolver isso.

Por que emails transacionais da VTEX caem no spam

VTEX permite que você envie emails de transação de duas formas: pelo módulo nativo de email da plataforma ou através de integração com um ESP (Email Service Provider) externo. Qualquer que seja o caminho, três coisas precisam estar certas:

• Domínio verificado. O VTEX precisa confirmar que você é o dono do domínio que vai enviar emails. Sem isso, qualquer configuração de autenticação que você fizer não funciona.
• Autenticação (SPF, DKIM, DMARC). Os provedores de email verificam essas assinaturas para confirmar que o email realmente saiu de um servidor autorizado seu, não de um invasor.
• Integração correta com ESP. Se você usa RD Station, Brevo ou outro serviço para enviar, precisa apontar os registros DNS para a infraestrutura deles, não para VTEX diretamente.

Quando um desses três falta, o email segue para Spam ou é rejeitado antes de chegar. O pior é que você não vê o erro — o cliente simplesmente não recebe.

Verificação de domínio no painel VTEX

Dentro do Admin VTEX, vá para Configurações da Loja > Email > Domínios (ou caminho similar, pode variar conforme versão). Lá você verá uma lista de domínios que podem enviar emails. Se seu domínio de transação ainda não está verificado, VTEX vai pedir:

1. Acessar o painel de DNS do seu registrador (Locaweb, UOL Host, HostGator, etc).
2. Adicionar um registro TXT com um token que VTEX gera.
3. Aguardar a propagação DNS (até 48h, geralmente 10 minutos).
4. Clicar em "Verificar" no painel VTEX.

Só depois disso você pode configurar SPF/DKIM/DMARC. Se você pular essa etapa e tentar usar o domínio de qualquer forma, provedores vão descartar seus emails automaticamente.

Configuração de SPF, DKIM e DMARC

Depois que o domínio está verificado no VTEX, você precisa adicionar os registros de autenticação no DNS do seu registrador:

• SPF (Sender Policy Framework). Diz ao provedor de email quais servidores podem enviar emails em nome do seu domínio. Se você usa RD Station, Brevo ou Mailchimp, você aponta para o servidor deles. Se usa VTEX nativo, aponta para o VTEX.
• DKIM (DomainKeys Identified Mail). Assinatura criptográfica que prova que o email saiu do seu servidor autorizado, não foi alterado no caminho. VTEX ou o ESP gera uma chave pública e pede para você adicionar no DNS.
• DMARC (Domain-based Message Authentication, Reporting and Conformance). Política que diz o que fazer se SPF ou DKIM falham. Comece com p=none (apenas monitorar), depois mude para p=quarantine (enviar spam) e finalmente p=reject (descartar) quando você estiver confiante.

VTEX mostra exatamente qual registro você precisa adicionar. Copie e cole no painel de DNS do seu registrador (não esqueça de salvar/confirmar).

Integrações de ESP com VTEX

VTEX permite integração nativa ou via API com várias plataformas de email. Cada uma tem um jeito diferente de configurar:

• RD Station (recomendada para Brasil). É a integração mais profunda com VTEX; a configuração de domínio e SPF/DKIM/DMARC é feita quase toda dentro do painel RD Station. Se você usa RD Station para marketing automation ou lead nurturing, adicionar emails transacionais é natural. Verificar domínio no RD Station > Configurações > Domínios, depois conectar via integrações VTEX.
• Brevo (ex-Sendinblue). Popular em e-commerce brasileiro. Você cria uma conta Brevo, verifica o domínio lá, gera as chaves API, e conecta ao VTEX. VTEX vai enviar os emails transacionais via SMTP ou API da Brevo.
• Mailchimp. Funciona via integração de API ou SMTP. A limitação: emails vão de noreply@[seu-dominio] mas a infraestrutura continua sendo Mailchimp. Você precisa configurar SPF/DKIM/DMARC para apontar aos servidores Mailchimp.

Não importa qual você escolha: sempre verifique o domínio no VTEX primeiro, depois no ESP, depois configure DNS. A ordem importa.

Monitoramento e teste de entrega

Configurou tudo? Agora teste. VTEX permite enviar um email de teste no painel. Mas teste em vários provedores de uma vez — Gmail, Outlook, UOL, iCloud — para ter certeza de que nenhum está bloqueando.

A forma mais rápida de verificar onde seus emails estão chegando é usar uma ferramenta gratuita de teste de inbox placement. Você gera um email transacional (ou simula um) e vê em tempo real: Inbox ou Spam em cada provedor? Qual é o veredito dos filtros anti-spam? Tem problema com SPF/DKIM/DMARC?

Isso economiza semanas de tentativa-erro. Se a ferramenta mostrar que SPF está falhando, você sabe exatamente onde corrigir. Se mostrar que vai para Spam no UOL mas Inbox no Gmail, o problema não é autenticação — é reputação de IP ou domínio.

Checklist prático: emails transacionais VTEX

1. No Admin VTEX, vá a Configurações > Email > Domínios e verifique que seu domínio está Verificado (com token TXT no DNS).
2. Se usar ESP externo (RD Station, Brevo, Mailchimp), verifique o domínio lá também.
3. No painel DNS do seu registrador, adicione:
   • Registro SPF apontando para o servidor correto (VTEX ou o ESP).
   • Registro DKIM que o VTEX ou ESP forneceu.
   • Registro DMARC começando com p=none.
4. Aguarde propagação DNS (até 48h, verificar com nslookup ou ferramentas similares).
5. Envie um email de teste do painel VTEX.
6. Verifique em múltiplos provedores (Gmail, Outlook, UOL, iCloud) onde o email chegou.
7. Se tudo estiver no Inbox, aumente o volume e monitore. Se algum estiver em Spam, verifique SPF/DKIM/DMARC ou reputação de IP.