# 获取邮件

节点类型 `browser_getEmail`

## 功能说明

按配置的邮箱设置获取邮件。

## 客户端配置界面

![获取邮件节点的客户端配置界面](/assets/get-email.f52d720148cf439f5e0dcbec30bab39988e3463e9882146c25511ce7a4679026.0538f3a9.webp)

截图来自 MoreLogin 桌面客户端 V2.73.101 的英文界面。

## 输入字段

以下字段位于 `data.browserUi.inputs`。

| 字段 | 类型或取值 | Schema 必填 | 执行默认值 | 说明与边界 |
|  --- | --- | --- | --- | --- |
| `user` | `string` | 否 | — | 邮箱账号 |
| `authType` | `"password"` / `"oauth2"`（支持变量引用） | 否 | `"password"` | 授权方式 编辑器初值 `"password"` |
| `password` | `string` | 否 | — | 密码 / 授权码 |
| `imapHost` | `string` | 否 | — | IMAP 服务器 |
| `port` | `WorkflowNumber` | 否 | `993` | 端口; integer 1–65535 after resolution 编辑器初值 `993` |
| `tls` | `boolean`（支持变量引用） | 否 | `true` | 启用 TLS 编辑器初值 `true` |
| `clientId` | `string` | 否 | — | Client ID |
| `clientSecret` | `string` | 否 | — | Client Secret |
| `refreshToken` | `string` | 否 | — | Refresh Token |
| `status` | `"UNSEEN"` / `"SEEN"` / `"ALL"`（支持变量引用） | 否 | `"UNSEEN"` | 邮件状态 编辑器初值 `"UNSEEN"` |
| `isJunk` | `boolean`（支持变量引用） | 否 | `false` | 同时搜索垃圾邮件 编辑器初值 `false` |
| `seen` | `boolean`（支持变量引用） | 否 | `false` | 读取后标记已读 编辑器初值 `false` |
| `from` | `string` | 否 | — | 发件人筛选 |
| `mailTo` | `string` | 否 | — | 收件人筛选 |
| `subject` | `string` | 否 | — | 主题包含 |
| `keyword` | `string` | 否 | — | 正文关键词 |
| `dateType` | `"all"` / `"today"` / `"recent"`（支持变量引用） | 否 | `"all"` | 邮件时间 编辑器初值 `"all"` |
| `reg` | `string` | 否 | — | 提取正则 |


## 条件与边界

- 必填 `user`, `imapHost`, `port`
- imapHost 为主机名；port 为 1–65535 整数。
- 校验错误码 `RPA_NODE_INPUT_INVALID`


**`authType` `eq` `"password"`**

- 必填 `password`
- 密码或邮箱授权码。
- 校验错误码 `RPA_NODE_INPUT_INVALID`


**`authType` `eq` `"oauth2"`**

- 必填 `clientId`, `refreshToken`
- 仅 Outlook/Hotmail IMAP；使用 Microsoft refresh_token 换取 access_token，轮换后的 refresh_token 加密缓存在本机。clientSecret 可选（公共客户端应用不需要）。
- 校验错误码 `RPA_NODE_INPUT_INVALID`
- 真实连接 IMAP 读取最新一封符合筛选的邮件。password 模式使用密码或授权码，适用任意 IMAP 主机；OAuth2 与同时搜索垃圾邮件仅支持 Outlook/Hotmail（outlook.office365.com、imap-mail.outlook.com），其他主机返回 MAIL_PROVIDER_UNSUPPORTED。imapHost 只填主机名，不含端口或路径。最近三天为执行机本地今天及前两天。配置 reg 时返回第一个捕获组或完整匹配，最新邮件未匹配返回 null，不回退到更早邮件；未配置 reg 时 extractedValue 为正文。seen=true 仅将选中邮件标记已读。message.receivedAt 为邮件接收时间（客户端本地时间 YYYY-MM-DD HH:mm:ss）。单文件夹候选超过 10000 封返回 MAIL_SEARCH_LIMIT，单封超过 10 MiB 返回 MAIL_MESSAGE_LIMIT，连接/认证失败返回 MAIL_CONNECTION_FAILED（不透出服务器原文或凭证）。不支持 POP3、发信或附件下载。
- 校验错误码 `RPA_NODE_INPUT_INVALID`


## 输入引用

| 字段 | 允许的形式 |
|  --- | --- |
| `user` | `literal`, `template` |
| `authType` | `literal`, `template` |
| `password` | `literal`, `template` |
| `imapHost` | `literal`, `template` |
| `port` | `literal`, `template` |
| `tls` | `literal`, `template` |
| `clientId` | `literal`, `template` |
| `clientSecret` | `literal`, `template` |
| `refreshToken` | `literal`, `template` |
| `status` | `literal`, `template` |
| `isJunk` | `literal`, `template` |
| `seen` | `literal`, `template` |
| `from` | `literal`, `template` |
| `mailTo` | `literal`, `template` |
| `subject` | `literal`, `template` |
| `keyword` | `literal`, `template` |
| `dateType` | `literal`, `template` |
| `reg` | `literal`, `template` |


## 输出字段

| 输出字段 | 类型或取值 |
|  --- | --- |
| `found` | `boolean` |
| `message` | `object` / `null` |
| `extractedValue` | `string` / `null` |


按契约用 `${nodeId.data.field}` 引用公开字段。

## JSON 示例

可放入流程 `nodes` 数组或其他节点 `blocks` 中的完整节点对象。`mailPassword` 是在 `workflow.variables` 中声明的私密初始化参数。

```json
{
  "id": "read_code_email",
  "type": "browser_getEmail",
  "data": {
    "title": "读取验证邮件",
    "browserAction": "getEmail",
    "browserUi": {
      "inputs": {
        "user": "user@example.com",
        "authType": "password",
        "password": "${mailPassword}",
        "imapHost": "imap.example.com",
        "port": 993,
        "tls": true,
        "status": "UNSEEN",
        "from": "no-reply@example.com",
        "dateType": "today",
        "reg": "\\b(\\d{6})\\b"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

[返回节点目录](/zh/browser-rpa/nodes)