# Leer correo

Tipo de nodo `browser_getEmail`

## Qué hace

Obtiene correos electrónicos según la configuración del buzón.

## Configuración en el cliente de escritorio

![Configuración del nodo "Leer correo" en el cliente de escritorio](/assets/get-email.f52d720148cf439f5e0dcbec30bab39988e3463e9882146c25511ce7a4679026.0538f3a9.webp)

Captura tomada en la interfaz en inglés de MoreLogin Desktop V2.73.101.

## Entradas

Estos campos van en `data.browserUi.inputs`.

| Campo | Tipo o valores | Obligatorio en el esquema | Valor predeterminado de ejecución | Descripción y límites |
|  --- | --- | --- | --- | --- |
| `user` | `string` | No | — | Cuenta de correo |
| `authType` | `"password"` / `"oauth2"` (admite referencias a variables) | No | `"password"` | Método de autorización. Valor inicial en el editor: `"password"` |
| `password` | `string` | No | — | Contraseña / código de autorización |
| `imapHost` | `string` | No | — | Servidor IMAP |
| `port` | `WorkflowNumber` | No | `993` | Puerto; entero en el rango 1–65535 después de la resolución. Valor inicial en el editor: `993` |
| `tls` | `boolean` (admite referencias a variables) | No | `true` | Habilitar TLS. Valor inicial en el editor: `true` |
| `clientId` | `string` | No | — | ID de cliente |
| `clientSecret` | `string` | No | — | Secreto de cliente |
| `refreshToken` | `string` | No | — | Token de actualización |
| `status` | `"UNSEEN"` / `"SEEN"` / `"ALL"` (admite referencias a variables) | No | `"UNSEEN"` | Estado del correo. Valor inicial en el editor: `"UNSEEN"` |
| `isJunk` | `boolean` (admite referencias a variables) | No | `false` | Buscar también en spam. Valor inicial en el editor: `false` |
| `seen` | `boolean` (admite referencias a variables) | No | `false` | Marcar como leído después de obtenerlo. Valor inicial en el editor: `false` |
| `from` | `string` | No | — | Filtro de remitente |
| `mailTo` | `string` | No | — | Filtro de destinatario |
| `subject` | `string` | No | — | El asunto contiene |
| `keyword` | `string` | No | — | Palabra clave del cuerpo |
| `dateType` | `"all"` / `"today"` / `"recent"` (admite referencias a variables) | No | `"all"` | Fecha del correo. Valor inicial en el editor: `"all"` |
| `reg` | `string` | No | — | Expresión regular de extracción |


## Requisitos y límites por modo

- Obligatorios: `user`, `imapHost`, `port`
- imapHost es un nombre de host; port es un entero en el rango 1–65535.
- Código de validación: `RPA_NODE_INPUT_INVALID`


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

- Obligatorio: `password`
- El valor es una contraseña o un código de autorización del buzón.
- Código de validación: `RPA_NODE_INPUT_INVALID`


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

- Obligatorios: `clientId`, `refreshToken`
- Este modo solo admite IMAP de Outlook/Hotmail. Un refresh_token de Microsoft se canjea por un access_token, y el refresh_token rotado se almacena en caché localmente de forma cifrada. clientSecret es opcional (las aplicaciones cliente públicas no lo necesitan).
- Código de validación: `RPA_NODE_INPUT_INVALID`
- El nodo establece una conexión IMAP real y lee el correo más reciente que coincide con los filtros. El modo password usa una contraseña o un código de autorización y funciona con cualquier host IMAP. OAuth2 y "Buscar también en spam" solo se admiten en Outlook/Hotmail (outlook.office365.com, imap-mail.outlook.com); los demás hosts devuelven MAIL_PROVIDER_UNSUPPORTED. imapHost solo recibe el nombre del host, sin puerto ni ruta. Los últimos tres días son hoy y los dos días anteriores, según la hora local de la computadora que realiza la ejecución. Cuando reg está definido, se devuelve el primer grupo de captura o la coincidencia completa. Si el correo más reciente no coincide, se devuelve null, sin recurrir a correos más antiguos. Cuando reg no está definido, extractedValue es el cuerpo. seen=true solo marca como leído el correo seleccionado. message.receivedAt es la hora en que se recibió el correo (hora local del cliente de escritorio, YYYY-MM-DD HH:mm:ss). Si hay más de 10000 candidatos en una carpeta, se devuelve MAIL_SEARCH_LIMIT; si un solo correo supera los 10 MiB, se devuelve MAIL_MESSAGE_LIMIT, y un fallo de conexión/autenticación devuelve MAIL_CONNECTION_FAILED (no se exponen el texto original del servidor ni las credenciales). No se admiten POP3, el envío de correo ni la descarga de adjuntos.
- Código de validación: `RPA_NODE_INPUT_INVALID`


## Referencias de entrada

| Campo | Formas permitidas |
|  --- | --- |
| `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` |


## Salidas

| Campo de salida | Tipo o valores |
|  --- | --- |
| `found` | `boolean` |
| `message` | `object` / `null` |
| `extractedValue` | `string` / `null` |


Haz referencia a los campos publicados como `${nodeId.data.field}`.

## Ejemplo JSON

Un objeto de nodo completo para el array `nodes` de un flujo de trabajo o para los `blocks` de otro nodo. `mailPassword` es un parámetro inicial privado declarado en `workflow.variables`.

```json
{
  "id": "read_code_email",
  "type": "browser_getEmail",
  "data": {
    "title": "Read the verification email",
    "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"
      }
    }
  }
}
```

[Volver al catálogo de nodos](/es/browser-rpa/nodes)