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. Para saber se o domínio já tem MX de outro provedor, consulte GET /domains/{id}/receiving-check: ele só informa, não impede a ativação, e o painel usa a resposta para avisar.

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.

#Quando um registro some

Depois de verificado, o domínio continua sendo conferido todo dia, em um horário que muda de um domínio para outro. Se um registro obrigatório de envio (o DKIM ou os do Return-Path) deixa de ser encontrado:

A Postal anota a falta e confere de novo em 5 minutos, para não reagir a uma falha momentânea do DNS. Uma consulta que falha nunca conta como registro sumido.
Se a segunda conferência concorda, o domínio continua verificado e enviando, mas passa a trazer records_missing em GET /domains/{id} (com since, deadline_at e os records que faltam). Sai o webhook domain.updated e os membros do time com as notificações de domínio ligadas recebem um e-mail com o registro exato e o prazo. A conferência passa a ser de hora em hora.
Se o registro continua sumido 72 horas depois da primeira falta, o domínio vira failed (ou partially_failed, se sobrou um dos obrigatórios) e deixa de enviar. A Postal segue procurando os registros a cada 6 horas.
Quando o registro volta, dentro ou fora do prazo, o aviso some e o domínio volta a verified sozinho. Clicar em Verificar num domínio que ainda envia só antecipa a conferência; num que caiu, recomeça a verificação de 72 horas.

Os registros de rastreamento e de recebimento não entram nessa regra.

#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.