邮箱入门
更新: 2026/8/2 字数: 0 字 时长: 0 分钟
$mail 是 Bot.js Pro 提供的邮件自动化模块。
它基于 JavaMail 构建，支持 SMTP、IMAP 等标准邮件协议，可直接连接 QQ 邮箱、163 邮箱、Gmail、Outlook、企业邮箱等主流邮件服务。
无需安装 Outlook、Foxmail、Thunderbird 等邮件客户端，也无需打开邮箱网页版，即可在脚本中完成邮件的收发、管理和自动化处理。
功能特性
Mail 模块提供了完整的邮件操作能力。
- 📤 发送邮件
- 📥 接收邮件
- 📂 管理邮件文件夹
- 🔍 搜索邮件
- 📎 下载和发送附件
- 💬 回复邮件
- ↪️ 转发邮件
- ⭐ 标记星标
- 📖 标记已读 / 未读
- 🗑 删除邮件
- 📝 草稿管理
- 👥 联系人解析
- 🖼 内嵌图片邮件（HTML）
- 📧 MIME 邮件解析
- 🔐 SSL / STARTTLS 加密连接
自动化能力
相比传统邮件客户端，$mail 更适合自动化脚本开发。
您可以轻松实现：
- 自动收取验证码邮件
- 自动提取注册链接或激活链接
- 自动解析订单通知
- 自动处理企业工作流邮件
- 自动回复指定邮件
- 自动转发邮件
- 定时发送邮件
- 批量发送营销邮件
- 根据主题、发件人、附件等条件自动筛选邮件
- 将邮件与 Bot.js Pro 自动化流程无缝结合
通过与 Bot.js Pro 的其他模块配合，可以构建完整的邮件自动化解决方案，而无需任何邮件客户端参与。
核心对象及集合类
Mail 模块主要包含以下几个核心对象。
| 对象 | 说明 | 集合类 |
|---|---|---|
Mail | 邮箱连接对象，所有操作的入口 | 无 |
MailFolder | 邮件文件夹，如收件箱、草稿箱、已发送等 | MailFolderCollection |
MailMessage | 单封邮件对象，包含正文、附件、发件人等信息 | MailMessageCollection |
MailBuilder | 邮件构建器，用于发送、回复、转发邮件 | 无 |
MailAttachment | 邮件附件 | MailAttachmentCollection |
MailAddress | 单个邮件地址（含 address 和 personal） | MailAddressCollection 由 MailMessage 的 to()、cc()、bcc() 等方法返回） |
说明：
- 第一列类型名称全部添加了跳转链接。
- “返回类型（集合）”列中的集合类型也添加了跳转。
- 锚点与 API 文档中的章节 ID 保持一致，确保跳转正确。
支持的邮箱
支持所有兼容 SMTP / IMAP 协议的邮箱。
例如：
- QQ 邮箱
- QQ 企业邮箱
- 网易 163
- 网易 126
- Gmail
- Outlook
- Hotmail
- Live
- Yahoo Mail
- iCloud Mail
- Zoho Mail
- Yandex Mail
- Exchange（兼容 SMTP / IMAP）
- 企业邮箱
- ...
以及其他兼容标准邮件协议的邮件服务。
继续阅读以下文档，了解如何获取邮箱授权码并使用完整 API。