Domínio de bounce

Seu domínio de bounce é o hostname de return-path em um domínio de envio. Bounces e feedback de entrega vão para esse endereço envelope-from. Seu CNAME permite que processemos bounces e fornece alinhamento SPF sem um registro SPF no apex do seu domínio. O domínio de bounce é um dos três registros que habilitam o envio.

Esta página cobre especificamente o return-path. Para o conjunto completo de registros e o ciclo de vida de verificação, consulte Domínios de envio; para saber o que cada registro comprova, consulte DKIM, SPF & DMARC.

O registro

O return-path é um CNAME sob o seu domínio de envio que resolve para nossa infraestrutura de bounce na sua região:

Tipo	Host	Valor
CNAME	send.example.com	<region>.bounce.bird.com

O valor é específico por região: us1.bounce.bird.com ou eu1.bounce.bird.com. Copie-o em Email > Domains no painel ou no recurso de domínio. O host padrão é send. sob o seu domínio de envio.

Personalizando o hostname

Você escolhe o rótulo ao registrar o domínio: passe-o como return_path.name e nós compomos o hostname completo sob o seu domínio de envio:

const domain = await bird.domains.create({
  domain: "mail.acme.com",
  return_path: { name: "bounce" },
});

domain = client.domains.create(
    domain="mail.acme.com",
    return_path={"name": "bounce"},
)

domain, err := client.Domains.Create(context.Background(), bird.DomainCreateParams{
	Domain:     "mail.acme.com",
	ReturnPath: &bird.DomainReturnPathConfig{Name: "bounce"},
})

$domain = $bird->domains->create(
    (new DomainCreate())
        ->setDomain('mail.acme.com')
        ->setReturnPath((new DomainReturnPathConfig())->setName('bounce')),
);

bird email domains create mail.acme.com --body-file - <<'JSON'
{
  "domain": "mail.acme.com",
  "return_path": {
    "name": "bounce"
  }
}
JSON

curl -s https://us1.platform.bird.com/v1/email/domains \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "mail.acme.com",
    "return_path": { "name": "bounce" }
  }'

Isso registra bounce.mail.acme.com como o return-path em vez do padrão send.mail.acme.com. Omita return_path e o padrão será send. O hostname faz parte da configuração do espaço de trabalho do domínio de envio.

Por que ele cobre SPF

Receptores avaliam SPF com base no domínio do envelope-from, e não no endereço From: visível. Seu envelope-from é o hostname de return-path. Como o CNAME verificado resolve para nossa infraestrutura de bounce, a autorização SPF dessa infraestrutura se aplica a você, e ela se alinha com o seu domínio porque o return-path é um subdomínio dele. Assim, SPF passa e se alinha com um único CNAME, e você não precisa publicar nem manter um include: no seu apex. O raciocínio completo está em Onde está o SPF?.

Obrigatório para envio e não pode ser removido

O CNAME de return-path faz parte da habilitação de envio: capabilities.sending só é verificado quando DKIM, o CNAME de return-path e uma política DMARC estão todos configurados. Até o return-path ser verificado, o domínio não pode enviar.

Pelo mesmo motivo, o return-path não pode ser removido. Todo envio precisa de um destino para bounces, então você pode alterar o hostname, mas nunca removê-lo: uma atualização que tente anulá-lo é rejeitada. As alterações são preparadas de forma segura. Um hostname já verificado nunca é substituído por um não verificado. Verificamos o novo return-path em paralelo ao ativo e o promovemos somente quando o novo CNAME é confirmado, para que o envio ativo nunca seja interrompido durante a migração do registro.

Próximos passos

Domínios de envio: registrar um domínio e o ciclo de vida de verificação
DKIM, SPF & DMARC: cada registro no domínio e o que ele comprova
Domínio de tracking: o hostname opcional de marca para rastreamento de abertura/clique
Tutoriais de DNS por provedor: publicar o CNAME no seu registrador

Recursos relacionados

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Assista ao guiaGetting started with email Explore a funcionalidadeEmail Siga o percurso de aprendizagemBuild your first integration Guia de implementaçãoSend your first email

Experimente na prática e obtenha um resumo de implementação