可编程邮箱机器人

解决什么问题

给 AI 智能体发邮件，通常是整个工作流里最脆弱的一环：身份不真实、回信串不上线程、回调难以调试、送达率无人负责。mailbot 不把人类收件箱包装一层来应付这个问题，而是给智能体一套独立的、面向程序化调用的邮箱基础设施。

核心能力

• 真实邮箱身份：智能体拥有可编程的邮箱地址，而不是借用某个人的收件箱。
• 线程感知：Thread 模型把同一会话的往来邮件聚合成时间线，保证回复落在原线程内。
• 一个 API 面：认证、账户、API 密钥、收件箱、消息、线程、webhook、送达与互动跟踪、合规、审计、用量统计，统一在 https://getmail.bot/v1 之下。
• 沙箱优先接入：默认使用共享沙箱域 @mailbot.id，地址形如 {username}--{accountShortId}@mailbot.id；自定义域名等流程生产就绪后再配置。
• 自有 MTA：宣称 99/100 送达率。
• 安全加固：webhook 上的 SSRF 防护、限流失败即关闭（fail-closed）、严格访问门控。

典型用法与步骤

1. 通过邮箱 OTP 完成注册，拿到 API 密钥。
2. 创建一个 Inbox，得到程序化邮箱身份。
3. 用同一 API 发送、接收、跟踪消息，并按 Thread 组织会话。
4. 用 webhook 触发入站邮件动作，投递或互动异常时重放事件用于调试与恢复。
5. 用 API 密钥和审计接口程序化管理访问与全量邮件活动。

注意点

• 它为智能体通信工作流而构建，不适合当作人类收件箱的替代品。
• 自定义域名不是默认路径，首次成功应先在共享沙箱域上完成。
• 注册与接入细节需参考 references/mcp-setup.md 等文档，MCP Server、Node.js、Python 三种路径都要考虑。
• Beta 期间的默认值（base URL、沙箱域、地址模式）可能调整。