Menerima email

Email yang diterima tersedia di Email > Emails > Receiving, melalui API inbound-messages, dan di webhook email.received. Pilih salah satu dari dua metode penyiapan berdasarkan alamat yang ingin Anda gunakan untuk menerima email.

• Forwarding address adalah kotak surat yang kami buatkan untuk Anda, seperti mfzxq2lom5uxi3lb@eu1.inbound.bird.com (@us1.inbound.bird.com di region US). Tidak perlu domain, tidak perlu DNS: Anda cukup mengarahkan aturan penerusan dari inbox yang sudah ada ke alamat tersebut, dan kami menerima setiap pesan yang diteruskan.
• Menerima di domain sendiri mempublikasikan rekaman MX untuk subdomain yang Anda kendalikan (misalnya inbound.acme.com), setelah itu email yang dikirim ke alamat mana pun di subdomain tersebut masuk sebagai pesan inbound.

Mulai dengan alamat penerusan jika Anda ingin mencoba fitur penerimaan, atau untuk meneruskan email dari inbox dukungan yang sudah ada. Siapkan penerimaan domain jika Anda ingin email dikirim langsung ke domain Anda sendiri.

Alamat penerusan

Di Email > Domains > Forwarding, pilih Add forwarding address dan masukkan nama seperti Support inbox. Kami membuat alamat tetap yang acak. Anda dapat mengganti labelnya nanti. Menghapus satu alamat penerusan menghentikan email ke alamat tersebut tanpa memengaruhi alamat lainnya.

Secara programatis, POST /v1/email/inbound-addresses melakukan hal yang sama (CLI: bird email inbound-addresses create). Respons berisi address yang dihasilkan, id-nya, dan label Anda.

Kemudian atur alamat tersebut sebagai target penerusan di tempat email tersebut berada saat ini: aturan penerusan Gmail atau Google Workspace, aturan Outlook, atau pengaturan penerusan helpdesk Anda. Kami menerima apa pun yang diteruskan, mengurainya, dan menyimpannya sebagai pesan inbound.

Menerima di domain sendiri

Penerimaan domain adalah kemampuan dari domain pengiriman, jadi domain harus didaftarkan dan diverifikasi DKIM terlebih dahulu. Gunakan subdomain khusus (inbound.acme.com), jangan pernah apex Anda: penerimaan diaktifkan pada registrasi domain itu sendiri, dan rekaman MX apex akan menangkap email korporat Anda.

Buka Email > Domains, lalu pilih domain Anda. Di Receiving (Optional), aktifkan penerimaan dan publikasikan rekaman MX yang tercantum. Anda tidak dapat mengaktifkan penerimaan sampai DKIM terverifikasi. Domain yang sudah menerima email untuk organisasi lain juga tidak tersedia.

Setelah diaktifkan, status penerimaan melewati siklus yang sama dengan rekaman pengiriman: pending selagi kami memeriksa DNS untuk rekaman MX, lalu verified setelah semuanya terselesaikan dengan benar. Sejak saat itu, email yang dikirim ke local-part apa pun di domain tersebut (support@, orders@, apa saja) dikirimkan sebagai pesan inbound. Mematikan toggle menghentikan pengiriman email inbound. Rekaman MX tetap tercantum pada domain sebagai referensi, dengan statusnya kembali ke pending.

Ukuran pesan inbound

Bird mendukung pesan inbound hingga 20 MB, termasuk lampiran, pada setiap domain penerimaan di setiap region. Pesan yang lebih besar berada di luar batas yang didukung, meskipun server pengirim menerima respons penerimaan SMTP. Jangan mengandalkan pengirimannya.

Pesan yang melebihi batas dapat ditolak selama transaksi SMTP dengan 552 5.3.4 message size limit exceeded. Server pengirim menerima penolakan ini dan dapat memberitahu pengirimnya. Bird tidak pernah memotong pesan agar sesuai batas ukuran.

Membaca yang Anda terima

Tab Receiving menampilkan pesan yang diterima dari yang terbaru, dengan pengirim, penerima, subjek, dan waktu diterima. Cari berdasarkan alamat pengirim yang tepat atau filter berdasarkan tanggal. Pilih baris untuk membuka tampilan Rendered, Text, Details, dan Raw. Header menampilkan hasil SPF, DKIM, dan DMARC yang dicatat saat pesan tiba.

Email yang diterima disimpan selama 30 hari.

Data yang sama tersedia melalui API (CLI: bird email inbound-messages):

• GET /v1/email/inbound-messages menampilkan daftar pesan, dapat difilter berdasarkan pengirim, alamat inbound, dan waktu diterima.
• GET /v1/email/inbound-messages/{id} mengembalikan metadata terurai dari satu pesan: pengalamatan, subjek, referensi threading, hasil autentikasi, dan metadata lampiran.
• GET /v1/email/inbound-messages/{id}/body mengembalikan isi HTML dan plain-text.
• GET /v1/email/inbound-messages/{id}/attachments menampilkan daftar lampiran; masing-masing dapat diunduh secara individual.
• GET /v1/email/inbound-messages/{id}/raw mengembalikan pesan asli persis seperti yang diterima, dalam format RFC 5322 (MIME).

Merespons email yang diterima: webhook email.received

Untuk memproses email saat tiba (mengarahkan permintaan dukungan, menyerap balasan, memicu agen), daftarkan endpoint webhook ke event email.received. Kami mengirimkannya setelah menerima dan mem-parsing setiap pesan. Payload mencakup inbound_message_id, pengirim dari header From pesan, penerima, subjek, dan referensi in_reply_to. Payload juga mencakup verdict authentication keseluruhan (pass, fail, atau unknown) serta hasil SPF, DKIM, dan DMARC individual; Menggunakan hasil autentikasi menjelaskan mana yang terisi saat ini. Informasi ini mendukung routing dan triase tanpa panggilan lanjutan. Jika Anda membutuhkan body atau lampiran, ambil melalui API inbound-messages menggunakan inbound_message_id dari event tersebut. Pesan disimpan sebelum event dikirim, sehingga id tersebut sudah dapat di-resolve begitu event sampai kepada Anda: ambil /raw atau /body langsung dari handler Anda, tanpa menunggu dan tanpa polling.

Menggunakan hasil autentikasi

SPF dan DKIM diperiksa saat pesan tiba di Bird. Header yang ditambahkan pengirim, seperti Authentication-Results mereka sendiri, tidak mengubah hasil ini.

Field spf_pass dan dkim_pass masing-masing bernilai true, false, atau null. null berarti tidak ada hasil yang dicatat, termasuk saat pemeriksaan tidak dapat diselesaikan. Tanda tangan DKIM yang lolos membuat dkim_pass bernilai true meskipun tanda tangan lain pada pesan tersebut gagal. Field ini tidak mengekspos token hasil detail, signing domain, atau selector.

Hasil DMARC belum tersedia. Sampai tersedia, dmarc_pass dan spam_score selalu null, dan authentication, yang mengikuti dmarc_pass, selalu unknown. Jangan lakukan routing berdasarkan dmarc_pass === true atau authentication === "pass" saat ini: tidak ada pesan yang memenuhi salah satu kondisi tersebut.

Untuk membatasi routing otomatis sekarang, syaratkan dkim_pass === true atau spf_pass === true, dan perlakukan false, null, serta nilai yang tidak ada sebagai belum terverifikasi. Kelulusan SPF dan DKIM tidak mengonfirmasi bahwa signing domain atau sending domain cocok dengan domain di header From yang terlihat. Gunakan keduanya untuk menyaring email yang tidak terautentikasi, bukan sebagai bukti siapa pengirimnya.

DMARC memeriksa keselarasan dengan domain di header From pesan. Field from di email.received berisi alamat header tersebut, dengan parsed sender dari relay dan kemudian envelope sender sebagai fallback jika header tidak dapat dibaca. Di email_mailbox.message_received, from berisi envelope sender, yang bisa berupa alamat bounce berbeda. Untuk routing kotak surat yang menggunakan pengirim yang terlihat, ambil metadata pesan yang diterima menggunakan message_id dari event. Kelulusan DMARC mengautentikasi sebuah domain; hal tersebut tidak membuktikan bahwa orang tertentu yang mengirim pesan.

Langkah selanjutnya

• Domain pengiriman: daftarkan dan verifikasi domain yang ingin Anda gunakan untuk menerima email.
• Webhook: endpoint, tanda tangan, dan coba lagi untuk email.received.
• Superagent: beri skor email yang diterima sebelum agen menindaklanjutinya.
• Log email: sisi pengiriman dari halaman Emails.