Источник: получение вложений из почты IMAP

Источник Почта IMAP подключается к почтовому ящику, ищет подходящее письмо и забирает из него файл или ссылку. Это удобно, когда поставщики регулярно присылают прайсы, остатки или каталоги письмами.

Скриншот настроек IMAP-источника в Eofferix — В блоке подключения задаются IMAP-сервер, папка и правила поиска писем.

Какие данные нужны

Почтовый сервис или свой IMAP-сервер.
Шифрование и порт, если они отличаются от пресета.
Email и пароль. Для Gmail, Яндекс Почты, Mail.ru и многих других сервисов обычно нужен пароль приложения, а не основной пароль от аккаунта.
Папка, в которой Eofferix будет искать письма.

Как настроить подключение

Создайте источник и выберите тип Почта IMAP.
Выберите почтовый сервис из списка или укажите параметры вручную.
Заполните email, пароль и папку. Обычно это INBOX.
Нажмите Проверить доступ. После успешной проверки откроются правила поиска писем и файлов.

Пароль приложения

Пароль приложения - это отдельный пароль для доступа по IMAP. Его создают в настройках безопасности почтового ящика и при необходимости отзывают без смены основного пароля аккаунта. Если в почте включена двухфакторная защита, обычный пароль от аккаунта чаще всего не подойдет.

Как выбрать нужное письмо

Письмо подходит, когда совпадают все заполненные условия. Если поле оставить пустым, оно не ограничивает поиск.

Какие письма смотреть - только непрочитанные или все письма в папке.
Тема - можно искать по полному совпадению, части темы или маске. В маске * означает любую последовательность символов, ? - один символ. Несколько значений через запятую работают как «или»: Прайс*, *остатки*.
Отправитель - помогает отделить письма поставщика от остальных. Можно указать email, имя отправителя или маску, например supplier@example.com или *@supplier.ru.
Вложение - маска имени файла, например price*.xlsx или *.csv.
Ссылка в письме - используется, если поставщик присылает не вложение, а ссылку на файл. Проверяется полный URL; можно использовать маски вроде https://*/price*.xml или *.xlsx.

Типичные причины ошибки

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

Если подключение или фильтры писем не удается настроить, техподдержка Eofferix поможет проверить IMAP-доступ, папку, маски и правила поиска.