Інструкція для Microsoft Teams

Інтеграція з MS Teams - опис

Інтеграція Zadarma-Microsoft Teams повністю безкоштовна.

Функції інтеграції:

• Дзвінки клієнтам з MS Teams в один клік;
• Налаштування маршрутизації дзвінків для організації в Teams;
• Інтеграція статистики дзвінків. Можливість конфігурації голосових меню і додаткових функцій в MS Teams.

Переваги Zadarma:

• Повністю безкоштовна АТС, налаштування за 5 хвилин;
• Тарифні пакети для вигідних дзвінків на всі напрямки;
• Багатоканальні номери в 100 країн світу (міські, мобільні, 800);
• Додаткові можливості: коллтрекінг, аналітика розмов, віджети для сайту, відеоконференції;
• Максимальні якість та надійність (16 років роботи, дата-центри в 5 країнах, підтримка 24/7).

Інструкція з налаштування

1. Для інтеграції віртуальної АТС Zadarma ита MS Teams повинні бути виконані наступні умови:

• У кожного користувача Teams, який буде здійснювати дзвінки через інтеграцію, повинна бути активована необхідна ліцензія, (рекомендована збірка Office 365 E3 + MS 365 Phone System + MS 365 AudioConferencing);
• Для використання телефонії у користувача в MS Teams повинні бути встановлені необхідні дозволи і ролі.
• Для сумісної роботи АТС Zadarma та MS Teams необхідно створити та налаштувати віртуальну АТС Zadarma. створені внутрішні номери(кожен співробітник - окремий внутрішній номер), при необхідності увімкніть запис розмов в налаштуваннях внутрішнього номери.

2. В особистому кабінеті Zadarma перейдіть в розділ Налаштування - API та інтеграції та увімкніть інтеграцію з MS Teams. Далі у вікні, що з'явилось необхідно скопіювати індивідуальний SBC-домен для інтеграції.

3. В новій вкладці браузеру перейдіть до адмін-центру Microsoft , не закриваючи вкладки з особистим кабінетом Zadarma.

Покроковий приклад налаштування інтеграції зі скріншотами:

Крок 1. В адмін-центрі Microsoft відкрийте розділ «Параметри» - «Домени» та оберіть пункт Додати домен».

Крок 2. В новому вікні у полі «Доменне ім'я» необхідно скопіювати значення домену, отриманого при включенні інтеграції в особистому кабінеті Zadarma у розділі Налаштування – Інтеграції та API (на нашому прикладі - sbc12345.teams.zadarma.com). Для переходу на наступний етап оберіть пункт «Використовувати цей домен».

Крок 3. На наступному етапі для підтвердження домену обираємо значення «Додати TXT-запис в DNS-запису домена».

Крок 4. На наступній сторінці ви зможете скопіювати TXT-запис у полі «Значення TXT». Вставити отриманий запис необхідно у відповідне поле налаштувань інтеграції з Microsoft Teams у розділі Налаштування – Інтеграції та API в особистому кабінеті Zadarma і підтвердити додавання, натиснувши на кнопку «Далі».

Крок 5. Необхідно повернутись до адміністративного центру Microsoft та завершити валідацію домену, обравши пункт «Перевірити». На наступний сторінці на питання «Як ви хочете підключитись до домену?» обираємо значення «Пропустити та зробити це пізніше», натискаємо «Продовжити» та в новому вікні «Готово».

Після цього на відкритій вкладці налаштувань інтеграції з Microsoft Teams (розділ Налаштування – Інтеграції та API в особистому кабінеті Zadarma) натисніть «Далі», оберіть SIP-логін, який буде використовуватись у подальшій роботі інтеграції, та натисніть «Зберегти».

4. В адмін-центрі Microsoft у розділі «Користувачі» - «Активні користувачі» натискаємо на ім'я користувача з правами адміністратора, який налаштовує інтеграцію з Teams, обираємо пункт «Керування ім'ям користувача та електронною поштою».

У новому вікні у полі «Псевдоніми» у колонці «Домени» обираємо підтверджений раніше SBC-домен, вказуємо ім'я користувача та натискаємо «Додати». Далі в цьому ж розділі необхідно навпроти доданого псевдоніма натиснути на логотип «…» та обрати пункт «Зробити основною адресою електронної пошти», після чого зберегти зміни. Новий логін у подальшому буде використовуватись користувачем для входу в Microsoft Teams.

5. Подальше налаштування виконується адміністратором організації Microsoft з відповідними правами (адміністратором MS Teams). Зверніть увагу: налаштування можна виконувати через центр адміністрування Microsoft Teams або через командну строку PowerShell.

Центр адміністрування Teams

5.1. У розділі «Користувачі» - «Керування користувачами» натисніть на ім'я користувача, що налаштовується і на вкладці «Обліковий запис» запевніться, що у користувача назначенийий номер телефону, а в цьому ж розділі на вкладці «Голосовий зв'язок» встановлені дозволи на здійснення дзвінків.

5.2. В меню зліва перейдіть до розділу «Голосовий зв'язок» - «Пряма маршрутизація» і на вкладці «Контроллери SBC» оберіть пункт «Додати», Далі вкажіть отриманий раніше SBC-домен (на нашому прикладі це sbc12345.teams.zadarma.com), опис до нього, а в полі «Параметри SBC» виконайте налаштування аналогічні скріншоту, після чого збережіть параметри.

5.3. У тому ж розділі у верхньому правому кутку натисніть на «Керування записами про використання ТСОП» та додайте ваш унікальний SBC-домен, сгенерований при встановленні інтеграції.

Тут же переходимо на вкладку «Маршрути голосового зв'язку» та натискаємо «додати». На цій сторінці необхідно додати шаблони номеру, що набирається для здійснення вихідних дзвінків. Для цього вказуємо ім'я та опис до нього, встановлюємо пріорітет, а у полі «Шаблон номеру, що набирається» вказуємо значення ^(\+1[0-9]{10})$, що дозволить здійснювати виклики на номери, що починаються з +1 (США та Канада). Нижче у полях «Зареєстровані SBC» та «Записи про використання SBC» обираємо доданий раніше SBC-контроллер та зберігаємо налаштування. Аналогичним чином можна додати маршрути для дзвінків в інші країни, номери яких починаються з цифр від 2 до 9, змінити необхідно тільки цифру у шаблони після знаку «+».

Зверніть увагу, що шаблон ^(\+1[0-9]{10})$ призначений для набору 11-значних номерів. Якщо у номері, що набирається більше знаків (наприклад 12), то приклад шаблону буде виглядати як ^(\+1[0-9]{11})$.

5.4. Далі переходимо до розділу «Голосовий зв'язок» - «Політики маршрутизації», обираємо поточну політику (або створюємо нову) і у полі «Записи про використання ТСОП» додаємо ваш SBC-контроллер, після чого зберігаємо налаштування.

5.5. Після цього повертаємось у розділ «Користувачі» - «Керування користувачами», натискаємо на ім'я користувача, переходимо на вкладку «Політики», обираємо пункт «Змінити» та для поля «Політика дзвінків» встановлюємо значення “AllowCalling”. Якщо на попередньому етапі ви створювали нову політику, то її необхідно буде обрати у полі «Політика маршрутизації голосового зв'язку».

Після збереження змін усе готове для здійснення вихідних дзвінків цим користувачем.

Для інших користувачів будуть примінені ці ж налаштування політик та маршрутів.

Порядок дій для підключення нових користувачів до маршрутизації вихідних дзвінків через Zadarma після створення необхідних маршрутів та політик не змінюється. Користувачам просто назначаються відповідні політики, як це зроблено на останньому кроці.

PowerShell

Альтернативою налаштування через адміністративний центр MS є налагодження за допомогою командного рядка PowerShell.

Для налаштування таким способом потрібен доступ до облікового запису адміністратора MS через командний рядок операційної системи Windows, або через веб-емулятор командного рядка Azure Cloud Shell.

Після переходу і авторизації в PowerShell/CloudShell як адміністратор в MS необхідно послідовно виконати наступні команди:

1. Встановлення модуля:

Install-Module MicrosoftTeams

2. Підключення та аутентифікація:

Connect-MicrosoftTeams

3. Налаштування:

3.1. Включення можливості VoIP-дзвінків для користувача

Set-CsUser -Identity "zadarma-user@sbc12345.teams.zadarma.com" -EnterpriseVoiceEnabled $true

где zadarma-user@sbc12345.teams.zadarma.com – логін для входу користувача в Microsoft Teams.

3.2. Призначення політики дзвінків для користувача

Grant-CsTeamsCallingPolicy -identity "zadarma-user@sbc12345.teams.zadarma.com" -PolicyName AllowCalling

3.3. Створити нову політику маршрутизації вихідних дзвінків і PSTN-запис

New-CsOnlineVoiceRoutingPolicy -Identity "Zadarma out" -OnlinePstnUsages "sbc12345.teams.zadarma.com"

де sbc12345.teams.zadarma.com – унікальний SBC-домен, який генерується при включенні інтеграції в особистому кабінеті Zadarma.

3.4. Призначення користувачу політики маршрутизації вихідних дзвінків

Grant-CsOnlineVoiceRoutingPolicy -Identity "zadarma-user@sbc12345.teams.zadarma.com" -PolicyName ”ZadarmaOut,”

3.5. Призначення користувачу номера (з екстеншеном) для вхідних дзвінків і включення голосової пошти

Set-CsUser -Identity "zadarma-user@sbc12345.teams.zadarma.com" -HostedVoiceMail $true -OnPremLineURI tel:+44123456789;ext=223344

де 44123456789 и 223344 – номер телефону, що назначається співробітникові для здійснення дзвінків з Microsoft Teams та внутрішній номер для роботи з АТС в Teams відповідно.

3.6. Додавання нового маршруту для вихідних дзвінків

New-CsVoiceRoute -Identity "Route1"

3.7. Перевіряємо що всі параметри задані коректно

Get-CsOnlineUser -Identity "zadarma-user@sbc12345.teams.zadarma.com" | fl OnPremLineUriManuallySet,OnPremLineUri,LineUri,EnterpriseVoiceEnabled,HostedVoiceMail,TeamsCallingPolicy,OnlineVoiceRoutingPolicy,EnterpriseVoiceEnabled

3.8. Створення та налаштування діалплана (не обов'язково, використовується для додавання правил формату набору номера)

New-CsDialPlan -Identity "ZadarmaDialplan"

3.9. Призначення користувачу створеного діалплана (не обов'язково)

Grant-CsDialPlan

Налаштування вхідних дзвінків

В особистому кабінеті Zadarma в розділі «Налаштування» - Підключення за SIP» в налаштуваннях SIP-логіна, який ви раніше обрали для роботи інтеграції, у полі «Переадресація на телефон» необхідно натиснути на «Увімкнути переадресацію», обрати режим «Завжди активна» та вказати номер телефону, який назначений співробітнику в його профілі в адмін-центрі Teams, після чого усі вхідні на цей SIP-логін будуть перенаправлені в транк з MS Teams.

Далі маршрутизація вхідних дзвінків налаштовується вже з боку АТС в MS Teams.

Для спільного використання АТС Zadarma разом з MS Teams достатньо включити переадресацію вхідних дзвінків з внутрішнього номера на SIP-логін з транком MS Teams.

Переадресація вмикається в розділі «Моя АТС» - «Внутрішні номери». В налаштуваннях внутрішнього номеру у полі «Переадресація і голосова пошта» необхідно обрати пункт «Увімкнути»/«Налаштувати», далі обрати умову спрацьовування переадресації, нижче натиснути на логотип прапору, нагорі списку, що розкрився, обрати значення «SIP номер», вказати відповідний SIP-логін та зберегти налаштування.

Приклади використання MS Teams для здійснення дзвінків та можливі додаткові налаштування:

1. Здійснення вихідного дзвінка через Teams.

Для здійснення вихідного дзвінка достатньо перейти в розділ “Дзвінки” в боковому меню з лівої сторони, ввести у полі номер, на який ви хочете подзвонити, та натиснути на кнопку “Виклик”.

• у полі набору також можна ввести ім'я контакта;
• формат набору номеру залежить від правил, що задані для вашого користувача адміністратором в налаштуваннях MS Teams;
• окрім цього, вихідні виклики можна здійснювати з інших меню, наприклад, напряму з чата, натиснувши на іконку у вигляді телефонної слухавки;

2. Прийом вхідного дзвінка через Teams.

Для прийому вхідного дзвінка необхідно просто натиснути на відповідну кнопку у повідомленні, що з'явилось на екрані про вхідний дзвінок.

• під час розмови дзвінок можна ставити на утримання або скористатися функцією переводу дзвінка за допомогою відповідних кнопок;
• вхідні дзвінки можна автоматично перенаправляти на голосову пошту переключивши налаштування переадресації в лівому нижньому кутку екрану;
• будь-який користувач Teams може змінити статус доступності (наприклад включити режим "не турбувати") натиснувши на іконку аватара свого користувача в правому верхньому кутку і обравши відповідний статус в випадаючому меню.