Mailbox API untuk agen yang menjawab emailnya sendiri.
Kotak masuk nyata yang dimiliki kode Anda. Email masuk sebagai thread; agen Anda membaca dan membalas melalui API. Tanpa IMAP, tanpa parsing MIME.
# Claim an address on inbox.ai
curl -X POST https://us1.platform.bird.com/v1/email/mailboxes \
-H "Authorization: Bearer $BIRD_API_KEY" \
-d '{
"domain": "inbox.ai",
"local_part": "goldcrest",
"display_name": "Goldcrest Support"
}'
{
"id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
"address": "goldcrest@inbox.ai",
"receive_policy": "open",
"state": "active"
}
# Mail arrives; your webhook fires
POST /your-webhook-endpoint
{ "type": "email_mailbox.message_received", "data": { "thread_id": "thr_…", … } }
Klaim, tulis, dan balas dalam bahasa yang sudah Anda gunakan.
SDK, CLI, dan server MCP yang di-hosting semuanya menjalankan loop yang sama.
Setiap antarmuka menjalankan empat panggilan yang sama: klaim alamat, tunggu webhook, baca konten baru, dan balas. Pilih runtime Anda; kontraknya identik.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
// Claim an address on inbox.ai
const mailbox = await bird.email.mailboxes.create({
domain: "inbox.ai",
local_part: "support",
display_name: "Acme Support",
receive_policy: "open",
});
// Send a message from the mailbox
await bird.email.mailboxes.messages.create(mailbox.id, {
to: ["alice@example.com"],
subject: "Your request has been received",
text: "We'll get back to you within one business day.",
});
Klaim, terima, baca, balas.
Seluruh loop hanya empat panggilan.
Alamat menjadi milik Anda sejak panggilan pertama, dan di inbox.ai alamat tersebut dicadangkan secara permanen untuk organisasi Anda. Tidak ada polling: langkah 02 adalah pemicu, melalui webhook. Contoh-contoh ini menggunakan REST biasa; SDK, CLI, dan server MCP yang di-hosting menjalankan loop yang sama.
curl -X POST https://us1.platform.bird.com/v1/email/mailboxes \
-H "Authorization: Bearer $BIRD_API_KEY" \
-d '{"domain": "inbox.ai", "receive_policy": "open"}'
{
"id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
"address": "k7mq3vx2npr5wcj4tzh6@inbox.ai",
"state": "active"
}
curl -X POST https://us1.platform.bird.com/v1/email/mailboxes \
-H "Authorization: Bearer $BIRD_API_KEY" \
-d '{"domain": "inbox.ai", "receive_policy": "open"}'
{
"id": "mbx_01krdgeqcxet5s7t44vh8rt9mg",
"address": "k7mq3vx2npr5wcj4tzh6@inbox.ai",
"state": "active"
}
Anda yang menentukan apa yang masuk.
Tidak ada yang hilang.
Kebijakan penerimaan dan aturan per-pengirim dijalankan terhadap envelope sender; blokir selalu mengalahkan izinkan. Email yang diblokir oleh aturan pengirim disimpan secara diam-diam — Anda tetap bisa membacanya, dan tidak memicu webhook. (Kebijakan `drop` membuang email sepenuhnya dan tidak menyimpannya.)
Model membaca pesannya.
Bukan balasan yang lama.
Setiap pesan menampilkan header, HTML, sumber mentah, dan lampiran. Field yang benar-benar dibutuhkan agen Anda adalah extracted_text: konten baru, tanpa kutipan. Konteks ada di thread, bukan di empat puluh baris kutipan.
Apa saja kegunaan Mailboxes.
Empat tugas yang bisa dilakukan mailbox sejak hari pertama.
Inbox dukungan yang dijalankan oleh agen.
Setiap percakapan adalah sebuah thread; agen menjawab dalam thread dan menandai yang tidak pasti dengan label yang dipantau oleh manusia.
Semua yang ada di kotak masuk.
Seluruh permukaan dalam sekali pandang.
Inbox API.
Klaim alamat dalam satu panggilan: dibuat di inbox.ai, handle kustom, atau domain Anda sendiri.
MCP & SDK.
Server MCP ter-hosting untuk agen; SDK dan CLI untuk yang lainnya.
Thread & label.
Satu thread per percakapan; label bergaya Gmail dengan satu grammar PATCH.
extracted_text.
Konten baru, tanpa kutipan, siap diberikan ke model.
Lampiran.
Header, HTML, sumber mentah, dan lampiran, semuanya melalui API.
Event.
Keluarga webhook email_mailbox.*: message_received, thread_created, message_sent, message_delivered, message_failed.
Aturan penerimaan.
Kebijakan ditambah izinkan dan blokir per-pengirim, diperiksa terhadap envelope sender.
Filter thread.
Filter thread setiap mailbox berdasarkan label, peserta, subjek, atau status baca melalui API.
Kunci terbatas.
mailbox membaca dan menulis percakapan; mailbox_management mengelola.
Pengiriman sadar supresi.
Balasan dinyatakan sebagai marketing atau transaksional; daftar supresi diterapkan berdasarkan kategori.
Email masuk.
Agen Anda aktif.
Webhook untuk pengiriman yang andal. Hanya email yang masuk inbox yang diteruskan ke webhook — spam dan email yang diblokir disimpan secara diam-diam.
POST /your-webhook-endpoint HTTP/1.1
Content-Type: application/json
{
"type": "email_mailbox.message_received",
"timestamp": "2026-07-23T14:11:02Z",
"data": {
"thread_id": "thr_01krdh2p8qz3m9wv6xf0abcnde",
"message_id": "rem_01krdh3v7t2j5nqx8fw4mzp6bc"
}
}
email_mailbox.message_receivedEmail masuk mencapai kotak masuk.email_mailbox.thread_createdPercakapan baru dibuka.email_mailbox.message_sentBalasan atau pesan keluar dari kotak masuk.email_mailbox.message_deliveredServer penerima menerimanya.email_mailbox.message_failedPengiriman gagal; status dikembalikan ke pesan.
Harga
Mailbox sudah termasuk dalam paket Email Anda
Tidak ada langganan mailbox terpisah. Setiap paket email menyertakan mailbox dengan alamat @inbox.ai yang dibuat otomatis; paket berbayar menambahkan handle kustom.
Gratis
Gratis
Startup
Paket berbayar
Growth
Paket berbayar
Enterprise
Kustom
Mailbox (domain apa pun)
5
mulai dari 50
mulai dari 100
Kustom
Handle @inbox.ai kustom
—
mulai dari 10
mulai dari 25
Kustom
Text and attachment retention
30 hari
30 hari
90 hingga 365 hari
Kustom
Penyimpanan kotak surat bersama
1,25 GB
mulai dari 12,5 GB
mulai dari 25 GB
Kustom
Cara penyimpanan dibagikan
Satu kuota penyimpanan di seluruh organisasi digunakan bersama oleh setiap kotak surat yang aktif dan dapat dipulihkan.
Alamat @inbox.ai yang dibuat otomatis
Tidak terbatas sesuai jumlah mailbox Anda, gratis di setiap paket
Handle di domain Anda sendiri
Handle apa pun, tanpa menggunakan kuota
Yang disimpan oleh tier lebih panjang
A longer tier keeps message headers, extracted text, and attachments. Original bodies, received raw MIME, and forwarding are limited to 30 days on every plan. You can still read extracted text and reply with new content after that.
Jendela pemulihan setelah penghapusan
Mailbox yang dihapus memasuki jendela pemulihan selama 30 hari. Alamat Inbox.ai tetap dicadangkan secara permanen untuk organisasi Anda; alamat domain kustom dapat dihubungkan kembali oleh workspace yang sama setelah 30 hari.
Kuota bertambah seiring volume email paket Anda. Penurunan paket tidak akan merusak mailbox: handle yang sudah Anda klaim tetap berfungsi, Anda hanya tidak bisa mengklaim yang baru sampai kembali di bawah batas kuota.