Для підключення вам знадобиться API key який потрібно передати команді підтримки.

<aside> 🧐

Зверніть увагу, для виконання інструкції нижче вам знадобиться активний аккаунт Microsoft Azure

</aside>

1. Перейдіть на портал Microsoft Entra Відкрийте браузер і зайдіть на Microsoft Entra Admin Center.

2. Увійдіть до облікового запису Увійдіть під вашим обліковим записом Microsoft (який має права адміністратора або доступ до потрібних служб).

3. Відкрийте розділ "Identity" На головній сторінці порталу знайдіть у меню зліва пункт "Identity" і натисніть на нього.

   Якщо такого пункта немає - використовуйте пункт “Azure Active Directory”

4. Перейдіть до розділу Overview та скопіюйте Tenant ID

   

   Tenant ID

5. Перейдіть до реєстрації додатків У розділі що ви відкрили вище знайдіть пункт "App registrations" (Реєстрація додатків) і відкрийте його.

6. Зареєструйте новий додаток

   • Натисніть кнопку "New registration" (Нова реєстрація).
   • Заповніть наступні поля:
     • Name (Назва): Введіть назву вашого додатка (наприклад, "ConnectiveOne Outlook").
     • Supported account types (Типи облікових записів): Виберіть, хто зможе використовувати додаток (звичайно, це "Accounts in this organizational directory only").
     • Redirect URI (Необов’язково): Якщо необхідно, введіть URI для перенаправлення (наприклад, якщо ви інтегруєте з веб-додатком).
   • Натисніть "Register" (Зареєструвати).

Реєстрація додатку на порталі

Отримання API ключа

1. Отримайте клієнтський ідентифікатор (Client ID) Після реєстрації ви побачите сторінку з параметрами додатка. Скопіюйте значення "Application (client) ID", яке буде використовуватися як ідентифікатор вашого додатка.

Client ID (1) tenant ID (2)

1. Згенеруйте секрет додатка (Client Secret)

   • У меню зліва перейдіть до розділу "Certificates & secrets" (Сертифікати та секрети).

   • Натисніть "New client secret" (Новий секрет клієнта).

     

     New client secret

   • Вкажіть опис (наприклад, "ConnectiveOne Outlook API Key") і виберіть термін дії 2 роки

     

     Обовʼязково вкажіть довгий термін дії токена

   • Натисніть "Add" (Додати).

   • Скопіюйте згенерований секрет одразу після створення (він не буде доступний повторно)

2. Налаштуйте дозволи (API Permissions)

   • У меню зліва оберіть "API Permissions" (Дозволи API).

   • Натисніть "Add a permission" (Додати дозвіл).

   • Оберіть "Microsoft Graph" (граф Microsoft).

     

     Обрати Microsoft Graph

   • Виберіть Application Permissions та потрібні дозволи (наприклад, "Mail.Read", "Mail.Send")

     

     API permissions

     

     API permissions

   • Натисніть Add permissions

   • Натисніть "Grant admin consent" (Надати згоду адміністратора) для підтвердження.

     

     і впевніться що статус став Granted

     

3. Передайте отриманий API ключ та Tenant ID, App ID в підтримку для підключення пошти