Bounce domain

Bounce domain Anda adalah hostname return-path pada sending domain. Bounce dan umpan balik pengiriman dikirim ke alamat envelope-from ini. CNAME-nya memungkinkan kami memproses bounce dan menyediakan keselarasan SPF tanpa record SPF di apex domain Anda. Bounce domain adalah salah satu dari tiga record yang menjadi syarat pengiriman.

Halaman ini membahas return-path secara khusus. Untuk kumpulan record lengkap dan siklus verifikasi, lihat Sending domain; untuk fungsi setiap record, lihat DKIM, SPF & DMARC.

Record

Return-path adalah CNAME di bawah sending domain Anda yang di-resolve ke infrastruktur bounce kami di region Anda:

Tipe	Host	Nilai
CNAME	send.example.com	<region>.bounce.bird.com

Nilainya spesifik per region: us1.bounce.bird.com atau eu1.bounce.bird.com. Salin dari Email > Domains di dashboard atau dari resource domain. Host default-nya adalah send. di bawah sending domain Anda.

Menyesuaikan hostname

Anda memilih label saat mendaftarkan domain: kirimkan sebagai return_path.name dan kami menyusun hostname lengkap di bawah sending domain Anda:

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" }
  }'

Ini mendaftarkan bounce.mail.acme.com sebagai return-path, menggantikan default send.mail.acme.com. Jika return_path dihilangkan, nilai default-nya adalah send. Hostname ini merupakan bagian dari konfigurasi workspace sending domain.

Mengapa ini mencakup SPF

Penerima mengevaluasi SPF berdasarkan domain envelope-from, bukan alamat From: yang terlihat. Envelope-from Anda adalah hostname return-path. Karena CNAME yang terverifikasi di-resolve ke infrastruktur bounce kami, otorisasi SPF infrastruktur tersebut berlaku untuk Anda, dan selaras dengan domain Anda karena return-path merupakan subdomain dari domain tersebut. Jadi SPF lolos dan selaras hanya dengan satu CNAME, dan Anda tidak perlu menerbitkan atau memelihara include: di apex Anda. Penjelasan lengkapnya ada di Where's SPF?.

Wajib untuk pengiriman dan tidak dapat dihapus

CNAME return-path adalah bagian dari syarat pengiriman: capabilities.sending baru terverifikasi setelah DKIM, CNAME return-path, dan kebijakan DMARC semuanya terpasang. Selama return-path belum terverifikasi, domain tidak dapat mengirim.

Karena alasan yang sama, return-path tidak dapat dihapus. Setiap pengiriman membutuhkan tujuan untuk bounce, jadi Anda dapat mengubah hostname tetapi tidak dapat mengosongkannya: pembaruan yang mencoba meng-null-kan akan ditolak. Perubahan dilakukan secara bertahap dengan aman. Hostname yang sudah terverifikasi tidak pernah ditukar dengan yang belum terverifikasi. Kami memverifikasi return-path baru bersamaan dengan yang aktif dan mempromosikannya hanya setelah CNAME baru terverifikasi, sehingga pengiriman tetap berjalan saat Anda memigrasikan record.

Langkah selanjutnya

Sending domain: mendaftarkan domain dan siklus verifikasi
DKIM, SPF & DMARC: setiap record pada domain dan fungsinya
Tracking domain: hostname bermerek opsional untuk pelacakan open/click
Panduan DNS per penyedia: menerbitkan CNAME di registrar Anda

Sumber daya terkait

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.

Tonton panduannyaGetting started with email Jelajahi kemampuannyaEmail Ikuti jalur pembelajaranBuild your first integration Panduan implementasiSend your first email

Coba praktiknya dan dapatkan ringkasan implementasi