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 semua email yang lolos autentikasi.
- 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 aturan, atau yang gagal DMARC, tetap disimpan di mailbox dan dapat dibaca: email tersebut diarsipkan di luar inbox, bukan dibuang, dan tidak memicu webhook. Satu-satunya pengecualian adalah mailbox yang disetel ke drop, yang membuang semuanya 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
Subscribe ke keluarga webhook email_mailbox.* untuk menjalankan agen tanpa polling: email_mailbox.message_received (email masuk sampai ke 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 dibanjiri tidak memperbanyak menjadi banjir webhook. Email inbox juga memicu event standar email.received, sehingga integrasi inbound yang sudah ada tetap berfungsi.
Untuk tampilan langsung tanpa infrastruktur webhook, hubungkan ke GET /v1/email/mailboxes/{mailbox_id}/events. Stream SSE mengirimkan tipe event, thread ID, dan message ID untuk aktivitas mailbox, termasuk spam dan email yang diblokir. Ambil pesan lengkap dengan ID tersebut. Stream tidak memutar ulang event setelah terputus. Gunakan webhook untuk pengiriman yang tahan lama, dan gunakan endpoint daftar untuk mengejar ketertinggalan setelah jeda.
Retensi dan penghapusan
Tier retensi mailbox mengontrol berapa lama Anda dapat membaca header pesan, teks yang diekstrak, 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. Tier yang tidak termasuk dalam paket Anda ditolak dengan E17048.
| Konten atau tindakan | Jendela retensi |
|---|---|
| Header pesan, teks yang diekstrak, dan lampiran mailbox | Tier yang dipilih: 30, 90, atau 365 hari |
| Body HTML asli dan teks polos | 30 hari di semua tier |
| Raw MIME untuk pesan yang diterima | 30 hari di semua tier; pesan terkirim tidak memiliki raw MIME tersimpan |
| Meneruskan pesan di dashboard | Memerlukan konten asli dalam jendela 30 harinya |
| Membaca teks yang diekstrak atau membalas dengan konten baru | Tersedia selama pesan masih diretensi |
Sebagai contoh, pada hari ke-40 sebuah pesan di mailbox 90 hari masih memiliki teks yang diekstrak yang dapat dibaca dan dicari, serta lampiran yang diretensi. Anda dapat membalas dengan konten baru, tetapi tidak dapat membuka body asli, mengunduh raw MIME-nya, atau meneruskannya. Teks yang diekstrak dibatasi 64 KiB per pesan dan dapat menghilangkan bagian dari aslinya. Lampiran yang disimpan sebelum retensi lampiran diperpanjang diaktifkan tetap memiliki kedaluwarsa asli sekitar 31 hari; mengubah tier tidak memigrasikannya. Menaikkan tier tidak dapat memulihkan konten yang sudah dihapus.
Pesan berhenti dikembalikan oleh API saat retensinya kedaluwarsa. Pembersihan per jam memproses penghapusan di latar belakang; pembersihan fisik dapat tertinggal dari kedaluwarsa API.
Menurunkan tier langsung berlaku pada pembacaan: apa pun yang lebih lama dari batas baru berhenti dikembalikan seketika. 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 itu, pesan yang terdampar menjadi layak dihapus dan pembersihan per jam berikutnya mengambilnya, sehingga kenaikan tier yang terlambat hanya memulihkan apa pun yang belum dijangkau pembersihan.
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 memperbarui setiap pesan yang tersimpan. Pembaruan dimulai setiap sepuluh menit dan dapat memakan waktu berjam-jam untuk mailbox besar. Sampai selesai, API mengembalikan E17050; coba lagi nanti.
Jika paket Anda menetapkan jatah penyimpanan mailbox terbatas, satu jatah digunakan bersama oleh setiap mailbox yang aktif atau dapat dipulihkan. Setiap mailbox melaporkan bagiannya sebagai size_bytes. Paket tanpa jatah terbatas memiliki penyimpanan mailbox tak terbatas. Setelah mailbox secara keseluruhan mencapai jatah 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 normal tetap berjalan. Setelah 30 hari, penghapusan permanen menghapus mailbox dan pesan-pesan yang tersisa. Setelah penghapusan permanen dimulai, pemulihan ditolak meskipun pembersihan masih berlangsung. Alamat tetap dicadangkan untuk workspace Anda.
Langkah selanjutnya
- Klaim mailbox pertama Anda: jalur cepat API dari pembuatan hingga balasan.
- Bangun dengan AI: jalankan mailbox 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