Інтэграцыя 3CX з Office 365 праз Azure API

АТС 3CX v16 рэдакцыі Pro і Enterprise прапануе поўную інтэграцыю з праграмамі Office 365. У прыватнасці, рэалізавана:

• Сінхранізацыя карыстальнікаў Office 365 і дадатковых нумароў (карыстальнікаў) 3CX.
• Сінхранізацыя персанальных кантактаў карыстальнікаў Office і персанальнай адраснай кнігі 3CX.
• Сінхранізацыя статутаў (занятасці) календара карыстача Office 365 і статуту дадатковага нумара 3CX.   

Для выканання выходных выклікаў з вэб-інтэрфейсу прыкладанняў Office, 3CX выкарыстоўвае пашырэнне 3CX Click to Call для браўзэраў хром и Firefox. Таксама можна выкарыстоўваць клавіятурныя камбінацыі ў дадатку 3CX для Windows.

Для пачатку працы вам спатрэбіцца падпіска на Office 3CX і ўліковыя дадзеныя адміністратара партала Office з прывілеямі "Global Administrator".

Некаторыя падпіскі 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 - ўкладка Параметры - падзел Step 3 і скапіруйце Redirect URL.
2. Зайдзіце ў партал Office 365 з уліковымі дадзенымі Global Administrator і перайдзіце на старонку Рэгістрацыі прыкладанняў Microsoft Azure.
3. Націсніце Новая рэгістрацыя і пазначце імя прыкладання, напрыклад, 3CX PBX Office 365 Sync App.
4. У раздзеле Падтрымліваюцца тыпы уліковых запісаў пакіньце опцыю па змаўчанні Уліковыя запісы толькі ў гэтым каталогу арганізацыі
5. У падзеле URI перанакіраванні (неабавязкова) пазначце тып Вэб і ўстаўце URI перанакіраванні з падзелу інтэрфейсу 3CX: Параметры > Інтэграцыя з Office 365 > укладка Параметры > падзел Step 3. Платформа і дазволы, напрыклад, company.3cx.eu:5001/oauth2office2
6. Націсніце Зарэгістраваць, і дадатак будзе створана.
7. Адкрыецца старонка параметраў створанага дадатку. Скапіюйце значэнне Ідэнтыфікатар прыкладання (кліент) і ўстаўце яго з адпаведнае поле ў інтэрфейсе кіравання 3CX, Параметры > Інтэграцыя з Office 365 > ўкладка Параметры > Step 1. Наладзьце App ID.

Ключы аўтэнтыфікацыі

Цяпер неабходна ўсталяваць даверныя адносіны з адкрытым ключом паміж вашай сістэмай 3CX v16 і створаным дадаткам у партале Office 365.

1. У інтэрфейсе 3CX (частка Параметры > Інтэграцыя з Office 365 > укладка Параметры) націсніце Згенераваць новую пару ключоў і захавайце ключ public_key.pem.
2. Перайдзіце на старонку параметраў прыкладання ў раздзел Сертыфікаты і сакрэты. Націсніце Адпраўка сертыфіката і загрузіце створаны ключ.

Дазволы для прыкладання

Апошні этап налады - усталёўка дазволаў API у падзеле Дазволы API. Гэтыя дазволы вызначаюць правілы доступу вашай сістэмы 3CX да акаўнта Office 365.

1. Перайдзіце ў раздзел Дазволы API, націсніце Дадаць дазвол і абярыце Microsoft Graph.
2. Дадайце дазволы API у раздзеле Дазволы прыкладання: Calendars > Calendars.Read, Contacts > Contacts.Read, Directory > Directory.Read.All і націсніце Дадаць Дазволы.
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, так і для абраных карыстальнікаў.

На гэтым інтэграцыя завершана.

Крыніца: habr.com