Інтеграція 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 для браузерів Chrome и 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