Все ноды/Integrations/Email

Получить письма

Получает письма из почтового ящика по критериям (UNSEEN, ALL, FROM ...). Возвращает список писем с заголовками и телом. Требует Email Config.

Получить письма▶

Email ConfigSuccess

Error

Тип в графе: fetch_emails

Exec

Можно включить ветку ошибки (expose_error_output) и обработать сбой отдельным путём.

Как попробовать

Минимальный рабочий воркфлоу

Вход

Получить письма▶

Настройка Email

Выход▶

Исполнение
Данные
Исполнение + данные

Нажмите «Скопировать ноды», откройте редактор и нажмите Ctrl+V на холсте.

Перед запуском выберите своё подключение или базу знаний — в графе стоит REPLACE_ME.

Как применять

Нода читает почтовый ящик по расписанию или по вебхуку и отдаёт письма дальше по графу как данные: заявки в CRM, входящие обращения, уведомления сервисов. Выбор писем задаёте вы, а не модель; если решение «что искать» должно принимать агент, подключите к нему Инструмент email.

Как это работает

Поле «Что получать» собирает выражение поиска за вас: «Только непрочитанные», «Все письма», «От отправителя», «Начиная с даты» и «Сырое выражение IMAP» для случаев, которые не покрыты первыми четырьмя. Ниже появляется ровно то поле, которое нужно выбранному режиму.

Выход — список emails (новые сверху), число total_fetched и имя папки mailbox. У каждого письма есть uid, subject, sender, recipients, date, body_text, body_html и is_read. Тело берётся из первой текстовой части письма; вложения нода не скачивает — их содержимого в выходе нет.

Всё это про IMAP. Подключение по POP3 не умеет ни папок, ни поиска, ни флагов: нода вернёт последние письма ящика, а поля «Почтовый ящик», «Что получать» и «Пометить как прочитанное» останутся без эффекта, и mailbox в выходе будет пустым.

Частые ошибки

«Только непрочитанные» с выключенным «Пометить как прочитанное». Ящик открывается только на чтение, прочитанными письма никто не помечает — и каждый запуск приносит те же самые письма снова.
Ожидание отката. При включённой отметке письма помечаются прочитанными в момент чтения, даже если следующая нода упадёт. Повторно они уже не придут.
uid как вечный ключ. Это позиция письма в папке на момент чтения, а не постоянный идентификатор: письма удаляют, и номера сдвигаются. Для дедупликации между запусками надёжнее заголовок письма из body_text/subject + date или собственная отметка.
Больше сотни писем за раз. «Макс. количество» ограничено сотней; за остальным нужен следующий запуск или более узкий отбор.
Дата в произвольном формате. «Начиная с даты» принимает 2026-07-01 или 01-Jul-2026, всё остальное — ошибка.

Входы

Порт	Провод	Данные	Примечания
Email Config`email_config`	Данные`data`	—	обязателен

Выходы

Порт	Провод	Данные	Примечания
Success`output`	Исполнение + данные`execute_data`	`object`
Error`on_error`	Исполнение + данные`execute_data`	—	показывается, когда expose_error_output = true

Настройки

Поле	Тип	По умолчанию	Описание
Email-подключение`connection_id`	`string`	`""`	Сохранённое email-подключение воркспейса — простому графу не нужна отдельная нода Email Config. Нода, подключённая к порту 'email_config', имеет приоритет над этим полем. подключение: emailперекрывается портом: email_config
Почтовый ящик`mailbox`	`string`	`INBOX`	Почтовый ящик/папка, откуда получать письма. Только для IMAP — у POP3 нет папок, он всегда читает входящие.
Макс. количество`max_count`	`integer`	`10`
Что получать`criteria_mode`	`string`	`unseen`	Какие письма выбирать. Только для IMAP — POP3 всегда возвращает самые свежие письма. Варианты: `unseen` — Только непрочитанные, `all` — Все письма, `from` — От отправителя, `since` — Начиная с даты, `raw` — Сырое выражение IMAP
Отправитель`criteria_from`	`string`	`""`	Отбирать письма, у которых поле From содержит этот адрес показывается при criteria_mode = from
Начиная с даты`criteria_since`	`string`	`""`	Отбирать письма, доставленные в этот день или позже (YYYY-MM-DD или DD-Mon-YYYY) показывается при criteria_mode = since
Сырые критерии IMAP`search_criteria`	`string`	`UNSEEN`	Сырое выражение IMAP SEARCH, напр. UNSEEN, ALL, FROM user@example.com показывается при criteria_mode = raw
Пометить как прочитанное`mark_as_read`	`boolean`	`true`	Ставить флаг \Seen на полученных письмах. Если выключить это вместе с режимом «Только непрочитанные», одни и те же письма будут приходить в каждом ране бесконечно — ящик открывается только на чтение, и прочитанными их никто не пометит. Только для IMAP.

Общие поля

Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.

expose_error_output — Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этого шага.