入站邮件 API

将收到的邮件 转化为应用可执行的操作。

通过转发地址或您控制的子域名接收邮件。Bird 会解析收到的邮件,让您的应用读取内容和附件,并通过 email.received webhook 做出响应。在 Email API 上构建支持工单接收、回复处理和文档工作流。

创建账户,然后添加接收地址并连接您的应用。

Bird Email API 的一部分

从邮件到事件

接收工作流

AL
Alex Lee

收件人:support@inbound.example.com

这是已签署的文件。

感谢您的帮助。我已附上填写完成的副本。

PDF signed-document.pdf
email.received

Webhook

发件人

邮件正文

附件

示意消息与事件。您的 Webhook 处理程序将检索并处理收到的邮件。

邮件接收是如何工作的?

选择邮件到达的位置,然后决定应用如何处理。转发地址让您无需更改 DNS 即可尝试接收邮件。使用您自己的子域名接收,让客户可以直接向您控制的地址发送邮件。解析后的邮件可在仪表板和入站消息 API 中查看。

从您已有的收件箱开始。

在 Bird 中创建转发地址,并将其设置为现有收件箱或客服系统的转发目标。Bird 会接收转发的邮件并存储其解析内容。这让您在更改域名路由之前就能完成首次集成。

使用您控制的子域名接收。

注册并验证专用的接收子域名,启用接收功能,然后发布提供的 MX 记录。使用类似 inbound.example.com 的子域名,使接收设置与企业邮箱路由保持独立。接收指南详细介绍了域名检查步骤。

为您的应用提供所需的邮件内容。

读取发件人、收件人、主题、正文和附件,并使用 webhook 触发应用工作流。验证 webhook 签名并按照文档中的事件约定处理重试。如果您的代理需要支持持续对话和回复的地址,请了解 Agent Mailboxes。

开始前的常见问题

试用入站邮件需要更改我的域名吗?
不需要。创建一个 Bird 转发地址,并从现有收件箱转发邮件。当您希望邮件直接发送到您控制的子域名时,请使用域名接收。
我可以在自己的域名上接收邮件吗?
可以。注册并验证一个专用子域名,启用接收功能并发布其提供的 MX 记录。使用接收子域名,将企业邮件路由与之分开。
我的应用程序如何获知收到的邮件?
订阅 email.received Webhook,或通过入站消息 API 读取消息。处理事件时请遵循 Webhook 验证和重试指南。
入站邮件与 Agent Mailboxes 有什么区别?
入站邮件解析到达转发地址或接收域名的消息,供您的应用程序处理。Agent Mailboxes 提供由代理拥有的收件箱,支持消息线程和回复工作流。

将下一封回复转化为有效操作。

设置接收地址,检查收到的邮件并将其连接到您的应用。

创建账户,然后添加接收地址并连接您的应用。

从一个渠道开始。
准备好后,再添加其他渠道。

测试 API 密钥即刻可用。添加支付方式并验证发送者身份后,即可解锁生产环境。

正在使用 Claude Code、Cursor 或 Codex?复制一条设置提示,您的智能代理即可自动安装 Bird CLI 和相关技能。选择您的工具:

Cursor