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 domain pengiriman milik Anda yang sudah diaktifkan untuk penerimaan. 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.
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, keduanya diperiksa terhadap envelope sender, bukan header From: yang dapat dipalsukan:
- 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.
Email yang diblokir oleh aturan tetap disimpan di kotak surat dan tetap dapat dibaca. Email tersebut diarsipkan di luar inbox dan tidak mengirim webhook. Satu-satunya pengecualian adalah kotak surat 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 kotak surat 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 kotak surat mengontrol berapa lama Anda dapat membaca header pesan, teks hasil ekstraksi, dan lampiran kotak surat, 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 kotak surat. Tier yang tidak termasuk dalam paket Anda ditolak dengan E17048.
| Konten atau tindakan | Jendela retensi |
|---|---|
| Header pesan, teks hasil ekstraksi, dan lampiran kotak surat | Tier yang dipilih: 30, 90, atau 365 hari |
| Body HTML dan plain-text asli | 30 hari di semua tier |
| Raw MIME untuk pesan yang diterima | 30 hari di semua tier; pesan terkirim tidak menyimpan raw MIME |
| Meneruskan pesan di dashboard | Memerlukan konten asli dalam jendela 30 harinya |
| Membaca teks hasil ekstraksi atau membalas dengan konten baru | Tersedia selama pesan masih dipertahankan |
Sebagai contoh, pada hari ke-40 sebuah pesan di kotak surat 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 kotak surat besar. Hingga selesai, API mengembalikan E17050; coba lagi nanti.
Jika paket Anda menetapkan kuota penyimpanan kotak surat terbatas, satu kuota digunakan bersama oleh semua kotak surat yang aktif atau dapat dipulihkan. Setiap kotak surat melaporkan bagiannya sebagai size_bytes. Paket tanpa kuota terbatas memiliki penyimpanan kotak surat tak terbatas. Setelah semua kotak surat bersama-sama mencapai kuota terbatas, pengiriman ditolak dengan E17049 sampai Anda membebaskan ruang di salah satunya.
Menghapus kotak surat langsung menghentikan penerimaan email. Kotak surat dapat dipulihkan selama 30 hari, sementara kedaluwarsa retensi pesan tetap berjalan normal. Setelah 30 hari, penghapusan permanen menghapus kotak surat beserta pesan yang tersisa. Setelah penghapusan permanen dimulai, pemulihan ditolak meskipun pembersihan masih berlangsung. Alamat tetap direservasi untuk workspace Anda.
Langkah berikutnya
- Klaim kotak surat pertama Anda: jalur API dari pembuatan hingga balasan.
- Bangun dengan AI: jalankan kotak surat dari agen melalui server MCP.
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.
Tonton panduannyaGetting started with emailJelajahi kemampuannyaEmailIkuti jalur pembelajaranBuild your first integrationPanduan implementasiSend your first email
Coba praktiknya dan dapatkan ringkasan implementasi