Навык «Почта»

Навык подключает Искру к вашему почтовому ящику по обычным почтовым протоколам IMAP и SMTP: проверить входящие и папки, найти и прочитать письмо, скачать вложение, сохранить черновик, отправить письмо или ответ (по умолчанию с подтверждением, при необходимости с файлами из чата), пометить прочитанным, переместить или удалить письмо. Пароль, введённый в форму подключения, не передаётся AI-модели. Сервер Искры использует его для входа на настроенные почтовые серверы по защищённому соединению и ведёт обмен с ними.

Навык подходит для Mail.ru, Яндекс.Почты, Gmail по паролю приложения и любого сервера с включённым IMAP, в том числе корпоративного. Для корпоративной почты Microsoft Exchange, где администратор выключил IMAP, есть отдельный навык «Microsoft Exchange: почта и календарь» — см. раздел «Чем «Почта» отличается от Exchange и Gmail» ниже.

Подключение

Mail.ru, Яндекс и Gmail всегда отклоняют вход по основному паролю от почты: почтовой программе нужен отдельный пароль приложения. У Яндекса, кроме того, доступ по IMAP и по паролям приложений включается отдельным переключателем в самой Почте — без него даже правильный пароль приложения сервер отклонит.

1. Включите доступ и создайте пароль приложения у своего провайдера:
   • Яндекс. В Почте откройте Настройки → Почтовые программы и включите «С сервера imap.yandex.ru по протоколу IMAP» и «Пароли приложений и OAuth-токены». Затем в Яндекс ID → Безопасность → Пароли приложений создайте пароль типа «Почта» (справка Яндекса).
   • Mail.ru. Настройки почты → Безопасность → «Пароли для внешних приложений». IMAP включён по умолчанию; логин — полный адрес почты, включая домен (@mail.ru, @bk.ru, @list.ru, @inbox.ru).
   • Gmail. В аккаунте Google включите двухэтапную аутентификацию — без неё пароли приложений недоступны, — затем Безопасность → Пароли приложений. В Google Workspace администратор может закрыть этот доступ: тогда подключите навык «Gmail», который входит через OAuth.
   • Корпоративная почта. Обычно подходит обычный пароль; включён ли IMAP для вашего ящика и какие у сервера адреса, подскажет системный администратор.
2. Узнайте адреса серверов своего провайдера. Для популярных это imap.mail.ru и smtp.mail.ru, imap.yandex.ru и smtp.yandex.ru, imap.gmail.com и smtp.gmail.com. Порт указывать не обязательно — по умолчанию используются 993 для IMAP и 465 для SMTP, оба сразу с TLS. Также поддерживаются IMAP 143 и SMTP 587: на них перед входом включается шифрование STARTTLS. Порт указывается через двоеточие, например imap.company.ru:143 или smtp.company.ru:587.
3. В Искре: Витрина навыков → «Почта» → добавить в личный профиль → на карточке навыка нажмите «Требует настройки» (позже те же поля открывает страница навыка → вкладка «Настройки»). В окне «Настройки навыка» откроется группа настроек «Подключение к почте»:
   • IMAP-сервер и SMTP-сервер — адреса с шага 2;
   • Логин — полный адрес вашей почты;
   • Пароль — пароль приложения с шага 1, целиком и без пробелов. Поле write-only, как и обычные ключи: посмотреть сохранённое значение нельзя, только заменить.
4. Попросите Искру проверить подключение. Проверяются оба канала — чтение (IMAP) и отправка (SMTP). Если вход отклонён, Искра покажет код отказа, а для распознанной причины — её стандартное описание. Также появится чек-лист вашего провайдера: что включить и какой пароль вставить. Произвольный текст ответа сервера в чат не передаётся. Если адрес сервера неверный или сервер недоступен, диагноз скажет и это.
5. Для первой проверки попросите: «Покажи непрочитанные во входящих». Это чтение не меняет отметку о прочтении. Если подключено несколько ящиков, назовите адрес нужного.

Несколько почтовых ящиков

Один установленный навык подключает до десяти равноправных ящиков: например, личную рабочую почту и общий адрес для обращений клиентов. Ящики равны между собой — «главного» ящика, ролей и ящика по умолчанию нет.

• В форме настроек навыка каждый ящик — отдельная карточка с логином и IMAP-сервером; кнопка «Добавить подключение» доступна, пока не набрано десять. Каждую карточку можно изменить или удалить отдельно: остальные ящики продолжают работать, и ни один из них не становится «главным» вместо удалённого. Ящик сохраняется кнопкой «Сохранить» в его карточке — общей кнопки для всех ящиков нет.
• Когда ящик один, Искра работает с ним без уточнений.
• Когда ящиков несколько, а из просьбы не ясно, о каком речь, Искра покажет список подключённых ящиков и попросит выбрать. Молча она не выбирает: письмо не должно уйти не с того адреса. Можно сразу сказать, с каким ящиком работать: «проверь почту на mail@iskrabot.ru».
• «Проверь всю почту» Искра выполняет по ящикам подряд и говорит, где что нашла.
• По умолчанию отправка и ответ показывают подтверждение с точным адресом отправителя. Если в настройках этого навыка вы выключили «Спрашивать каждый раз», заполненное письмо может уйти сразу. При нескольких ящиках явный выбор ящика всё равно нужен, если он не ясен из просьбы.
• Идентификаторы писем привязаны к ящику: письмо одного ящика нельзя прочитать, переслать или удалить «из-под» другого, даже если у писем совпали папка и номер. Идентификаторы, полученные до подключения второго ящика, перестают действовать — просто попросите показать письма заново.

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

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

Что умеет

• Проверить папки — список папок ящика: имя, роль (входящие, отправленные, корзина, спам, черновики, архив), число непрочитанных и всего писем.
• Показать письма — по умолчанию из «Входящих», с возможностью указать другую папку и отфильтровать только непрочитанные. Письма приходят страницами: за раз Искра показывает до 50 (обычно 20) и говорит, сколько всего писем в папке. Если показаны не все, попросите «покажи дальше» — Искра продолжит с того места, где остановилась, и так до конца папки.
• Найти письмо — поиском на стороне почтового сервера: по отправителю, теме, тексту письма, диапазону дат. Результаты тоже приходят страницами.
• Прочитать письмо — текст письма и список вложений с номерами.
• Скачать вложение в файлы чата (до 3 МБ).
• Отправить письмо и ответить на письмо — оба действия показывают по умолчанию редактируемый черновик с кнопкой «Отправить». Если в Настройках → Работа навыка → Подтверждение этого навыка выключено «Спрашивать каждый раз», заполненное письмо может уйти сразу; недостающие данные всё равно потребуется заполнить. У ответа тему и цепочку письма Искра строит по исходному письму. Копию отправленного письма Искра кладёт в «Отправленные»; если почтовый сервер временно её не принимает, Искра повторяет сохранение несколько раз. Если копию сохранить так и не удалось, Искра скажет, что письмо ушло, а в «Отправленных» его может не быть.
• Сохранить черновик нового письма или ответа в почтовом ящике — он появится в папке черновиков для редактирования и последующей отправки из почтового клиента. Можно приложить файлы из текущего чата.
• Приложить файлы к письму — попросите приложить файл, который есть в этом чате (например, скачанное вложение или подготовленный документ). Когда подтверждение включено, проверьте имена вложений в форме; при предварительном разрешении заполненное письмо может уйти без её показа. До 10 файлов, каждый до 3 МБ, все вместе до 10 МБ; имя и тип файла у получателя сохранятся.
• Пометить письма прочитанными или непрочитанными, переместить в другую папку, удалить (перенос в «Корзину», не безвозвратно) — все три действия Искра выполняет только после вашего явного согласия текстом в чате.

Черновики в почтовом ящике

Попросите: «Сохрани черновик письма Анне с темой “План встречи” и текстом…» или «Сохрани черновик ответа на это письмо: спасибо, встречу подтверждаю». Искра сохранит письмо в почте и сообщит папку. Сохранение черновика само по себе письмо не отправляет. Откройте его в почтовом клиенте, проверьте, при необходимости измените и отправьте оттуда. Черновик сохраняется без отметки о прочтении и может отображаться в папке как непрочитанный.

Для нового черновика достаточно текста: получателя и тему можно заполнить позже. У ответа Искра берёт получателя и тему из исходного письма и сохраняет связь с ним. Можно попросить изменить тему, адресатов или добавить копию. Автоматического режима «ответить всем» у этого инструмента нет.

Если ящиков несколько, назовите нужный. Если сервер не сообщает, какая папка служит для черновиков, или сообщает несколько таких папок, попросите показать список папок и укажите одну из существующих. Новые папки Искра при сохранении черновика не создаёт.

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

Эта возможность относится к навыку «Почта IMAP/SMTP». Для отдельных навыков Gmail с OAuth и Microsoft Exchange она здесь не заявлена.

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

Когда Искра показывает вам текст письма — в списке или по прямому запросу — письмо остаётся непрочитанным на сервере, как если бы вы никогда его не открывали в почтовой программе. Это касается и просмотра вложений. Пометить письмо прочитанным можно только отдельным явным действием, и Искра сначала спросит согласия.

Чем «Почта» отличается от Exchange и Gmail

Способ подключения зависит от почтового сервера; настройки одного навыка не подходят другому:

• «Почта» (этот навык) — Mail.ru, Яндекс, Gmail по паролю приложения, любой сервер с протоколом IMAP; подключение — адреса IMAP и SMTP, логин и пароль приложения.
• «Microsoft Exchange: почта и календарь» — только для Microsoft Exchange с включённым EWS; подключение — адрес EWS, логин и обычный доменный пароль. Этот навык умеет ещё и календарь Exchange.
• Отдельный навык Gmail, если он есть в каталоге вашей Искры, — только аккаунт Google, вход через OAuth без ввода пароля. Если такого навыка нет, Gmail можно подключить через «Почту» по IMAP с паролем приложения.

Если у вас корпоративная почта и вы не знаете, работает ли она по обычному IMAP или по Exchange — уточните у системного администратора.

Ограничения

• Нужен сервер, доступный из интернета: почтовый сервер во внутренней сети организации (VPN, приватный адрес) навык не увидит.
• Соединение всегда защищённое; незашифрованные подключения навык не устанавливает.
• Отправка возможна только с адреса того ящика, из которого идёт письмо; выбрать «чужой» адрес отправителя нельзя.
• Личная коллекция ящиков полностью заменяет организационную: подключения из двух коллекций не объединяются.
• К письму можно приложить только файлы из текущего чата: ссылку в интернете или файл на вашем компьютере навык сам не скачает — сначала приложите файл в чат.
• Календаря и контактов у этого навыка нет — только почта.
• Очень длинные письма Искра показывает с обрезкой текста.

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

Передача пароля и безопасность почты IMAP/SMTP

Пароль почты, введённый в форму подключения, хранится в защищённом хранилище отдельно от переписки: AI-модель и код навыка не получают его из настроек. Сервер Искры использует этот пароль для входа на указанные вами IMAP- и SMTP-серверы по защищённому соединению TLS. Сохранённое значение нельзя посмотреть в настройках повторно — его можно заменить. Логин и адреса серверов являются обычными параметрами и доступны Искре при выборе ящика и проверке подключения.

Пароль, отправленный обычным сообщением, становится частью чата и доступен AI-модели. Форма подключения не скрывает и не удаляет такой текст из переписки. Для подключения почты используйте поле пароля в форме.

Поддерживаются IMAP 993 и SMTP 465 с TLS сразу при соединении, а также IMAP 143 и SMTP 587 с включением TLS через STARTTLS до передачи логина и пароля. Пароль приложения используется для входа на почтовый сервер так же, как пароль; его преимущество — отдельный доступ для внешней программы, который можно отозвать у провайдера.

Команда «прочитать письмо» передаёт текст письма в переписку для обработки AI-моделью. В обычные служебные журналы подключения пароль из настроек и текст письма не записываются. После отзыва пароля приложения навык перестанет подключаться, пока вы не создадите и не впишете новый.