Тип узла: browser_getEmail
Получает письма по заданным настройкам почтового ящика.

Снимок сделан в английском интерфейсе MoreLogin Desktop V2.73.101.
Эти поля указываются в data.browserUi.inputs.
| Поле | Тип или значения | Обязательно по схеме | По умолчанию при выполнении | Описание и ограничения |
|---|---|---|---|---|
user | string | Нет | — | Почтовый аккаунт |
authType | "password" / "oauth2" (поддерживает ссылки на переменные) | Нет | "password" | Способ авторизации. Начальное значение в редакторе: "password" |
password | string | Нет | — | Пароль / код авторизации |
imapHost | string | Нет | — | Сервер IMAP |
port | WorkflowNumber | Нет | 993 | Порт; после вычисления целое число 1–65535. Начальное значение в редакторе: 993 |
tls | boolean (поддерживает ссылки на переменные) | Нет | true | Включить TLS. Начальное значение в редакторе: true |
clientId | string | Нет | — | ID клиента |
clientSecret | string | Нет | — | Секрет клиента |
refreshToken | string | Нет | — | Токен обновления |
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 - Этот режим поддерживает только IMAP Outlook/Hotmail. refresh_token Microsoft обменивается на 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}.
Полный объект узла для массива nodes сценария или для blocks другого узла. mailPassword является приватным начальным параметром, объявленным в workflow.variables.
{
"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"
}
}
}
}