Exchange Web Services (EWS)
Взаимодействие с локальными почтовыми ящиками Microsoft Exchange через SOAP API EWS.
Exchange Web Services (EWS)
Exchange Web Services (EWS) — это SOAP/XML API для локальных серверов Microsoft Exchange. Используйте этот блок, когда вы не можете использовать Microsoft Graph (например, Exchange 2013/2016/2019 без облачной учетной записи).
Официальная документация: https://learn.microsoft.com/exchange/client-developer/exchange-web-services
Настройка
- Найдите URL конечной точки EWS вашего Exchange. Обычно он выглядит как
https://mail.company.com/EWS/Exchange.asmx. Ваш администратор Exchange может подтвердить точный адрес. - Получите имя пользователя (в формате
DOMAIN\\userилиuser@company.com) и пароль для учетной записи почтового ящика. - В AACFlow добавьте блок EWS и введите URL конечной точки EWS, имя пользователя и пароль. Все поля учетных данных хранятся как секреты.
Для этой интеграции на сервере Exchange должна быть включена базовая аутентификация. Negotiate/Kerberos не поддерживается.
Операции
| Операция | Описание |
|---|---|
ews_messages | Выводит список сообщений в папке почтового ящика (по умолчанию: входящие). Возвращает краткую информацию о сообщениях, включая тему, отправителя и время получения. |
ews_send | Отправляет электронное письмо из аутентифицированного почтового ящика с указанием получателя, темы, тела письма (поддерживается HTML), опционально с копией и скрытой копией. |
ews_folders | Выводит список всех папок почтового ящика верхнего уровня. |
Пример сценария
Запланируйте сценарий для запуска каждые 15 минут, вызывайте ews_messages для получения непрочитанных писем, передавайте текст каждого сообщения в AI-блок для классификации и направляйте срочные элементы в уведомление Slack.
Ссылки
- Официальная документация: https://learn.microsoft.com/exchange/client-developer/exchange-web-services
- Исходный код блока: apps/aacflow/blocks/blocks/ews.ts