Интеграция 3CX и Microsoft 365

Введение

3CX интегрируется с Microsoft 365 для реализации следующих функций:

  • Синхронизация учетных записей пользователей из Microsoft 365.
  • Возможность использовать учетную запись Microsoft (SSO) для входа в веб-клиент 3CX.
  • Синхронизация персональных контактов пользователей с персональной телефонной книгой 3CX (односторонняя).
  • Контакты общего почтового ящика синхронизируются с адресной книгой компании в системе 3CX (односторонняя).
  • Статус пользователя 3CX изменяется на основе событий календаря Microsoft, т.е. если вы находитесь на встрече, ваш статус в 3CX будет установлен в Занят.
  • Отправка уведомлений по электронной почте с использованием M365.

Требуется учетная запись Microsoft Microsoft 365 с планом подписки Exchange:

  • Microsoft 365 Business Basic, Standard или Premium
  • Microsoft 365 F3, E3 или E5

Шаг 1: Настройка доступа в Microsoft 365

Настройка доступа в Microsoft 365

На этом шаге необходимо настроить аккаунт Microsoft 365 для разрешения синхронизации с 3CX. Для этого:

  • Войдите в административную консоль 3CX и перейдите в раздел “Integrations” > “Microsoft 365”.
  • Нажмите “Configure”. Вы будете перенаправлены на сайт https://integrations.3cx.com.
  • Нажмите кнопку Connect и войдите в учетную запись администратора Azure.

  • Установите флажок с надписью Consent on behalf of your organisation, чтобы предоставить разрешения, запрашиваемые мастером 3CX MS 365; нажмите кнопку Accept.
  • Приложение будет создано, и вы сможете продолжить настройку интеграции с M365; нажмите кнопку Back, чтобы вернуться в консоль администратора 3CX.

Шаг 2: Настройка синхронизации

Синхронизация пользователей из Microsoft 365 в 3CX:

  • В административной консоли 3CX перейдите в раздел “Admin → Users” и нажмите на кнопку “M365”
  • Установите флажок Sync Microsoft 365 Users; обратите внимание:
  • синхронизация односторонняя — из M365 в 3CX
  • синхронизация выполняется ежедневно, ночью;
  • если удалить пользователя из 3CX, но не из M365, он появится снова в 3CX на следующий день
  • если удалить или отключить пользователя в M365, он останется в 3CX и должен быть удален вручную
  • синхронизация работает максимум для 650 пользователей.
  • Чтобы сохранить пользователей M365 в определённом диапазоне внутренних номеров, можно задать начальный номер:
  • это гарантирует, что более низкие номера не будут использоваться для импортированных из M365 пользователей
  • если начальный номер не задан, то пользователю, импортированному из M365, будет назначен первый доступный внутренний номер.

Настройте, что синхронизировать

  • Вы можете выбрать, что синхронизировать:
  • Включите SSO, чтобы пользователи могли входить в веб‑клиент, используя свои учетные данные Microsoft
  • Можно синхронизировать офисный телефон с 3CX Outbound Caller ID, чтобы номер рабочего телефона пользователя в M365 использовался как исходящий Caller ID в 3CX
  • Можно синхронизировать фотографию пользователя из M365 и использовать её как аватар в 3CX
  • Можно синхронизировать личные контакты из M365 в личную телефонную книгу пользователя 3CX; учтите, что:
  • это односторонняя синхронизация (из M365 в 3CX)
  • контакты пользователей необходимо управлять и обновлять в M365.

Настройте, каких пользователей синхронизировать

  • Можно настроить, каких пользователей необходимо синхронизировать:
  • Выберите, каких пользователей M365 включить или исключить из синхронизации; нажмите кнопку Select Users, чтобы настроить
  • Можно синхронизировать только выбранные отделы. Нажмите кнопку Select Departments, чтобы настроить

  • диалоговое окно Select Departments отображает список отделов, полученных из M365; выберите, какие из них включить, и нажмите кнопку OK
  • пользователи, не состоящие в выбранных отделах, не будут синхронизированы
  • имейте в виду, что:
  1. новые отделы создаются на основе названий групп M365
  2. уже существующие отделы 3CX НЕ перезаписываются и не используются; если название отдела M365 уже существует в 3CX, будет создан новый с добавлением порядкового номера
  3. если интеграция с M365 была настроена до версии 3CX 20 Update 8, потребуется перенастройка для получения всех необходимых прав для этой функции
  • Можно выбрать, включать (или нет) гостевых пользователей

Шаг 3 - Синхронизация статусов между 3CX и M365 Teams

Можно настроить синхронизацию статусов между 3CX и Teams. Обратите внимание, что перед включением этой опции:

  • Пользователи должны быть уже синхронизированы и добавлены, как описано выше в Шаге 2
  • Синхронизация статусов доступна только пользователям M365 с лицензией, поддерживающей Teams (например, Business Basic, Standard или Premium)

Чтобы включить синхронизацию статусов:

  • В консоли администратора 3CX перейдите в "Admin → Users" и нажмите кнопку M365
  • Выберите направление синхронизации:
  • Из 3CX в Teams; или
  • Из Teams в 3CX; или
  • В обоих направлениях (из 3CX в Teams и из Teams в 3CX)
  • Включите синхронизацию нажатием кнопки Authorize

Раздел Change Default Presence используется для настройки сопоставления статусов между 3CX и Teams. Предварительно настроенных параметров по умолчанию, как правило, достаточно для корректной работы; при внесении изменений необходимо избегать создания циклов статусов.

Шаг 4 - Синхронизация телефонной книги

Чтобы включить синхронизацию телефонной книги из M365 в 3CX:

Чтобы включить синхронизацию телефонной книги из M365 в 3CX:

  • В консоли администратора 3CX перейдите в “System → Phonebook” и нажмите кнопку M365

  • Нажмите кнопку Select Mailbox, чтобы выбрать, какие общие почтовые ящики включить или исключить из синхронизации, и нажмите кнопку OK

Обратите внимание, что синхронизируются все контакты из “Well Known Folders” (папок по умолчанию).

Шаг 5 - Отправка e-mail через M365

Если на Шаге 1 выбрана опция Send emails via Microsoft 365, 3CX автоматически настраивается на отправку e-mail через учетную запись M365.

Адрес отправителя для e-mail, отправляемых через M365, настраивается в консоли администратора в разделе “System → Email”; необходимо убедиться, что адрес отправителя:

  • существует в учетной записи M365
  • имеет лицензию на отправку e-mail

Особенности и ограничения синхронизации

Ниже приведены пояснения некоторых нюансов синхронизации, о которых пользователям следует знать:

  • 3CX в Teams > On a Call — можно синхронизировать статус 3CX “On a Call” со статусом Teams “In a Call”. При совершении или приеме вызова в 3CX клиент Teams отображает статус Busy > In a Call.
  • Teams в 3CX > In a Call — M365 отправляет статус Busy/In a Call только после ответа на вызов. В состоянии дозвона статус не передается. Этот статус отправляется, только если перед вызовом был установлен статус Available. Если в Teams установлен статус Busy и совершается вызов, даже после ответа Teams не отправит статус Busy/In a Call.
  • Available(Idle) — если в Teams установлен статус Available, и приложение закрывается или переводится в фоновый режим (на мобильном устройстве), происходит следующее:
  • Через 5 минут MS отправляет AvailableIdle:Inactive, и веб-клиент 3CX переключается в Available.
  • Еще через 5 минут MS отправляет Away:Away, и веб-клиент переключается в Away.
  • При повторном открытии приложения Teams MS отправляет Available:Available, и веб-клиент переключается обратно в Available.
  • Busy(Idle) — если в Teams установлен статус Busy и приложение закрывается или переводится в фоновый режим (на мобильном устройстве), происходит следующее:
  • Через 5 минут MS отправляет BusyIdle:Busy, и веб-клиент 3CX переключается в DND.
  • Еще через 5 минут MS отправляет Offline:Offline, и веб-клиент остается в статусе DND.
  • При повторном открытии приложения Teams MS отправляет Busy:Busy, и веб-клиент остается в статусе DND.
  • Уведомление присутствия Offline:Offline — это уведомление игнорируется, так как отключено в конфигурации. При активации приложения Teams от MS поступает уведомление Busy:Busy, и Веб-клиент остается в статусе DND.
  • Временная установка статуса из 3CX не синхронизирует присутствие в Teams.
  • Статусы 3CX Custom1 / Custom2 не синхронизируются в Teams.
  • Если в 3CX установлен статус Custom1 / Custom2, изменения в Teams не отразятся в 3CX.
  • Изменения статуса автопереключения будут синхронизироваться с Teams при условии, что статусы Custom1 / Custom2 не используются в разделе System > Options > Scheduler.
  • Автоматические изменения статуса будут синхронизироваться с Teams, если статусы Custom1 / Custom2 не используются в разделе System > Options > Scheduler.
  • Включение двусторонней синхронизации (Teams в 3CX и 3CX в Teams) может вызвать конфликт статусов и зацикливание между 3CX <> Teams, где каждый из них может переопределять настроенный статус. Например:
  • 3CX to Teams = Away > Away
  • Teams to 3CX = Away > Do Not Disturb
  • Это приведет к переключению Teams в Away и обратному переключению в DND в 3CX. Чтобы избежать этого, настройте обе стороны на переключение в один и тот же статус:
  • 3CX to Teams = Away > Away
  • Teams to 3CX = Away > Away
  • Синхронизация Teams > In a Call требует синхронизации статуса Available для корректной работы. Если “Available” не синхронизируется, ответ на вызов или совершение вызова в Teams переключит веб-клиент 3CX в DND, но никогда не переключит обратно в Available после завершения вызова.
  • Teams в 3CX > Available(Idle) статус — даже если этот статус исключен (выпадающий список очищен), выход из клиента Teams приведет к тому, что MS отправит уведомление Away:Away через 10 минут. В результате статус 3CX переключится в Away независимо от настроек синхронизации.

Дополнительная информация

Версия документа

Последнее обновление документа 29 января 2026

https://www.3cx.ru/docs/manual/microsoft-365/