Dominio di bounce
Il tuo dominio di bounce è l'hostname return-path su un dominio di invio. Bounce e feedback di consegna vengono inviati a questo indirizzo envelope-from. Il suo CNAME ci consente di elaborare i bounce e fornisce l'allineamento SPF senza un record SPF all'apex del tuo dominio. Il dominio di bounce è uno dei tre record necessari per abilitare l'invio.
Questa pagina tratta specificamente il return-path. Per l'insieme completo dei record e il ciclo di vita della verifica, consulta Domini di invio; per sapere cosa dimostra ogni record, consulta DKIM, SPF & DMARC.
Il record
Il return-path è un CNAME sotto il tuo dominio di invio che risolve verso la nostra infrastruttura di bounce nella tua regione:
| Tipo | Host | Valore |
|---|---|---|
| CNAME | send.example.com | <region>.bounce.bird.com |
Il valore è specifico per la regione: us1.bounce.bird.com o eu1.bounce.bird.com. Copialo da Email > Domains nella dashboard o dalla risorsa dominio. L'host predefinito è send. sotto il tuo dominio di invio.
Personalizzare l'hostname
Scegli l'etichetta al momento della registrazione del dominio: passala come return_path.name e noi componiamo l'hostname completo sotto il tuo dominio di invio:
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"
}
}
JSONcurl -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" }
}'Questo registra bounce.mail.acme.com come return-path al posto del valore predefinito send.mail.acme.com. Ometti return_path e il valore predefinito sarà send. L'hostname fa parte della configurazione dello spazio di lavoro del dominio di invio.
Perché copre SPF
I riceventi valutano SPF in base al dominio envelope-from anziché all'indirizzo From: visibile. Il tuo envelope-from è l'hostname return-path. Poiché il CNAME verificato risolve verso la nostra infrastruttura di bounce, l'autorizzazione SPF di quell'infrastruttura si applica a te, e si allinea con il tuo dominio perché il return-path è un sottodominio di esso. Quindi SPF passa e si allinea con un solo CNAME, e non devi pubblicare o mantenere un record include: all'apex. Il ragionamento completo è in Dov'è SPF?.
Obbligatorio per l'invio e non rimovibile
Il CNAME return-path fa parte del gate di invio: capabilities.sending si verifica solo quando DKIM, il CNAME return-path e una policy DMARC sono tutti presenti. Finché il return-path non è verificato, il dominio non può inviare.
Per lo stesso motivo, il return-path non può essere rimosso. Ogni invio ha bisogno di una destinazione per i bounce, quindi puoi cambiare l'hostname ma non rimuoverlo: un aggiornamento che tenta di impostarlo a null viene rifiutato. Le modifiche vengono applicate in modo sicuro. Un hostname già verificato non viene mai sostituito con uno non verificato. Verifichiamo il nuovo return-path in parallelo a quello attivo e lo promuoviamo solo quando il nuovo CNAME supera il controllo, così l'invio non si interrompe mai durante la migrazione del record.
Passaggi successivi
- Domini di invio: registrare un dominio e il ciclo di vita della verifica
- DKIM, SPF & DMARC: ogni record sul dominio e cosa dimostra
- Dominio di tracking: l'hostname brandizzato opzionale per il tracciamento di aperture e clic
- Guide DNS per provider: pubblicare il CNAME nel tuo registrar
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Guarda la guidaGetting started with emailEsplora la funzionalitàEmailSegui il percorso di apprendimentoBuild your first integrationGuida all'implementazioneSend your first email
Prova l'esercitazione e ottieni un brief di implementazione