Описание

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

Доступ сторонних приложений

Для корректной работы Studio Pro и вашего почтового клиента, в настройках почты должна быть включена опция, разрешающая работу сторонних приложений. В этой статье вы можете узнать больше об этой настройке (на примере Gmail). 

Считывание писем из папок и подпапок

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

• Входящие
  • Подпапка «входящих»
• Отправленные
• Важные
  • Подпапка «важных»
• Черновики

Если вы хотите считать письма именно из определенной папки, вам необходимо задать ее полное название через символ /, например: Входящие/{{Название подпапки}}

Обратите внимание, что в таком случае нужно прописывать оригинальное название папки. Если в вашем почтовом клиенте папка входящих называется «Inbox», то нужно прописать именно это название родительской папки. Например, если в папке «Inbox» находится папка «Работа», то в параметре «Имя папки с письмами» нужно прописать путь к папке так: Inbox/Работа

Как работать с учетными записями

Для того, чтобы запустить это действие, вам сначала должны ввести свои учетные данные.

Кнопка для добавления новых учетных записей.

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

Параметры

Хост и email

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

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

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

1. Custom: позволяет вручную выбрать протокол «IMAP» или «POP3», прописать адрес сервера в поле «Адрес сервера» и выбрать защищенное соединение.
   1. Secure connection — если этот флажок установлен, то подключение будет реализовано через TLS.
2. Yandex: применяются заданные по умолчанию настройки для сервера «Яндекс».
3. Google: применяются заданные по умолчанию настройки для сервера «Google».
4. Yahoo: применяются заданные по умолчанию настройки для сервера «Yahoo».
5. Mail.ru: применяются заданные по умолчанию настройки для сервера «Mail.ru».
6. iCloud: применяются заданные по умолчанию настройки для сервера «iCloud».
    

Дата начала

Если значение для параметра «Дата начала» отсутствует, будут считаны письма за последние 24 часа. 

1. Задать значение: позволяет в явном виде указать дату, с которой нужно считывать почтовые сообщения. При нажатии в соответствующее поле всплывает календарь, в котором можно вручную выбрать нужную дату.
2. Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для формирования даты, с которой нужно считывать сообщения.
3. Сохранить результат предыдущего шага: в качестве даты берет результат функции из предыдущего действия workflow.

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

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

Считывает только письма со статусом «Непрочитанное».

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

Считывает только письма, отмеченные как «Важные».

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

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

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

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

Извлекает письма с определенной темой.

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

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

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

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

Отправитель

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

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

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

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

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

Считывание групп сообщений

Некоторые почтовые сервисы (например, Gmail) отображают сообщения, сгруппированные по темам. При этом рядом с адресантом указывается количество сгруппированных сообщений.

Обратите внимание, что при считывании сообщений ботом отобразятся все сообщения по указанным фильтрам, в том числе и все сообщения из группы. Таким образом, если бы бот считал сообщения, показанные на скриншоте, то суммарно получилось бы шесть сообщений.

Вложения

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

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

Сохранять дубликаты

При использовании этой опции возможно сохранение нескольких файлов с одинаковыми названиями в одной папке. Так, второй и последующие файлы не будут перезаписывать первый, а сохранятся под новым названием — перед названием самого файла добавится дата в формате unix. 

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

Параметр доступен, только если выбрана опция «Загрузить вложения». Требуется указать папку, в которую будут загружены файлы. Также возможно указать {{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. Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для формирования папки.
    

Результат

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

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

Применение

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