Підключення Email профілю Microsoft Outlook | Офіційна документація Webitel

Для підключення Email профілю Microsoft Outlook створюється новий Email профіль.

На сторінці деталі "Загальне" заповнюються дані згідно з описом. Вибирається тип аутентифікації OAuth2.

Для підключення необхідно заповнити поля Client id, Client secret і Discovery url і зробити наступне:

Увімкнути підтримку SMTP

Зайти на https://admin.microsoft.com/Adminportal/Home#/users і перейти на сторінку "Активні користувачі". Обрати користувача з чиєї електронної пошти опрацьовуватимуться листи (Рис. 1).

Активні користувачі.png — *Рис. 1. Активні користувачі*

Натиснути на відображуване ім'я. Відкриється обліковий запис. Вибрати вкладку "Пошта" (Рис. 2).

Обліковий запис.png — *Рис. 2. Обліковий запис*

Натиснути на "Налаштування програм електронної пошти" (Рис. 3).

Налаштування програм електронної пошти.png — *Рис. 3. Налаштування програм електронної пошти*

Перевірити, чи відмічено чекбокс "Автентифікований SMTP-протокол". Якщо ні — відмітити та натисніть кнопку "Зберегти зміни" (Рис. 4).

Автентифікований SMTP-протокол.png — *Рис. 4. Автентифікований SMTP-протокол*

Реєстрація OAuth клієнта та генерування секретного ключа

Зайти на https://entra.microsoft.com/. Обрати "App registrations" (Рис. 5).

Microsoft Entra admin center.png — *Рис. 5. Microsoft Entra admin center*

Вибрати "New registration" (Рис. 6).

New registration.png — *Рис. 6. New registration*

Введіть назву в полі "Name". Вибрати підтримуваний типом облікового запису "Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant)". У "Redirect URI" вибрати "Web" і в полі задати таке (Рис. 7):

https://XXXXX.XXX.XX/endpoint/oauth2/outlook/callback

, де

XXXXX.XXX.XX.XX - замінюється на сервер клієнта.

Це посилання також вказати в полі "Discovery url" на сторінці деталі "Загальне" на стороні Webitel.

Натиснути кнопку "Register".

Register an application.png — *Рис. 7. Register an application*

Створюється додаток. Скопіювати дані з "Application (client) ID". Скопійовані дані вставити в поле "Client id" на сторінці деталі "Загальне" на стороні Webitel.

Натиснути "Add a certificate or secret" (Рис. 8).

Created application.png — *Рис. 8. Created application*

Відкривається сторінка "Certificates & secrets". Натиснути на "New client secret" (Рис. 9).

Certificates & secrets.png — *Рис. 9. Certificates & secrets*

У "Add a client secret" задати опис і натиснути кнопку "Add" (Рис. 10).

Add a client secret.png — *Рис. 10. Add a client secret*

Секрет клієнта додано. На сторінці "Certificates & Secrets" скопіювати значення створеного секрету клієнта (Рис. 11). Вставити це значення в поле "Client secret" на сторінці деталі "Загальне" на стороні Webitel.

Повторне копіювання значення секрету клієнта неможливе!

Client secret.png — *Рис. 11. Client secret*

Роздача прав

На сторінці застосунку (Рис. 8) відкрити "API Permissions", натиснувши на відповідний напис у блоці "Manage". Натиснути на "Add a permission" (Рис. 12).

API permissions.png — *Рис. 12. API Permissions*

Відкривається "Request API permissions". Натиснути на "APIs my organization uses". Вибрати "Office 365 Exchange Online" (Рис. 13).

APIs my organization uses.png — *Рис. 13. APIs my organization uses*

Вибрати "Application permissions" (Рис. 14).

Office 365 Exchange Online - Application permissions.png — *Рис. 14. Application permissions*

Прокрутити вниз, знайти та відкрити "IMAP". Позначити "IMAP.AccessAsApp" (Рис. 15).

IMAP.AccessAsApp - Application permissions.png — *Рис. 15. IMAP.AccessAsApp*

Прокрутити вниз, знайти й відкрити "SMTP". Позначити "SMTP.SendAsApp" (Рис. 16).

SMTP.SendAsApp - Application permissions.png — *Рис.* 16. SMTP.SendAsApp

Натиснути кнопку "Add permissions".

"Request API permissions" закривається. На сторінці "API Permissions" натиснути на "Grant admin consent for Webitel". Відкривається модальне вікно для підтвердження (Рис. 17).

Grant admin consent for Webitel.png — *Рис. 17. Grant admin consent for Webitel*

Натиснути кнопку "Yes".