Guias

Domínios e DNS

Os registros DKIM, SPF, MX e de rastreamento, a verificação e as regiões de envio.

#Como funciona

Para enviar com o seu domínio, a Postal precisa que você publique alguns registros DNS. Eles provam que o domínio é seu e fazem os e-mails passarem nas verificações de SPF, DKIM e DMARC dos provedores, o que evita a caixa de spam.

Adicione o domínio no painel ou com POST /domains. Recomendamos um subdomínio só para e-mails, como mail.lojaexemplo.com.br, se o domínio principal já envia por outro serviço.
Crie os registros mostrados no seu provedor de DNS (Registro.br, Cloudflare, Route 53, GoDaddy…).
Clique em Verificar (ou chame POST /domains/{id}/verify). A Postal confere os registros sozinha por até 72 horas e avisa pelo webhook domain.updated.

#Registros de envio

Exemplo para lojaexemplo.com.br na região sa-east-1. Os valores exatos do seu domínio, principalmente a chave DKIM, estão no painel e em GET /domains/{id}.

Tipo	Nome	Valor	Para quê
`TXT`	`postal._domainkey`	`p=MIIBIjANBgkqh…IDAQAB`	DKIM: assina cada e-mail com a chave do seu domínio.
`MX`	`postal`	`feedback-smtp.sa-east-1.amazonses.com` (prioridade 10)	Return-Path: recebe os bounces e as reclamações.
`TXT`	`postal`	`v=spf1 include:_spf.postal.so ~all`	SPF do Return-Path: autoriza a Postal a enviar.

Os nomes são relativos ao domínio: postal é postal.lojaexemplo.com.br. Alguns provedores pedem o nome completo, outros completam sozinhos; se o painel acusar postal.lojaexemplo.com.br.lojaexemplo.com.br, tire o domínio do nome. O subdomínio postal pode ser outro, com custom_return_path na criação. Como o SPF fica no subdomínio do Return-Path, o SPF do seu domínio principal não muda.

#DMARC

A Postal não exige, mas os grandes provedores (Gmail, Outlook, Yahoo) cobram DMARC de quem envia volume. Se o seu domínio ainda não tem, comece monitorando:

Tipo	Nome	Valor
`TXT`	`_dmarc`	`v=DMARC1; p=none; rua=mailto:[email protected]`

Com os relatórios mostrando que tudo passa, endureça a política para p=quarantine e depois p=reject. O diagnóstico de entregabilidade de cada e-mail avisa quando falta DMARC.

#Rastreamento de aberturas e cliques

Ligue open_tracking e click_tracking no domínio para receber os eventos email.opened e email.clicked. Por padrão, os links rastreados usam um domínio da infraestrutura de envio. Para usar um endereço seu, defina tracking_subdomain (por exemplo, links) e crie o registro:

Tipo	Nome	Valor
`CNAME`	`links`	`r.sa-east-1.awstrack.me`

Rastreamento de aberturas depende de imagens e não é exato: vários clientes de e-mail carregam ou bloqueiam imagens automaticamente.

#Recebimento (MX)

Para receber e-mails no seu domínio (planos pagos), ative capabilities.receiving e aponte o MX do domínio para a Postal:

Tipo	Nome	Valor
`MX`	`@`	`mx.postal.so` (prioridade 10)

Atenção

Trocar o MX do domínio principal faz todos os e-mails dele chegarem na Postal, e não mais na sua caixa atual (Google Workspace, Microsoft 365…). Na dúvida, use um subdomínio, como atendimento.lojaexemplo.com.br, ou um endereço gratuito em in.postal.so.

Depois, crie inboxes para os endereços que quer receber.

#Status da verificação

Status	Significado
`not_started`	A verificação ainda não começou.
`pending`	Conferindo os registros.
`partially_verified`	Alguns registros já estão certos; faltam outros.
`verified`	Tudo certo: o domínio pode enviar.
`partially_failed`	Passaram 72 horas e alguns registros não foram encontrados.
`failed`	Passaram 72 horas sem encontrar os registros.

Cada registro tem também o próprio status e, quando algo está errado, um diagnostic que explica o problema (valor diferente, registro duplicado…). Corrija e verifique de novo.

#Regiões

A região define de onde os seus e-mails saem e onde ficam os dados de envio. O padrão é São Paulo.

Região	Local
`sa-east-1`	São Paulo (padrão)
`us-east-1`	Virgínia do Norte, EUA
`us-east-2`	Ohio, EUA
`eu-west-1`	Irlanda
`ap-northeast-1`	Tóquio

#TLS

Com tls: "opportunistic" (padrão), a Postal usa TLS sempre que o servidor do destinatário aceita e entrega sem TLS quando ele não aceita. Com enforced, a mensagem só é entregue com TLS.

#Domínio em outra conta

Se ao adicionar o domínio a Postal disser que ele já está cadastrado, ele está em outra conta (de um ex-funcionário ou de um teste antigo, por exemplo). Prove que você controla o DNS com uma reivindicação: crie o registro TXT postal-domain-verification=… e o domínio é transferido para a sua conta, com chaves DKIM novas.