Инструкция для Microsoft Teams

Интеграция с MS Teams - описание

Интеграция Zadarma и Microsoft Teams полностью бесплатная.

Функции интеграции:

• Звонки клиентам из MS Teams в один клик;
• Настройки маршрутизации звонков для организации в Teams;
• Интеграция статистики звонков. Возможность конфигурации голосовых меню и дополнительных функций в MS Teams.

Преимущества Zadarma:

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

Инструкция по установке

1. Для интеграции Zadarma и MS Teams должны быть выполнены следующие условия:

• У каждого пользователя Teams, который будет совершать звонки через интеграцию, должна быть активирована соответствующая лицензия (рекомендованная сборка Office 365 E3 + MS 365 Phone System + MS 365 AudioConferencing либо Office 365 E5);
• Для использования телефонии у пользователя в 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». Вставить полученную запись необходимо в соответствующее поле настроек интеграции c 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 может изменить статус доступности (например, включить режим «не беспокоить» ), нажав на иконку аватара своего пользователя в правом верхнем углу и выбрав соответствующий статус в выпадающем меню.