Чтение почты
platform.email_read
Читает письма из почтового ящика (IMAP) по фильтру и возвращает отправителя, тему, дату, текст и метаданные вложений. Вложения сохраняются в Media Runtime, в выходе — assetId (без бинаря). Учётные данные берутся из настроек проекта по ссылке account.
Входы
| Ключ | Тип | Описание |
|---|---|---|
| account* | string | Аккаунт |
| folder | string | Папка |
| from | string | Отправитель |
| subject | string | Тема |
| since | string | С даты |
| unseenOnly | boolean | Только непрочитанные |
| limit | number | Лимит |
Выходы
| Ключ | Тип | Описание |
|---|---|---|
| emails | array | Письма |
| count | number | Количество |
Что делает
Нода подключается к почтовому ящику по IMAP и возвращает письма по заданному фильтру. Можно ограничить выборку папкой, отправителем, темой, датой и признаком «только непрочитанные», а также задать лимит на количество писем за один вызов. Каждое письмо приходит разобранным: адрес и имя отправителя, тема, дата, текстовое тело и метаданные вложений.
Учётные данные ящика нода не принимает на вход — на вход подаётся только ссылка на почтовый аккаунт (account), а логин и пароль резолвятся из настроек проекта. Пароль не попадает ни в данные шага, ни в логи, ни в историю выполнения.
Когда применять
Типовой сценарий — старт автоматизации по входящей почте. Например, сценарий обработки банковских выписок: нода забирает письма с вложениями из нужной папки, а следующие шаги разбирают содержимое и заносят данные в учёт. В связке с AI-агентом нода служит инструментом «прочитать входящие»: агент по запросу пользователя находит письма от конкретного отправителя или по теме и работает с их содержимым.
Что приходит в ответе
Массив писем и их количество. По каждому письму — идентификатор сообщения, адрес и имя отправителя, тема, дата и текстовое тело. Вложения приходят метаданными: имя файла, тип содержимого, размер и assetId — сам файл сохраняется в Media Runtime, а в ответе передаётся только ссылка на ассет, без бинарного содержимого.