专为自主回复邮件的代理打造的 Mailbox API。
一个由代码掌控的真实收件箱。邮件以会话形式到达；您的代理通过 API 读取和回复。无需 IMAP，无需 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_…", … } }
用您已熟悉的语言进行地址申领、撰写和回复。
SDK、CLI 和托管 MCP 服务器使用同一套流程。
每种接入方式都运行相同的四个调用：申领地址、等待 webhook、读取新内容、回复。选择您的运行时，接口契约完全一致。
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.",
});
申领、接收、读取、回复。
完整流程只需四次调用。
地址从首次调用起即归您所有，在 inbox.ai 上它将永久保留给您的组织。无需轮询：步骤 02 是通过 webhook 触发的唤醒。示例使用纯 REST；SDK、CLI 和托管 MCP 服务器运行相同的流程。
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"
}
由您决定哪些邮件可以进入。
任何邮件都不会消失。
接收策略和按发件人规则针对信封发件人进行检查；阻止规则始终优先于允许规则。被发件人规则阻止的邮件会被静默存储——您仍然可以阅读它，但不会触发 webhook。（`drop` 策略会完全丢弃邮件，不进行存储。）
模型读取消息。
告别传统的回复方式。
每条消息都公开标头、HTML、原始源码和附件。您的智能体真正需要的字段是 extracted_text：去除引用后的新内容。上下文存在于会话线程中，而不是四十行引用文本里。
Mailboxes 的应用场景。
邮箱在第一天就能完成的四项任务。
由智能代理运行的支持收件箱。
每次对话都是一个会话线程；代理在线程内回复，并对不确定的内容添加标签，由人工监控跟进。
收件箱中的一切。
一览全貌。
收件箱 API。
一次调用即可获取地址：在 inbox.ai 上自动生成、自定义用户名或使用您自己的域名。
MCP 和 SDK。
为智能体提供托管的 MCP 服务器；SDK 和 CLI 满足其他一切需求。
会话线程和标签。
每个对话一个线程；Gmail 风格的标签，通过单个 PATCH 语法管理。
extracted_text.
去除引用后的新内容，可直接交给模型处理。
附件。
标头、HTML、原始源码和附件，全部通过 API 获取。
事件。
email_mailbox.* webhook 系列：message_received、thread_created、message_sent、message_delivered、message_failed。
接收规则。
一个策略加上按发件人的允许和阻止规则，针对信封发件人进行检查。
线程过滤器。
通过 API 按标签、参与者、主题或已读状态过滤每个收件箱的线程。
权限范围密钥。
mailbox 读写对话；mailbox_management 进行管理。
感知退订列表的发送。
回复声明营销或事务类型；退订列表按类别强制执行。
邮件到达。
您的代理被唤醒。
通过 Webhook 实现持久交付。只有进入收件箱的邮件才会分发到 webhook——垃圾邮件和被拦截的邮件将被静默存储。
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_received入站邮件已到达收件箱。email_mailbox.thread_created新对话已开启。email_mailbox.message_sent一封回复或撰写的邮件已从邮箱发出。email_mailbox.message_delivered接收服务器已接受。email_mailbox.message_failed投递失败；状态回写到消息上。
免费
免费
Startup
付费计划
Growth
付费计划
Enterprise
定制
邮箱（任意域名）
5
50 起
100 起
定制
自定义 @inbox.ai 地址
—
10 起
25 起
定制
Text and attachment retention
30 天
30 天
90 至 365 天
定制
共享邮箱存储
1.25 GB
起始 12.5 GB
起始 25 GB
定制
存储如何共享
整个组织共享一个统一的存储配额，所有活跃邮箱和可恢复邮箱均从中分配。
自动生成的 @inbox.ai 地址
在您的邮箱数量范围内不限量，所有套餐均免费
绑定自有域名的地址
任意地址，不占用配额
更长保留层级的存储内容
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.
删除后的恢复窗口
已删除的邮箱将进入 30 天恢复窗口。Inbox.ai 地址将永久保留给您的组织；自定义域名地址可在 30 天后由同一工作区重新绑定。
配额随您套餐的邮件发送量增长。降级不会影响已有邮箱：您已申领的地址将继续正常使用，只是在配额恢复之前无法申领新地址。
Put it into practice.
Continue with the documentation, guides and examples for this topic. Resources are in English.