Sign inGet started

Sending domain

Sebelum kami dapat mengirim email dari domain Anda, Anda harus membuktikan kepemilikannya dan mempublikasikan rekaman DNS yang memungkinkan penyedia kotak masuk mengautentikasi email Anda. Sending domain adalah resource cakupan workspace (dom_...) yang melacak pengaturan tersebut: rekaman mana yang perlu dipublikasikan, apa yang sudah terverifikasi, dan apakah domain siap mengirim.

Berbagi domain lintas organisasi

Domain yang sama dapat didaftarkan oleh lebih dari satu organisasi tanpa saling mengganggu. Setiap organisasi membuktikan kepemilikan dengan kunci DKIM-nya sendiri, sehingga:
  • Organisasi lain pada domain yang sama tidak akan pernah bisa melihat status verifikasi Anda atau mengubah konfigurasi Anda.
  • Setiap region (us1, eu1) bersifat independen: domain yang sama di dua region berarti dua registrasi terpisah dengan rekaman DNS masing-masing. Daftarkan domain di setiap region tempat Anda mengirim.

Mendaftarkan domain

Buat domain dengan POST /v1/email/domains. Panggilan ini bercakupan workspace dan menerima sending domain beserta label opsional untuk hostname return-path dan tracking. Kirimkan label saja (send, links), dan kami menyusun hostname lengkap di bawah sending domain Anda. Nilai yang tidak diisi akan default ke send dan links.
Gunakan subdomain khusus (mail.acme.com) alih-alih domain terdaftar Anda. Ini memisahkan reputasi pengiriman Anda dari segala hal lain pada domain, dan menjaga setiap rekaman yang kami minta Anda publikasikan tetap di luar zone apex. Alasan kedua inilah yang menimbulkan masalah: rekaman MX untuk penerimaan berada pada nama yang sama dengan rekaman MX yang sudah menangani email perusahaan Anda, sehingga pada sending domain apex, mempublikasikannya mengalihkan email tersebut ke kami.
const domain = await bird.domains.create({ domain: "mail.acme.com" });
console.log(domain.id, domain.status); // "dom_…", "pending"
Respons mencakup status: pending, selektor DKIM yang ditetapkan untuk organisasi Anda, dan dns_records yang perlu dipublikasikan. Registrasi workspace yang sudah ada mengembalikan 409. Melebihi kuota domain organisasi Anda mengembalikan 422. Ganti eu1 dengan us1 untuk workspace US. Kunci API menggunakan prefiks regional yang sama: bk_eu1_... dan bk_us1_.... Anda juga dapat mengelola domain di Email > Domains.
Halaman Domains di dashboard, menampilkan sending domain terverifikasi dengan kapabilitas sending, return-path, dan tracking

Publikasikan rekaman DNS

Array dns_records memberikan name, host, dan value yang bisa langsung disalin untuk setiap rekaman. Beberapa penyedia menolak nilai TXT DKIM yang panjang sebagai satu string; DNS record splitter memecahnya menjadi string berkutip yang diharapkan oleh penyedia tersebut. Yang perlu Anda publikasikan:
RekamanTipeWajib untuk pengirimanFungsinya
DKIMTXTYaMembuktikan kepemilikan dan menandatangani email Anda dengan kunci organisasi Anda
Return-path CNAMECNAMEYaMerutekan bounce kembali ke kami dan mencakup SPF; pencarian SPF mengikuti CNAME, sehingga tidak diperlukan rekaman SPF pada zone apex domain Anda
DMARCTXTYaKebijakan v=DMARC1 yang valid yang mencakup sending domain, pada domain itu sendiri atau pada domain terdaftar (organisasional)-nya. Kebijakan p=none minimal sudah cukup.
Tracking CNAMECNAMETidakMengaktifkan hostname tracking open/click bermerek; tautan terlacak disajikan melalui HTTPS setelah terverifikasi
Inbound MXMXTidakMerutekan email untuk domain ke kami untuk penerimaan. Membawa optional: true sampai Anda mengaktifkan penerimaan; mempublikasikannya menggantikan rekaman MX yang digunakan domain saat ini.
Untuk tujuan dan nilai setiap rekaman, lihat DKIM, SPF, dan DMARC. Rekaman MX penerimaan ada di dns_records dengan purpose: inbound_mx setiap kali penerimaan tersedia di region Anda, dan membawa optional: true sampai Anda mengaktifkan penerimaan pada domain. Lewati setiap rekaman bertanda optional kecuali Anda menginginkan fungsi yang diaktifkannya. Untuk langkah pengaturan penyedia DNS, lihat panduan Cloudflare, Route 53, atau registrar umum.
Dashboard mendeteksi penyedia DNS yang didukung dari nameserver domain Anda dan menautkan ke pengaturan DNS mereka. Buka Email > Domains, lalu pilih domain untuk melihat rekamannya. Jika orang lain yang mengelola DNS Anda, POST /v1/email/domains/{domain_id}/dns-records/share mengirimkan email berisi rekaman yang perlu dipublikasikan kepada mereka.
Halaman DNS Records sebuah domain di dashboard, menampilkan rekaman DKIM terverifikasi dengan nama dan nilai yang bisa disalin, diikuti bagian return-path dan DMARC

Siklus verifikasi

Domain baru dimulai sebagai pending. Anda tidak perlu melakukan polling karena kami memeriksa rekaman Anda secara otomatis. Pemeriksaan dimulai segera saat registrasi dan melambat dari setiap beberapa menit menjadi per jam selama tiga hari pertama. Setelah itu berjalan harian untuk setiap domain aktif. Mempublikasikan rekaman dan menunggu sudah cukup; sebagian besar domain terverifikasi dalam hitungan menit setelah propagasi DNS. Jika Anda ingin pemeriksaan segera (misalnya tepat setelah mengedit DNS), panggil POST /v1/email/domains/{domain_id}/verify: panggilan ini menjalankan pemeriksaan baru dan mengembalikan domain yang diperbarui. Respons 200 dengan rekaman yang masih pending bukan kegagalan; artinya rekaman belum ditemukan, yang normal selama DNS berpropagasi (menit hingga jam). Panggilan ini aman untuk diulang selama Anda menunggu.
Domain yang tetap belum terverifikasi selama sekitar 14 hari akan dihapus. Kami mengirimkan email pengingat ke workspace beberapa hari sebelum penghapusan agar Anda dapat menyelesaikan pengaturan.
status tingkat atas domain mencerminkan kepemilikan, dibuktikan oleh rekaman DKIM:
  • pending: rekaman DKIM belum dipublikasikan.
  • verified: rekaman DKIM sudah terpasang; kepemilikan terkonfirmasi.
  • failed: rekaman DKIM ada tetapi tidak cocok dengan nilai yang diharapkan, atau rekaman yang sebelumnya terverifikasi telah dihapus. Perbaiki rekaman untuk memulihkan.
  • temporary_failure: resolusi DNS gagal sementara; verifikasi dicoba lagi secara otomatis.
  • rejected: domain ditolak karena alasan kebijakan; hubungi dukungan.
Kesiapan untuk mengirim dilaporkan secara terpisah di bawah capabilities. Gerbang pengiriman adalah capabilities.sending, yang terverifikasi hanya ketika DKIM, return-path CNAME, dan kebijakan DMARC semuanya terpasang; SPF pada zone apex domain tidak diperlukan. Kesiapan tracking (capabilities.tracking) independen dari gerbang pengiriman: ini mengontrol apakah tracking open/click bermerek dapat digunakan, bukan apakah domain boleh mengirim.

Ketika rekaman terverifikasi rusak

Verifikasi tidak pernah berhenti: pemeriksaan ulang harian menjaga domain terverifikasi tetap valid, sehingga jika DNS Anda kemudian rusak, kami mendeteksinya. Untuk menghindari perubahan status bolak-balik akibat gangguan DNS sementara, rekaman terverifikasi yang mulai gagal pada pemeriksaan ulangnya dipertahankan terverifikasi dalam status peringatan dan diperiksa ulang per jam, dan kami memberi tahu Anda. Hanya setelah rekaman terus gagal selama 24 jam penuh, domain diturunkan statusnya; pemeriksaan yang lolos dalam jendela waktu tersebut menghapus peringatan. Penurunan status berlaku pada pengiriman berikutnya, dan domain yang diturunkan terverifikasi ulang secara otomatis setelah rekaman diperbaiki, pada pemeriksaan otomatis berikutnya atau verifikasi manual.

Mengelola domain

Region. Status domain bersifat regional. Jika Anda mengirim dari us1 dan eu1, daftarkan domain di setiap region; setiap registrasi mendapatkan selektor DKIM-nya sendiri dan terverifikasi secara independen.
Mengubah hostname return-path atau tracking. Hostname ini milik konfigurasi domain workspace Anda. Hostname yang sudah terverifikasi tidak pernah diganti oleh yang belum terverifikasi: perubahan ditangguhkan, diverifikasi bersamaan dengan konfigurasi aktif Anda, dan dipromosikan hanya setelah rekaman baru lolos pemeriksaan.
Tracking open/click. Toggle settings milik konfigurasi domain workspace. Perubahan pada toggle hanya berlaku untuk konfigurasi domain ini. Anda dapat mengaktifkannya segera setelah tracking domain dikonfigurasi. Mengaktifkan salah satunya tanpa tracking domain mengembalikan 409. Toggle memengaruhi pengiriman hanya setelah tracking domain tersebut terverifikasi, sehingga verifikasi diterapkan per pengiriman.
Penghapusan. DELETE /v1/email/domains/{domain_id} menghapus sending domain dari workspace Anda. Penggunaan domain lainnya tetap tidak berubah.

Langkah selanjutnya