Mailbox agen

Mailbox agen adalah inbox beralamat yang dikelola kode Anda melalui API. Baca dan filter thread-nya, balas pesan, atau tulis email baru tanpa menjalankan server IMAP atau mem-parsing raw MIME.

Mailbox berada di domain bersama inbox.ai atau di salah satu domain pengiriman milik Anda. Alamatnya diklaim saat Anda membuatnya dan tetap milik Anda: local part dicadangkan untuk workspace Anda dan tidak pernah diberikan ke siapa pun, bahkan setelah Anda menghapus mailbox tersebut.

Alamat

Setiap mailbox memiliki satu alamat, {local_part}@inbox.ai. Anda mendapatkan alamat dengan dua cara:

• Generated: abaikan local part dan kami akan membuat local part yang unik untuk Anda (a7f3k2@inbox.ai). Selalu tersedia.
• Custom: minta local part tertentu (support@inbox.ai). Handle custom bersifat unik secara global, siapa cepat dia dapat, dan merupakan jatah paket berbayar; workspace gratis menggunakan alamat generated.

Alamat tidak dapat diubah setelah dibuat. Untuk menggantinya, buat mailbox baru dan hapus yang lama. Local part lama ditahan selama 30 hari (jendela pemulihannya) sebelum dapat diklaim kembali, dan tetap dicadangkan untuk workspace Anda.

Di domain Anda sendiri, berikan domain saat membuat mailbox dan pilih local part apa pun, misalnya support@acme.com. Cara email sampai ke mailbox bergantung pada pengaturan domain:

• Receiving diaktifkan: email langsung masuk setelah record MX domain mengarah ke kami. Lihat Menerima email.
• Receiving tidak diaktifkan: kepemilikan domain harus terverifikasi, dan record MX Anda tetap seperti semula. Mailbox mendapatkan forwarding_address, misalnya k7q2mzxw4h6p5ra3@eu1.inbound.bird.com. Tambahkan aturan penerusan untuk support@acme.com di penyedia email Anda saat ini yang mengarah ke alamat tersebut. Email yang diteruskan masuk ke mailbox, sedangkan balasan dan email baru tetap dikirim dari support@acme.com.

Untuk mailbox domain sendiri yang sudah ada tanpa alamat penerusan, buka Mailbox settings lalu pilih Set up forwarding. Alamat mailbox, pesan, receive policy, dan retensi tetap tidak berubah. Anda memerlukan izin tulis pengelolaan mailbox dan kepemilikan domain yang terverifikasi di workspace. Domain yang sudah diklaim untuk penerimaan oleh workspace lain tidak bisa mendapatkan alamat penerusan baru di sini.

Padanan API adalah POST /v1/email/mailboxes/{mailbox_id}/forwarding-address, tanpa body permintaan. Permintaan ini mengembalikan mailbox lengkap beserta forwarding_address-nya. Mengulang permintaan mengembalikan alamat yang sama, termasuk setelah penghapusan dan pemulihan; permintaan ini tidak merotasi alamat atau melanjutkan mailbox yang ditangguhkan. Perintah CLI adalah bird email mailboxes forwarding-address create <mailbox-id>.

Membuat alamat tidak mengonfigurasi penerusan di penyedia Anda, tidak mengubah DNS, dan tidak memverifikasi pengiriman. Jika penyedia Anda sudah menerima email, pertahankan record MX-nya dan tambahkan aturan penerusan di sana. Jika record MX mengarah ke kami, siapkan dulu mailbox dan aturan penerusan di penyedia Anda, lalu pindahkan record MX ke penyedia tersebut. Biarkan Receiving tetap aktif selama perubahan DNS menyebar. Uji penerusan sebelum mematikan penerimaan langsung.

Gmail dan Google Workspace mengirim pesan konfirmasi ke alamat penerusan baru. Buka pesan itu di mailbox ini dan ikuti petunjuk konfirmasinya untuk menyelesaikan pengaturan. Microsoft 365 mungkin mengharuskan administrator mengizinkan penerusan eksternal. Dengan kebijakan replies_only atau allowlist, periksa email yang diblokir; periksa juga Spam dan receive rules. Kebijakan drop tidak menyimpan konfirmasi: ubah kebijakan secara eksplisit sebelum meminta konfirmasi baru. Mailbox yang ditangguhkan harus dilanjutkan agar dapat menerima pesan secara normal.

Simpan salinan di penyedia Anda selama pengujian. Kirim pesan baru dari akun lain ke alamat mailbox asli, lalu buka pesan yang diterima di mailbox ini. Alamat Delivered to-nya harus sama dengan forwarding_address untuk membuktikan pengiriman melalui rute tersebut. API menampilkannya sebagai delivered_to. Jumlah pesan mailbox mencakup aktivitas keluar sehingga tidak memverifikasi penerusan.

Untuk kembali ke pengiriman langsung, aktifkan Receiving, pulihkan record MX kami, dan uji pengiriman langsung sebelum menghapus aturan penerusan di penyedia Anda. Rute yang tumpang tindih, seperti dual delivery Google Workspace, dapat membuat setiap pesan masuk dua kali ke mailbox. Alamat penerusan tetap berfungsi saat penerimaan langsung dimatikan dan tetap sama setelah penghapusan dan pemulihan.

Thread dan pesan

Email yang diterima dan dikirim dikelompokkan ke dalam thread, satu per percakapan. Thread memiliki alamat-alamat yang terlibat, jumlah belum dibaca, arah pesan terakhirnya (inbound atau outbound), dan timestamp aktivitas terbaru. Balasan masuk ke thread yang dijawabnya; penulisan baru memulai thread baru.

Setiap pesan memperlihatkan header, teks polos yang diekstrak dengan riwayat kutipan dihapus, dan lampiran. Body asli tersedia selama 30 hari; raw MIME hanya tersedia untuk pesan yang diterima. ID pesan diawali berdasarkan arah: rem_ untuk pesan yang diterima, em_ untuk pesan yang Anda kirim.

Menentukan apa yang masuk

Dua kontrol berada di depan inbox:

• Receive policy: default seluruh mailbox.
  • open menerima email setelah aturan blokir diterapkan. Hasil SPF dan DKIM tidak mengubah kebijakan penerimaan ini.
  • replies_only hanya menerima email yang melanjutkan thread yang sudah ada di mailbox.
  • allowlist hanya menerima pengirim yang diizinkan aturan Anda, ditambah balasan ke thread yang sudah ada.
  • drop membuang semuanya, tanpa pengecualian.
• Receive rules: entri izinkan atau blokir per pengirim, dicocokkan berdasarkan alamat lengkap atau domain (aturan domain juga cocok dengan subdomainnya). Blokir selalu mengalahkan izinkan.

Aturan blokir dicocokkan dengan envelope sender atau alamat From:. Aturan izinkan dicocokkan dengan envelope sender, atau dengan alamat From: jika pesan memiliki tanda tangan DKIM yang valid dari domain alamat tersebut. Header From: mudah dipalsukan, sehingga From: tanpa tanda tangan tidak pernah lolos aturan izinkan. Ini mencakup email yang diteruskan, saat Gmail dan Microsoft 365 mengganti envelope sender dengan alamat mereka sendiri, serta email dari layanan pengiriman yang memakai alamat bounce terpisah. Email yang diteruskan tanpa tanda tangan DKIM yang masih utuh tetap dicocokkan dengan alamat layanan penerusan.

Email yang diblokir oleh aturan tetap disimpan di mailbox dan tetap dapat dibaca. Email tersebut diarsipkan di luar inbox dan tidak mengirim webhook. Satu-satunya pengecualian adalah mailbox yang disetel ke drop, yang membuang semua email langsung tanpa mengarsipkannya.

Pengiriman

Mailbox mengirim dengan dua cara melalui API: reply ke pesan (pesan keluar masuk ke thread tersebut) atau compose pesan baru (yang membuka thread baru). Di dashboard, buka pesan dan pilih Forward untuk mengirim body asli dan lampirannya ke penerima baru, dalam jendela 30 hari konten asli. Email dikirim dari alamat mailbox itu sendiri, dengan display name dan default Reply-To yang Anda konfigurasikan. Status pengiriman ditambahkan kembali ke pesan terkirim, sehingga Anda dapat melihat apakah balasan berhasil dikirim atau bounce.

Event

Berlangganan keluarga webhook email_mailbox.* untuk menjalankan agen tanpa polling: email_mailbox.message_received (email masuk sampai di inbox), email_mailbox.thread_created, dan event status pengiriman untuk pesan yang Anda kirim. Hanya email inbox yang diteruskan; spam dan email yang diblokir aturan disimpan tanpa notifikasi, sehingga mailbox yang kebanjiran tidak memperbanyak webhook. Email inbox juga memicu event standar email.received, sehingga integrasi inbound yang sudah ada tetap berfungsi. Kedua event membawa hasil autentikasi. Periksa field tersebut sebelum routing otomatis: masuknya email ke inbox saja tidak berarti pengirim sudah terverifikasi.

Retensi dan penghapusan

Tier retensi mailbox mengontrol berapa lama Anda dapat membaca header pesan, teks hasil ekstraksi, dan lampiran mailbox, dihitung sejak pengiriman atau penerimaan. Default-nya adalah 30 hari. Jika paket Anda mencakup retensi 90 hari atau 365 hari, atur retention_tier saat membuat atau memperbarui mailbox. Tier yang tidak termasuk dalam paket Anda ditolak dengan E17048.

Sebagai contoh, pada hari ke-40 sebuah pesan di mailbox 90 hari masih memiliki teks hasil ekstraksi yang dapat dibaca dan dicari, serta lampiran yang dipertahankan. Anda dapat membalas dengan konten baru, tetapi tidak dapat membuka body asli, mengunduh raw MIME-nya, atau meneruskannya. Teks hasil ekstraksi dibatasi 64 KiB per pesan dan dapat menghilangkan sebagian konten asli. Lampiran yang disimpan sebelum retensi lampiran diperpanjang diaktifkan tetap menggunakan kedaluwarsa aslinya sekitar 31 hari; mengubah tier tidak memigrasikannya. Menaikkan tier tidak dapat memulihkan konten yang sudah dihapus.

Pesan berhenti dikembalikan oleh API saat retensinya kedaluwarsa. Proses penghapusan berjalan di latar belakang setiap jam; pembersihan fisik dapat tertinggal dari kedaluwarsa API.

Menurunkan tier langsung berlaku pada pembacaan: apa pun yang lebih lama dari batas baru langsung berhenti dikembalikan. Anda memiliki sepuluh menit untuk membatalkannya, dan sepuluh menit adalah satu-satunya jaminan: naikkan tier kembali dalam jendela tersebut dan tidak ada yang hilang. Setelah lewat, pesan yang tertinggal menjadi layak dihapus dan proses penghapusan per jam berikutnya mengambilnya, sehingga menaikkan tier setelahnya hanya memulihkan pesan yang belum dijangkau proses tersebut.

Menaikkan ke tier yang termasuk dalam paket Anda diterima kapan saja, termasuk saat perubahan sebelumnya masih diterapkan. Pembaruan latar belakang tidak bergantung pada jendela pembatalan sepuluh menit. Penurunan kedua diterima setelah perubahan pertama selesai memperbarui setiap pesan yang tersimpan. Pembaruan dimulai setiap sepuluh menit dan bisa memakan waktu berjam-jam untuk mailbox besar. Hingga selesai, API mengembalikan E17050; coba lagi nanti.

Jika paket Anda menetapkan kuota penyimpanan mailbox terbatas, satu kuota digunakan bersama oleh semua mailbox yang aktif atau dapat dipulihkan. Setiap mailbox melaporkan bagiannya sebagai size_bytes. Paket tanpa kuota terbatas memiliki penyimpanan mailbox tak terbatas. Setelah semua mailbox bersama-sama mencapai kuota terbatas, pengiriman ditolak dengan E17049 sampai Anda membebaskan ruang di salah satunya.

Menghapus mailbox langsung menghentikan penerimaan email. Mailbox dapat dipulihkan selama 30 hari, sementara kedaluwarsa retensi pesan tetap berjalan normal. Setelah 30 hari, penghapusan permanen menghapus mailbox beserta pesan yang tersisa. Setelah penghapusan permanen dimulai, pemulihan ditolak meskipun pembersihan masih berlangsung. Alamat tetap dicadangkan untuk workspace Anda.

Langkah berikutnya

• Klaim mailbox pertama Anda: jalur API dari pembuatan hingga balasan.
• Bangun dengan AI: jalankan mailbox dari agen melalui server MCP.