专为自主回复邮件的代理打造的 Mailbox API。

一个由代码掌控的真实收件箱。邮件以会话形式到达；您的代理通过 API 读取和回复。无需 IMAP，无需 MIME 解析。

使用以下语言驱动

claim-mailbox.sh

REST

# 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_…", … } }

claim-mailbox.sh

REST

# 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.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.",
});

申领、接收、读取、回复。

完整流程只需四次调用。

地址从首次调用起即归您所有，在 inbox.ai 上它将永久保留给您的组织。无需轮询：步骤 02 是通过 webhook 触发的唤醒。示例使用纯 REST；SDK、CLI 和托管 MCP 服务器运行相同的流程。

POST /v1/email/mailboxes

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"
}

POST /v1/email/mailboxes

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` 策略会完全丢弃邮件，不进行存储。）

模型读取消息。
Not the old replies.

每条消息都公开标头、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

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投递失败；状态回写到消息上。

定价

邮箱随您的 Email 套餐一起提供

无需单独订阅邮箱。每个 Email 套餐都包含带有自动生成 @inbox.ai 地址的邮箱；付费套餐还支持自定义用户名。

免费领取邮箱查看 Email 定价

免费

Startup

$15/月起

Growth

$80/月起

Enterprise

定制

邮箱（任意域名）

50 起

100 起

定制

自定义 @inbox.ai 地址

—

10 起

25 起

定制

自动生成的 @inbox.ai 地址

在您的邮箱数量范围内不限量，所有套餐均免费

绑定自有域名的地址

任意地址，不占用配额

会话保留期

所有套餐均为 30 天

删除后的恢复窗口

已删除的邮箱将进入 30 天恢复窗口。Inbox.ai 地址将永久保留给您的组织；自定义域名地址可在 30 天后由同一工作区重新绑定。

配额随您套餐的邮件发送量增长。降级不会影响已有邮箱：您已申领的地址将继续正常使用，只是在配额恢复之前无法申领新地址。