3CX интеграция с Office 365 чрез Azure API

Изданията PBX 3CX v16 Pro и Enterprise предлагат пълна интеграция с приложенията на Office 365. По-специално е реализирано следното:

• Синхронизиране на потребители на Office 365 и разширения (потребители) на 3CX.
• Синхронизиране на личните контакти на потребителите на Office и личната адресна книга на 3CX.
• Синхронизиране на състоянията на потребителския календар на Office 365 (зает) и състоянието на номера на разширение 3CX.   

За извършване на изходящи повиквания от уеб интерфейса на приложенията на Office, 3CX използва разширението 3CX Click to Call за браузъри Chrome и Firefox. Можете също да използвате клавишни комбинации в 3CX приложение за Windows.

За да започнете, ще ви е необходим абонамент за Office 3CX и идентификационни данни за администратор на портала на Office с привилегии на „глобален администратор“.

Някои абонаменти за Office 365 имат ограничена или никаква интеграция с 3CX:

• Абонаменти без управление на потребителите, т.е. всички „домашни“ абонаменти.
• Абонаментите без Exchange не могат да синхронизират контакти и календар (Office 365 Business и Office 365 Pro Plus).

Сървърите на Office 365 трябва да имат директна връзка с вашия 3CX сървър, за да предават статуси в реално време. Ако постоянната връзка не е възможна, 3CX все пак ще извършва ежедневна синхронизация.

Моля, имайте предвид, че синхронизацията се извършва само в една посока - от Office 365 към 3CX. За успешна синхронизация потребителите на Office 365 трябва да имат атрибута "UserType", зададен на "Member" (зададен в Active Directory). Ако потребител, синхронизиран от Office 365, бъде изтрит или модифициран чрез интерфейса на 3CX, той се връща към предишното състояние по време на следващото ръчно или автоматично синхронизиране.

Приложение за удостоверяване на Microsoft Azure

Първа стъпка на свързване Интеграция на Office 365 — създаване на индивидуално приложение във вашия акаунт за разрешаване на интеграция.

1. В интерфейса за управление на 3CX отидете на Настройки - Office 365 - раздел Настройки - раздел Стъпка 3 и копирайте URL адреса за пренасочване.
2. Влезте в портала на Office 365 с вашите идентификационни данни за глобален администратор и отидете на Регистрации на приложения на Microsoft Azure.
3. Щракнете върху Нова регистрация и посочете името на приложението, например 3CX PBX Office 365 Sync App.
4. В секцията Поддържани типове акаунти оставете опцията по подразбиране Акаунти само в тази директория на организацията
5. В секцията URI за пренасочване (по избор) изберете типа Уеб и поставете URI за пренасочване от интерфейсната секция на 3CX: Настройки > Интегриране на Office 365 > раздел Настройки > Стъпка 3. Секцията за платформа и разрешения, напр. company.3cx.eu:5001/oauth2office2
6. Щракнете върху Регистрация и приложението ще бъде създадено.
7. Отваря се страницата с настройки на създаденото приложение. Копирайте стойността на ИД на приложението (клиент) и я поставете от съответното поле в интерфейса за управление на 3CX, Настройки > Интегриране на Office 365 > раздел Опции > Стъпка 1. Конфигурирайте ИД на приложението.

Ключове за удостоверяване

Сега трябва да установите доверителен публичен ключ между вашата 3CX v16 система и създаденото приложение в портала на Office 365.

1. В интерфейса на 3CX (Настройки > Интеграция на Office 365 > Раздел Опции), щракнете върху Генериране на нова двойка ключове и запазете ключа public_key.pem.
2. Отидете на страницата с настройки на приложението в секцията Сертификати и тайни. Щракнете върху Качване на сертификат и качете генерирания ключ.

Разрешения за приложение

Последната стъпка за настройка е да зададете разрешения за API в раздела Разрешения за API. Тези разрешения определят как вашата 3CX система може да има достъп до вашия акаунт в Office 365.

1. Отидете на API разрешения, щракнете върху Добавяне на разрешение и изберете Microsoft Graph.
2. Добавете разрешения за API под Разрешения за приложение: Календари > Календари.Четене, Контакти > Контакти.Четене, Директория > Директория.Четене.Всички и щракнете върху Добавяне на разрешения.
3. В секцията Предоставяне на съгласие щракнете върху Предоставяне на съгласие на администратор за..., за да активирате разрешенията.
4. Изчакайте около 10 минути, за да влязат в сила промените правилно.
5. Преминете към интерфейса 3CX и в секцията Интеграция с Office 365 щракнете върху Влизане в Office 365. Потвърдете разрешенията за създаденото приложение и връзката между системите ще бъде установена.

Възможности за синхронизация

Синхронизирането между 3CX и Office 365 се конфигурира в три раздела:

• Синхронизация на потребителите - Потребителите на Office 365 се синхронизират с потребителите на 3CX (разширения). В интерфейса за управление на 3CX синхронизираните потребители се поставят в организационната група на Azure AD.
• Синхронизиране на контакти - Личните контакти на Office 365 се синхронизират с адресната книга на 3CX. Потребителят вижда тези контакти в приложенията на 3CX за всички платформи.
• Синхронизация на календара - автоматично променя състоянието на 3CX разширение в зависимост от това дали е заето в календара на Office 365:

След приключване на събитие в календара на Office 365, състоянието на потребителя на 3CX също се синхронизира и се връща в предишното си състояние.

Всички елементи за синхронизиране могат да бъдат конфигурирани както за всички потребители на Office 365, така и за избрани потребители.

Това завършва интеграцията.

Източник: www.habr.com