Интеграции · Стек 2027
Exchange EWS
Работа с почтой и календарём через API Microsoft Exchange.
Exchange Web Services, или EWS, — интерфейс Microsoft Exchange для работы с почтовыми данными, календарями и другими объектами. Он использует SOAP-сообщения с XML. Интеграция календаря через EWS требует понимать не только запросы, но и поведение встреч: организатора, участников, повторения, исключения, часовые пояса и права доступа.
Ключевые идеи
- Набор операций и схема сообщений зависят от версии API. Перед разработкой нужно определить конкретный сервер, поддерживаемые возможности и жизненный цикл используемого развёртывания Exchange.
- В объявленном плане Microsoft, проверенном 20 октября 2026 года, предусмотрены поэтапная блокировка EWS по умолчанию в Exchange Online (Microsoft 365) с 1 октября 2026 года и полное отключение с 1 апреля 2027 года. Для облачных интеграций следует планировать переход на Microsoft Graph. Объявление не меняет EWS в локальном Exchange Server; его применимость оценивают отдельно.
- Чтение списка событий не равно полноценной синхронизации. Нужно учитывать изменения, удаления, окно дат и правила сопоставления объектов, иначе две системы постепенно начнут показывать разные данные.
- Изменение события может конфликтовать с уже выполненным обновлением. Идентификаторы и маркеры версии, включая ChangeKey в соответствующих операциях, помогают учитывать состояние объекта, но обработку конфликта определяет приложение.
- Права на почтовый ящик и способ аутентификации задаются окружением. Журналы обмена помогают отличать ошибку доступа от неверного SOAP-запроса, отсутствующего объекта и временного отказа сервера.
Вывод
EWS полезно рассматривать как отдельную интеграцию со своими правилами данных и ошибок. В связке с Битрикс24 важно заранее определить направление обмена и момент подтверждения изменения. HTTP обеспечивает передачу сообщений, но корректность календаря проверяется на уровне событий.