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.mailbox.create({
domain: "inbox.ai",
local_part: "support",
display_name: "Acme Support",
receive_policy: "open",
});
// Send a message from the mailbox
await bird.mailbox.compose(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.
Not the old replies.
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
$0
Startup
dari $15/bln
Growth
dari $80/bln
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
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
Retensi thread
30 hari di setiap paket
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.