Прочитать письма

Описание

Считывает письма электронной почты с указанной даты. При добавлении данного действия в рабочее пространство автоматически добавляется действие "Сохранить значение в переменную". При необходимости действие "Сохранить значение в переменную" можно удалить.

Ниже приведён пример использования настройки и использования действия для считывания почты Gmail, после считывания писем действием данным письмам автоматически ставится статус "Прочитано".

Параметры

Хост и email

Кликните на выпадающий список чтобы выбрать необходимую пару хост/логин. Далее начните вводить имя хоста или логина для того, чтобы данная пара отобразилась в начале списка.

Настройки сервера

Позволяет указать настройки сервера, который используется для почтовых сообщений.

  1. Custom: позволяет вручную выбрать протокол "IMAP" или "POP3", прописать адрес сервера в поле "Адрес сервера" и выбрать защищенное соединение.

  2. Yandex: применяются заданные по умолчанию настройки для сервера "Яндекс".

  3. Google: применяются заданные по умолчанию настройки для сервера "Google".

  4. Yahoo: применяются заданные по умолчанию настройки для сервера "Yahoo".

  5. Mail.ru: применяются заданные по умолчанию настройки для сервера "Mail.ru".

  6. iCloud: применяются заданные по умолчанию настройки для сервера "iCloud".

Дата начала

Если значение для параметры "Дата начала" отсутствует, считывание писем происходит за последние 24 часа.

  1. Задать значение: позволяет в явном виде указать дату, с которой нужно считывать почтовые сообщения. При нажатии в соответствующее поле всплывает календарь, в котором можно вручную выбрать нужную дату.

  2. Сохранить результат предыдущего шага: в качестве даты берет результат функции из предыдущего действия workflow.

  3. Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для формирования даты, с которой нужно считывать сообщения.

Фильтр по статусу

Только непрочитанные

Извлекает только письма со статусом "Непрочитанное".

Только помеченные

Извлекает только письма, отмеченные как "Важные" (см. скриншоты)

Иконка помеченного письма в Gmail
Иконка помеченного письма в Яндекс.Почта

Из определённой категории (только Gmail)

Извлекает письма, имеющие определённую категорию (тег).

Пример созданной категории

Фильтр по содержимому

Тема содержит

Извлекает письма, содержащие определённую тему.

  1. Задать значение: позволяет в явном виде указать ключевое слово для темы письма.

  2. Сохранить результат предыдущего шага: в качестве ключевого слова берет результат действия из предыдущего шага workflow.

  3. Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания ключевого слова.

Письмо содержит

Извлекает письма, содержащие в теле (тексте) письма определённое значение.

  1. Задать значение: позволяет в явном виде указать ключевое слово для тела письма.

  2. Сохранить результат предыдущего шага: в качестве ключевого слова берет результат действия из предыдущего шага workflow.

  3. Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания ключевого слова.

Отправитель

Извлекает письма, пришедшие от определённого отправителя.

  1. Задать значение: позволяет в явном виде указать отправителя письма.

  2. Сохранить результат предыдущего шага: в качестве отправителя берет результат действия из предыдущего шага workflow.

  3. Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для указания отправителя.

Содержит вложения?

Извлекает письма, в зависимости от наличия вложений.

  1. Все: извлекает все письма, вне зависимости от наличия вложений.

  2. Содержит вложение: извлекает письма, имеющие вложения.

  3. Не содержит вложений: извлекает письма, не имеющие вложений.

Вложения

Загрузить вложения

Позволяет скачать вложения изо всех считываемых писем за указанный период.

Шаблон пути к каталогу

Параметр доступен, только если выбрана опция "Загрузить вложения". Требуется указать папку, в которую будут загружены файлы. Также возможно указать {{keyword}} в пути для сохранения вложений, где keyword - один из ниже перечисленных параметров:

  • from - отправитель,

  • to- получатель,

  • cc - те кто указан в копии,

  • date - дата отправки письма,

  • messageId - уникальный идентификатор письма,

  • dateTime- дата время отправки в формате ISO,

  • dateTimeMs - дата и время отправки в формате unixTime,

  • receivedDateTime- дата время получения письма в формате ISO,

  • receivedDateTimeMs - дата и время отправки в формате unixTime.

При добавлении ключевых слов робот автоматически создает подпапки с датой или темой соответствующего письма. Можно указать несколько ключевых слов.

  1. Задать значение: позволяет в явном виде указать путь к папке, например, C:\ElectroNeek\ или C:\ElectroNeek\{{date}}\{{subject}}.

  2. Сохранить результат предыдущего шага: в качестве папки берет результат функции из предыдущего действия workflow.

  3. Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для формирования папки.

Имя папки с письмами

  1. Задать значение: позволяет в явном виде указать путь к папке, откуда требуется считать почтовые сообщения.

  2. Сохранить результат предыдущего шага: в качестве наименования папки берет результат действия из предыдущего действия workflow.

  3. Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания имени папки.

Комментарий

Позволяет добавить поясняющий текст к блоку. Текст будет отображаться внутри блока сверху от названия действия.

Результат

По умолчанию считанные письма хранятся в переменной email_messages. Данная переменная представляет из себя массив объектов, где каждый объект соответствует одному письму. Объект содержит следующие ключи и значения:

Поля одного объекта из массива объектов переменной, хранящей почтовые сообщения
{
"textPlain": "Текст письма, который передает сервер",
"text": "Текст письма, обработанный html-парсером",
"attachments": [
{
"path": "Путь к первому вложению"
},
{
"path": "Путь ко второму вложению"
}
],
"subject": "Здесь содержится тема письма",
"to": [
{
"name": "Имя получателя",
"address": "почта получателя"
}
],
"replyTo": [
{
"name": "Имя, кому ответить",
"address": "почта, кому ответить"
}
],
"receivedDate": "Дата получения письма",
"date": "Дата отправления письма",
"from": [
{
"name": "Имя отправителя",
"address": "почта отправителя"
}
]
}

Рекомендации к использованию

Данное действие подходит во всех случаях, когда робот должен считывать почтовые сообщения. Например, можно робота настроить таким образом, чтобы пришедшее на почту сообщение определенного формата являлось сигналом к выполнению какого-либо фрагмента workflow.

Возможные ошибки и их устранение