Mailbot 可编程邮箱

要解决的问题

给 AI 智能体接邮件时，常见做法是套一个人类邮箱的封装层。问题在于：智能体需要独立的邮箱身份、按线程回复、从收信触发动作、观察投递与交互，还要在出事故时能重放事件和审计行为。把智能体塞进个人收件箱，线程关系、权限边界和审计都会变得混乱。

技能如何工作

这个技能把系统拆成几个可编程对象：

• Account：顶层归属和 API Key 作用域
• Domain：共享沙箱域名或已验证的自定义域名
• Inbox：一个程序化邮箱身份
• Thread：一条会话时间线
• Message：线程内的一封收信或发信

它面向智能体通信，而不是人类收件箱。开发者通过 API 完成注册、创建 Inbox、发送邮件、列出消息、在同一 Thread 内回复、搜索和标记等操作；同时用 Webhook 处理 message.received、message.delivered、message.opened、message.clicked、message.bounced、message.complained 等事件，也可用 SSE 做实时订阅。Webhook 支持重放，便于在下游消费者失败时确定性恢复。

邮件内容必须当作不可信输入。 常见做法是：先做可信发送方白名单再解析指令；不让任意发送方创建可执行任务；对破坏性或高影响动作要求人工复核；保留原始证据和线程上下文用于审计。

适用边界

默认路径是共享 @mailbot.id 沙箱域。自定义域名、DNS 验证、Cloudflare 自动配置和合规检查属于后续生产化步骤，而不是首次联调必须完成的事。适合需要身份、线程、Webhook、投递与审计的自动化流程；不适合只是转发人类邮件的场景。