获取邮件
指令说明
通过 IMAP 获取邮箱中的邮件,支持 QQ邮箱、163邮箱、126邮箱,也可以配置其他邮箱的 IMAP 服务器。
授权码不是邮箱登录密码,需要在邮箱设置中开启 IMAP/SMTP 服务后获取。
默认从收件箱 INBOX 中获取最近的邮件,可选择只获取未读邮件、获取后标记为已读、保存附件,或按发件人、收件人、主题、正文包含的文本进行筛选。
指令输入参数
| 输入参数 | 输入参数类型 | 说明 |
|---|---|---|
| 邮箱类型 | 枚举项 | QQ邮箱、163邮箱、126邮箱、其他邮箱 |
| IMAP服务器 | str | 邮箱类型为其他邮箱时需要,例如 imap.example.com |
| IMAP端口 | number 或 str | 邮箱类型为其他邮箱时需要,默认 993 |
| 邮箱账号 | str | 登录邮箱账号 |
| 授权码 | str | 邮箱授权码 |
| 邮件数量 | number 或 str | 最多获取的邮件数量,从最新邮件开始读取 |
| 仅未读邮件 | bool | True 时只获取未读邮件 |
| 保存附件 | bool | True 时保存邮件附件 |
| 附件保存目录 | str | 保存附件为 True 时需要 |
| 文件夹指定方式 | 枚举项 | 默认、动态指定 |
| 文件夹名称 | str | 文件夹指定方式为动态指定时需要,收件箱通常为 INBOX |
| 标记为已读 | bool | True 时获取后将邮件标记为已读 |
| 发件人包含 | str | 可选,为空时不筛选 |
| 收件人包含 | str | 可选,为空时不筛选 |
| 主题包含 | str | 可选,为空时不筛选 |
| 正文包含 | str | 可选,为空时不筛选 |
指令输出参数
| 输出参数 | 输出参数类型 | 说明 |
|---|---|---|
| 邮件列表 | list[map] | 每封邮件是一个映射,包含 subject、sender、receiver、cc、date、text、html、attachments、message_id |
生成注意
- 使用 IMAP 授权码,不是网页登录密码;仅“其他邮箱”需要填写 IMAP 服务器和端口。
- 保存附件为 True 时必须填写附件保存目录。