Перейти до вмісту

Прочитати пошту

Тип вузла browser_getEmail

Призначення

Отримує листи за налаштуваннями поштової скриньки.

Налаштування в настільному клієнті

Налаштування вузла «Прочитати пошту» в настільному клієнті

Знімок екрана зроблено в англійському інтерфейсі MoreLogin Desktop V2.73.101.

Вхідні дані

Ці поля розміщуються в data.browserUi.inputs.

ПолеТип або значенняОбов'язкове за схемоюЗначення за замовчуванням під час виконанняОпис і обмеження
userstringНі—Обліковий запис пошти
authType"password" / "oauth2" (підтримує посилання на змінні)Ні"password"Спосіб авторизації. Початкове значення в редакторі: "password"
passwordstringНі—Пароль / код авторизації
imapHoststringНі—Сервер IMAP
portWorkflowNumberНі993Порт; ціле число 1–65535 після розв'язання. Початкове значення в редакторі: 993
tlsboolean (підтримує посилання на змінні)НіtrueУвімкнути TLS. Початкове значення в редакторі: true
clientIdstringНі—Ідентифікатор клієнта
clientSecretstringНі—Секрет клієнта
refreshTokenstringНі—Токен оновлення
status"UNSEEN" / "SEEN" / "ALL" (підтримує посилання на змінні)Ні"UNSEEN"Стан листа. Початкове значення в редакторі: "UNSEEN"
isJunkboolean (підтримує посилання на змінні)НіfalseШукати також у спамі. Початкове значення в редакторі: false
seenboolean (підтримує посилання на змінні)НіfalseПозначати як прочитаний після отримання. Початкове значення в редакторі: false
fromstringНі—Фільтр за відправником
mailTostringНі—Фільтр за одержувачем
subjectstringНі—Тема містить
keywordstringНі—Ключове слово в тексті листа
dateType"all" / "today" / "recent" (підтримує посилання на змінні)Ні"all"Дата листа. Початкове значення в редакторі: "all"
regstringНі—Регулярний вираз для вилучення

Вимоги до режимів і обмеження

  • Обов'язкові поля: 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

Посилання у вхідних даних

ПолеДозволені форми
userliteral, template
authTypeliteral, template
passwordliteral, template
imapHostliteral, template
portliteral, template
tlsliteral, template
clientIdliteral, template
clientSecretliteral, template
refreshTokenliteral, template
statusliteral, template
isJunkliteral, template
seenliteral, template
fromliteral, template
mailToliteral, template
subjectliteral, template
keywordliteral, template
dateTypeliteral, template
regliteral, template

Вихідні дані

Поле вихідних данихТип або значення
foundboolean
messageobject / null
extractedValuestring / null

Посилайтеся на опубліковані поля у форматі ${nodeId.data.field}.

Приклад JSON

Повний об'єкт вузла для масиву 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"
      }
    }
  }
}

Назад до каталогу вузлів