Получение почты

Используется для получения email-сообщений по протоколу IMAP.

Свойства

Секция «Подключение»

Способ подключения

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

Способ подключения: Параметры

Адрес сервера

Адрес (домен или IP-адрес) почтового сервера. Например, «imap.yandex.ru». Формат: «значение в кавычках» или выражение.

Порт

Порт почтового сервера. Например, 993. Формат: «значение в кавычках» или выражение.

Шифрование

Указывает использовать ли защищенное соединение (SSL) для подключения к почтовому серверу. Вариант «не использовать» сначала пробует соединиться используя технологию STARTTLS, при неуспехе пробует без шифрования.

Логин

Логин для авторизации на почтовом сервере. Как правило совпадает с адресом электронной почты. Формат: «значение в кавычках» или выражение.

Пароль

Пароль для авторизации на почтовом сервере. Как правило совпадает с паролем от адреса электронной почты. Формат: «значение в кавычках» или выражение.

Токен для подключения

Токен для подключения к почтовому серверу по протоколам помимо IMAP. На данный момент не используется.

Способ подключения: Строка подключения

Строка подключения

Строка подключения к почтовому серверу со всеми параметрами.

Секция «Критерии поиска писем»

Тип фильтра

Позволяет указать фильтры получаемых сообщений. Доступен набор предопределенных фильтров при выборе типа «Стандартный» и набор пользовательских фильтров при выборе типа «Расширенный».

Тип фильтра: Стандартный

Категория писем

Фильтрация получаемых писем по заранее определенным категориям. Доступные значения: «Все», «Отвеченные», «Черновик», «Удаленные», «Новые», «Недавние», «Непрочитанные», «Без флага».

Дата писем «от»

Фильтрация получаемых писем по дате получения. Задается начальная дата, относительно которой получается список писем. Дата в формате RFC или ISO. Для упрощенного ввода даты в ISO возможно использование метода toISOString() библиотеки moment js. Пример:

`2022-08-31T11:38:18.167Z` //Дата в формате ISO
`Fri, 29 Dec 1995 11:24:28` //Дата в формате RFC2822
moment( ‘08.20.2012’ ).toISOString() //Преобразование даты 20.08.2012 к формату ISO

Любое из значений выше можно ввести в поле.

Дата писем «до»

Фильтрация получаемых писем по дате получения. Задается конечная дата, до которой получается список писем. Формат даты RFC или ISO. Для упрощенного ввода даты в ISO возможно использование метода toISOString() библиотеки moment js. Пример:

`2022-08-31T11:38:18.167Z` //Дата в формате ISO
`Fri, 29 Dec 1995 11:24:28` //Дата в формате RFC2822
moment( ‘08.20.2012’ ).toISOString() //Преобразование даты 20.08.2012 к формату ISO

Любое из значений выше можно ввести в поле.

Отправитель

Фильтрация получаемых писем по электронной почте отправителя. Формат «значения в кавычках» или выражение.

Тема

Фильтрация писем по заданной теме. Поиск осуществляется по вхождению значения, указанного в поле.

Тип фильтра: Расширенный

Пользовательские фильтры

Массив флагов для поиска сообщений. Формат: https://www.npmjs.com/package/node-imap.

Секция «Правила получения письма»

Порядковый номер

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

Вложения

Получение вложений выбранного в предыдущем поле письма. Доступные варианты: «Не получать», «Получить ссылки», «Получить содержимое». Вложения: Не получать

При выборе этого значения вложения получаемого письма не будут получены. Вложения: Получить ссылки

При выборе этого значения вложения получаемого письма будут получены в виде массива с файлами. Формат вложений:

attachments: [
	{
		«filename»: `Имя_файла.расширение`,
		«contentType»: `тип_файла`,
		«size»: `размер_файла`,
		«fileId»: `идентификатор_файла`,
		«url»: `ссылка на файл`
	},

]

Вложения: Получить содержимое

При выборе этого значения вложения получаемого письма будут получены в виде значений файлового буфера. Формат вложений:

attachments: [
	{
		«filename»: `Имя_файла.расширение`,
		«contentType»: `тип_файла`,
		«size»: `размер_файла`,
		«content»: {
			«type»: «Buffer»,
			«data»: [ … ]
		}
	},

]

Отметить письмо прочитанным

Позволяет отметить полученное письмо как прочитанное. Варианты – «Да», «Нет».

Секция «Результат»

Сохранить письмо «в»

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

Сохранить количество найденных писем

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

Параметры подключения к популярным сервисам

Яндекс.Почта

  • Адрес сервера: «imap.yandex.ru»

  • Порт: 993

  • Шифрование: Использовать

  • Логин: полный адрес эл. почты (в кавычках)

  • Пароль: пароль приложения (в кавычках)

Gmail

  • Адрес сервера: «imap.gmail.com»

  • Порт: 993

  • Шифрование: Использовать

  • Логин: полный адрес эл. почты (в кавычках)

  • Пароль: пароль приложения (в кавычках)

Разрешения на получение почты через Бипиум

Для возможности получать письма через протокол IMAP нужно дать соответствующий доступ в настройках вашего почтового ящика. Настройки доступов для сервисов Яндекс.Почта и Gmail описаны ниже. Оба сервиса требуют использование пароля приложений вместо портального пароля.

Яндекс.Почта

Получения пароля приложения

  • Перейдите по адресу https://id.yandex.ru/security и авторизуйтесь под своей учетной записью.

  • На странице найдите секцию «Доступ к вашим данным» и перейдите на страницу «Пароли приложений»:

  • На открывшейся странице в секции «Создать пароль приложения» выберите «Почта»:

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

Разрешение на получение почты через IMAP

  • Войдите на сервис https://mail.yandex.ru и авторизуйтесь под своей учетной записью

  • Откройте страницу всех настроек вашей учетной записи:

  • Перейдите на страницу «Почтовые программы»:

  • Отметьте выделенный чек-бокс:

Gmail

Получения пароля приложения

  • Войдите на сервис https://gmail.com и авторизуйтесь своей учетной записью.

  • Кликните на иконку своего аккаунта и перейдите по ссылке «Управление аккаунтом Google»:

  • Перейдите на вкладку «Безопасность»:

  • В отделе «Вход в аккаунт Google» нажмите на пункт «Двухэтапная аутентификация». Завершите процесс настройки двухэтапной аутентификации, следуя подсказкам:

  • После завершения процесса настройки двухэтапной аутентификации вновь перейдите на вкладку «Безопасность» (п. 3 выше).

  • В отделе «Вход в аккаунт Google» нажмите на появившийся пункт «Пароли приложений»:

  • В окне создания пароля укажите приложение «Бипиум» и нажмите «Создать»:

  • Сохраните созданный пароль приложения и используйте его в качестве пароля в компоненте «Получение почты»:

Разрешение на получение почты через IMAP

  • Войдите на сервис https://gmail.com и авторизуйтесь своей учетной записью.

  • Нажмите на иконку шестеренки возле иконки учетной записи и перейдите по ссылке «Все настройки»:

  • Перейдите в отдел «Пересылка и POP/IMAP»:

  • Нажмите на «Включить IMAP»:

Last updated