Inbound email API menerima email yang dikirim ke alamat atau domain milik Anda, mem-parse-nya, dan mengirimkannya ke aplikasi Anda sebagai HTTP POST terstruktur. Alih-alih menjalankan mail server dan melakukan polling mailbox melalui IMAP, Anda mengarahkan MX record domain Anda ke provider, dan setiap pesan masuk tiba di endpoint Anda dengan header, body, dan lampiran yang sudah di-parse menjadi JSON.
Bagaimana cara kerja inbound email?
Perutean dimulai dari DNS. Anda mengatur MX record untuk domain atau subdomain (misalnya reply.yourapp.com) agar mengarah ke mail server provider inbound. Ketika seseorang mengirim pesan ke alamat mana pun di domain tersebut, pesan itu mendarat di infrastruktur provider, bukan di infrastruktur Anda. Provider menerima pesan tersebut, mem-parse-nya, dan membuat request POST ke URL yang sudah Anda daftarkan, berisi konten yang sudah di-parse.
Payload yang sudah di-parse biasanya mencakup pengirim dan penerima, subjek, body plain-text dan HTML, kumpulan header lengkap, serta lampiran (biasanya di-encode base64 atau dirujuk melalui URL). Aplikasi Anda membaca JSON tersebut dan memprosesnya, tanpa kode SMTP atau IMAP yang perlu dikelola. Mekanisme pengirimannya adalah webhook, jadi aturan yang sama berlaku: respons dengan 2xx cepat, lalu proses pesan secara asinkron.
Untuk apa inbound email digunakan?
Inbound email mengubah pesan yang diterima menjadi event aplikasi. Pola umum meliputi:
- Penanganan balasan. Kirim notifikasi dari
notifications@yourapp.com, dan ketika pengguna membalas, balasan tersebut tiba sebagai POST sehingga Anda dapat menyambungkannya kembali ke dalam percakapan. - Tiket dukungan. Email ke
support@yourapp.commenjadi tiket baru, dengan pengirim dan isi yang langsung dipetakan ke help desk Anda. - Parse ke database. Tanda terima yang diteruskan atau email terstruktur di-parse dan ditulis ke tabel, tanpa entri manual.
- Email ke aksi. Pesan ke alamat khusus memicu workflow: membuat record, menjalankan job, atau mem-posting ke channel.
Apa bedanya dengan mengirim email?
Outbound dan inbound adalah tugas yang terpisah. Outbound adalah aplikasi Anda mengirim email ke penerima melalui SMTP atau HTTP send API. Inbound adalah kebalikannya: pengirim eksternal mengirim email ke aplikasi Anda. Integrasi email yang lengkap biasanya melakukan keduanya, mengirim notifikasi keluar dan menerima balasan masuk, tetapi keduanya dikonfigurasi secara terpisah dan sisi inbound-lah yang bergantung pada MX record Anda.
Mengapa tidak melakukan polling mailbox melalui IMAP saja?
Anda bisa menjalankan poller IMAP terhadap mailbox sungguhan, tetapi ada biaya berkelanjutan. Anda harus mengelola kredensial, menentukan seberapa sering melakukan polling (yang menambah latensi dan koneksi idle), mem-parse MIME mentah sendiri, dan melacak pesan mana yang sudah diproses. Inbound API menghilangkan sebagian besar itu: provider mem-parse MIME, mengirim setiap pesan satu kali sebagai JSON yang bersih, dan Anda merespons secara hampir real time. Untuk perbandingan protokol yang mendasarinya, lihat SMTP vs. IMAP.
Pertanyaan yang sering diajukan
Perubahan DNS apa yang diperlukan?
Anda mengatur MX record untuk domain atau subdomain tempat Anda ingin menerima email agar mengarah ke provider inbound Anda. Setelah propagasi, email ke alamat mana pun di domain tersebut mengalir ke provider, yang mem-parse-nya dan mem-posting-nya ke endpoint Anda. Menggunakan subdomain khusus menjaga perutean inbound tetap terpisah dari email domain utama Anda.
Bagaimana lampiran ditangani?
Payload yang sudah di-parse menyertakan lampiran, biasanya di-encode base64 secara inline atau sebagai URL yang Anda ambil secara terpisah. Handler Anda mendekode atau mengunduhnya dan menyimpannya di mana pun Anda menyimpan file. Lampiran yang lebih besar biasanya dirujuk melalui URL agar payload tetap kecil.
Apakah inbound email sama dengan webhook?
Pengirimannya menggunakan webhook: provider mengirim HTTP POST ke aplikasi Anda untuk setiap pesan. Perbedaannya adalah payload berisi email yang sudah di-parse sepenuhnya, bukan event generik. Perlakukan seperti webhook lainnya: verifikasi, respons dengan cepat, dan proses secara asinkron.
Untuk melihat bagaimana Bird menangani kedua arah email, mulai dengan ringkasan produk email dan panduan event email, yang membahas model pengiriman event yang menjadi dasar handler inbound Anda.