Описание
Это действие позволяет считать письма электронной почты начиная с указанной даты. При добавлении данного действия на рабочую область автоматически добавляется действие «Сохранить значение в переменную». Это действие не является обязательным, его можно удалить.
Доступ сторонних приложений
Для корректной работы Studio Pro и вашего почтового клиента, в настройках почты должна быть включена опция, разрешающая работу сторонних приложений. В этой статье вы можете узнать больше об этой настройке (на примере Gmail).
Считывание писем из папок и подпапок
С помощью этого действия можно считывать письма из любых папок и подпапок в почтовом клиенте. Как правило, в почтовом клиенте иерархия нескольких папок, например:
- Входящие
- Подпапка «входящих»
- Отправленные
- Важные
- Подпапка «важных»
- Черновики
Если вы хотите считать письма именно из определенной папки, вам необходимо задать ее полное название через символ /
, например:
Входящие/{{Название подпапки}}
Обратите внимание, что в таком случае нужно прописывать оригинальное название папки. Если в вашем почтовом клиенте папка входящих называется «Inbox», то нужно прописать именно это название родительской папки. Например, если в папке «Inbox» находится папка «Работа», то в параметре «Имя папки с письмами» нужно прописать путь к папке так:
Inbox/Работа
Как работать с учетными записями
Для того, чтобы запустить это действие, вам сначала должны ввести свои учетные данные.
Кнопка для добавления новых учетных записей.
В данной статье детально описан процесс работы с учетными записями.
Параметры
Хост и email
Кликните на выпадающий список чтобы выбрать необходимую пару хост/логин. Далее начните вводить имя хоста или логина для того, чтобы данная пара (адрес электронной почты) отобразилась в начале списка.
Настройки сервера
Позволяет указать настройки сервера, который используется для почтовых сообщений.
- Custom: позволяет вручную выбрать протокол «IMAP» или «POP3», прописать адрес сервера в поле «Адрес сервера» и выбрать защищенное соединение.
- Secure connection — если этот флажок установлен, то подключение будет реализовано через TLS.
- Yandex: применяются заданные по умолчанию настройки для сервера «Яндекс».
- Google: применяются заданные по умолчанию настройки для сервера «Google».
- Yahoo: применяются заданные по умолчанию настройки для сервера «Yahoo».
- Mail.ru: применяются заданные по умолчанию настройки для сервера «Mail.ru».
- iCloud: применяются заданные по умолчанию настройки для сервера «iCloud».
Дата начала
Если значение для параметра «Дата начала» отсутствует, будут считаны письма за последние 24 часа.
- Задать значение: позволяет в явном виде указать дату, с которой нужно считывать почтовые сообщения. При нажатии в соответствующее поле всплывает календарь, в котором можно вручную выбрать нужную дату.
- Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для формирования даты, с которой нужно считывать сообщения.
- Сохранить результат предыдущего шага: в качестве даты берет результат функции из предыдущего действия workflow.
Фильтр по статусу
Только непрочитанные
Считывает только письма со статусом «Непрочитанное».
Только помеченные
Считывает только письма, отмеченные как «Важные».
Из определённой категории (только Gmail)
Извлекает письма, имеющие определённую категорию (тег).
Фильтр по содержимому
Тема содержит
Извлекает письма с определенной темой.
- Задать значение: позволяет вручную написать ключевое слово для темы письма.
- Сохранить результат предыдущего шага: в качестве ключевого слова берет результат действия из предыдущего шага workflow.
- Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания ключевого слова.
Письмо содержит
Извлекает письма, содержащие в теле (тексте) письма определённое значение.
- Задать значение: позволяет вручную ключевое слово для тела письма.
- Сохранить результат предыдущего шага: в качестве ключевого слова берет результат действия из предыдущего шага workflow.
- Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания ключевого слова.
Отправитель
Извлекает письма, пришедшие от определенного отправителя.
- Задать значение: позволяет вручную указать отправителя письма.
- Сохранить результат предыдущего шага: в качестве отправителя берет результат действия из предыдущего шага workflow.
- Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для указания отправителя.
Содержит вложения?
Извлекает письма, в зависимости от наличия вложений.
- Все: извлекает все письма, вне зависимости от наличия вложений.
- Содержит вложение: извлекает письма, имеющие вложения.
- Не содержит вложений: извлекает письма, не имеющие вложений.
Считывание групп сообщений
Некоторые почтовые сервисы (например, Gmail) отображают сообщения, сгруппированные по темам. При этом рядом с адресантом указывается количество сгруппированных сообщений.
Обратите внимание, что при считывании сообщений ботом отобразятся все сообщения по указанным фильтрам, в том числе и все сообщения из группы. Таким образом, если бы бот считал сообщения, показанные на скриншоте, то суммарно получилось бы шесть сообщений.
Вложения
Загрузить вложения
Позволяет скачать вложения изо всех считываемых писем за указанный период.
Сохранять дубликаты
При использовании этой опции возможно сохранение нескольких файлов с одинаковыми названиями в одной папке. Так, второй и последующие файлы не будут перезаписывать первый, а сохранятся под новым названием — перед названием самого файла добавится дата в формате unix.
Шаблон пути к каталогу
Параметр доступен, только если выбрана опция «Загрузить вложения». Требуется указать папку, в которую будут загружены файлы. Также возможно указать {{keyword}}
в пути для сохранения вложений, где keyword
- один из ниже перечисленных параметров:
from
- отправитель,to
- получатель,cc
- те кто указан в копии,date
- дата отправки письма,messageId
- уникальный идентификатор письма,dateTime
- дата время отправки в формате ISO,dateTimeMs
- дата и время отправки в формате unixTime,receivedDateTime
- дата время получения письма в формате ISO,receivedDateTimeMs
- дата и время отправки в формате unixTime.
При добавлении ключевых слов робот автоматически создает подпапки с датой или темой соответствующего письма. Можно указать несколько ключевых слов.
- Задать значение: позволяет в явном виде указать путь к папке, например,
C:\ElectroNeek\
илиC:\ElectroNeek\{{date}}\{{subject}}
. - Сохранить результат предыдущего шага: в качестве папки берет результат функции из предыдущего действия workflow.
- Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для формирования папки.
Имя папки с письмами
Если нужно прочитать письма из вложенной папки, то путь нужно задавать при помощи |
. Например, есть папка «Входящие» в которой есть подпапка «1С». Путь к папке «1С» нужно задавать таким образом: Входящие|1С
.
- Задать значение: позволяет в явном виде указать путь к папке, откуда требуется считать почтовые сообщения.
- Сохранить результат предыдущего шага: в качестве наименования папки берет результат действия из предыдущего действия workflow.
- Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для задания имени папки.
Emails Limit
Данный параметр принимает только неотрицательные целые числа и позволяет ограничить количество писем, которые должны быть обработаны ботом. Например, если “Emails Limit” равен пяти, то бот обработает только первые пять писем.
- Задать значение: позволяет вручную установить количество писем, которые должны быть обработаны ботом.
- Сохранить результат предыдущего шага: позволяет воспользоваться особой формулой или специальным методом для определения количества писем, которые должны быть обработаны ботом.
- Вычислить значение: принимает результат действия из предыдущего шага рабочего процесса как количество писем, которые должны быть обработаны ботом.
Download original
Если вы поставите галочку в данном поле, все загруженные письма будут иметь новый {{keyword}}
параметр — original
, который содержит тело электронного письма в исходном HTML формате.
Mark as read
Поставьте галочку в данном поле, чтобы отметить все электронные письма, обработанные ботом, как прочитанные.
Move to folder
Эта опция позволяет переместить прочитанные письма в определенную папку электронной почты.
- Задать значение: позволяет вручную указать папку, куда нужно переместить письма.
- Вычислить значение: позволяет воспользоваться особой формулой или специальным методом для определения названия папки.
- Сохранить результат предыдущего шага: принимает результат действия из предыдущего шага рабочего процесса как количество писем, которые должны быть обработаны ботом.
Комментарий
Позволяет добавить поясняющий текст к блоку. Текст будет отображаться внутри блока сверху от названия действия.
Результат
По умолчанию считанные письма хранятся в переменной 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": "Путь ко второму вложению"
}
],
}
]
bcc
. В этих случаях bcc
не может быть получен.Применение
Данное действие подходит во всех случаях, когда робот должен считывать почтовые сообщения. Например, можно робота настроить таким образом, чтобы пришедшее на почту сообщение определенного формата являлось сигналом к выполнению какого-либо фрагмента workflow.