Навык «Microsoft Exchange: почта и календарь»

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

Навык предназначен только для Microsoft Exchange — конкретно для серверов, где включён протокол EWS (Exchange Web Services). Для другой почты выберите «Почта» (IMAP/SMTP) или Gmail (вход через Google); подробное сравнение есть ниже. Если тип почты неизвестен, уточните его у администратора перед настройкой.

Навык работает по просьбе, разово. Постоянная синхронизация календаря и задач с «Планами» настраивается отдельно — в разделе «Календари и задачи» настроек (см. «Синхронизация календарей и задач»). Календарь и список задач Exchange там тоже подключаются — карточкой «Exchange Server», по тому же адресу EWS и тому же доменному паролю, что и здесь (в мастере подключения адрес вводится целиком, с https://). Навык остаётся для почты, которой у синхронизации нет вовсе, и для разовых вопросов к календарю.

Подключение

Подключение работает вашим обычным доменным паролем от учётной записи — отдельного «пароля приложения», как для Mail.ru или Яндекса, Exchange не требует.

1. Узнайте у системного администратора адрес EWS вашего сервера: полный вид — https://mail.company.ru/EWS/Exchange.asmx, либо просто адрес сервера, например mail.company.ru — путь Искра подставит сама. Автоматического определения адреса нет: без администратора его не подобрать.
2. В Искре: Витрина навыков → «Microsoft Exchange: почта и календарь» → добавить в личный профиль → на карточке навыка нажмите «Требует настройки» (позже те же поля открывает страница навыка → вкладка «Настройки»). В окне «Настройки навыка» откроется группа настроек «Подключение к Exchange»:
   • Адрес EWS — значение с шага 1;
   • Логин — работает в двух форматах: DOMAIN\ivanov (обычно надёжнее для корпоративных серверов) или ivanov@company.ru. Если один формат не подошёл, попробуйте второй;
   • Пароль — обычный доменный пароль от вашей учётной записи. Поле write-only, как и обычные ключи: посмотреть сохранённое значение нельзя, только заменить.
3. Попросите Искру проверить подключение. Диагноз при ошибке подскажет, что поправить: неверный логин/пароль, неверный адрес сервера или сервер недоступен.

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

Что умеет

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

Календарь

• План на день или неделю — события календаря Exchange за период (по умолчанию ближайшие 7 дней); повторяющиеся встречи уже развёрнуты в отдельные события.
• Детали встречи — время, место, организатор, участники, описание.
• Создание встречи — с местом, участниками и описанием; показывает форму подтверждения по умолчанию; участникам автоматически уходят приглашения. Повторяющиеся встречи создавать пока нельзя.
• Перенос и изменение встречи — время, название, место, описание; участникам уходит обновление.
• Отмена встречи — перенос в «Удалённые», участникам уходит отмена встречи.

По умолчанию создание и изменение встречи требует подтверждения формы. Если вы выключили «Спрашивать каждый раз» в настройках этого навыка, заполненная встреча может быть создана или изменена сразу; неполную форму Искра предложит дополнить. Приглашения и обновления при этом действительно отправляются участникам.

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

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

Если письмо запрашивает уведомление о прочтении (отправитель включил такую опцию — «отчёт о прочтении»), то пометка письма прочитанным через навык может отправить это уведомление отправителю, точно так же, как если бы вы открыли письмо в Outlook и согласились отправить отчёт. Навык эту отправку не подавляет и не спрашивает отдельно — учитывайте это, прежде чем соглашаться пометить такое письмо прочитанным.

Чем «Microsoft Exchange: почта и календарь» отличается от «Почты» и Gmail

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

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

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

Ограничения

• Работает только с почтой Exchange, доступной с адреса, который дал администратор: внутреннюю сеть организации (VPN, приватный адрес) навык не видит.
• Microsoft 365 / Exchange Online, вход через Microsoft-аккаунт — не поддерживаются в этой версии.
• Автоопределение адреса сервера не поддерживается: адрес EWS всегда узнаётся у администратора.
• Контакты Exchange навык не показывает. Ответы на чужие приглашения (принять/отклонить) и просмотр занятости коллег пока не поддерживаются.
• К письму можно приложить только файлы из текущего чата: ссылку в интернете или файл на вашем компьютере навык сам не скачает — сначала приложите файл в чат.
• Период чтения календаря по умолчанию — ближайшие 7 дней, максимум 62 дня и до 50 событий за раз. Повторяющиеся встречи создавать пока нельзя — только читать, они приходят уже развёрнутыми в отдельные события.

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

Передача пароля и безопасность Exchange

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

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

Для входа Искра сначала отправляет логин и пароль по HTTPS способом Basic. Если сервер отклоняет эту попытку и предлагает NTLM, Искра продолжает вход по NTLMv2. HTTP-перенаправления не выполняются: нужен конечный адрес EWS, который выдал администратор.

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