Телефония: подключение сервиса и данные сотрудников

Для кого эта инструкция

Инструкция для администратора, который подключает телефонию школы и затем выдаёт сотрудникам данные для звонков. Сначала добавляется сервис на уровне школы, затем его учётные данные назначаются каждому сотруднику отдельно.

Где находится

Для добавления сервиса нажмите шестерёнку внизу левого меню → «Общие настройки» → в карточке «Настройка телефонии» нажмите карандаш справа вверху.

Чтобы назначить сервис сотруднику, в левом меню откройте «Команда» → вкладка «Сотрудники» → карточка сотрудника → действие редактирования. Блок «Телефония» появляется только при наличии у сотрудника права «Доступ к телефонии» и хотя бы одного подключённого сервиса.

Что нужно перед началом

Получите у оператора телефонии название сервиса, домен, ключ и секрет API, а также индивидуальные логины и пароли сотрудников. Для Skorozvon вместо обычных данных сотрудника нужны его email и API key Skorozvon.

Для изменения карточки «Настройка телефонии» нужна возможность роли «НастройкаУстанавливать настройки школы».

Добавьте сервис телефонии

В окне «Редактирование настроек телефонии» нажмите «Добавить сервис». В блоке «Сервис №…» выберите значение в поле «Сервис». В интерфейсе доступны OnlinePbx, «Новофон (через sip)», Voximplant и Skorozvon. Можно создать несколько сервисов; каждый отображается отдельным блоком.

Если в школе настроено несколько адресов, выберите в поле «Адреса» те адреса, для которых действует этот сервис.

В поле «Название» укажите понятное внутреннее имя, если сервисов одного типа несколько. После настройки нажмите «Сохранить» внизу окна. Для удаления ненужного подключения нажмите «Удалить» в его блоке и сохраните изменения.

Настройте OnlinePbx, Новофон через SIP или Voximplant

Для этих сервисов сначала выберите «Тип софтфона».

• «Физическое приложение» — DoCRM сохраняет настройки сервиса для работы через отдельное приложение. Заполните «Домен телефонии», «Ключ API» и «Секретный ключ API», затем выберите «Префикс вызова»: Tel: или Sip:. При необходимости включите «Постфикс вызова» — DoCRM подставит @домен.
• «Встроенный виджет» — вариант для звонков в интерфейсе DoCRM. Он доступен только на филиале, для которого включён gateway; иначе DoCRM покажет предупреждение и предложит обратиться в техподдержку.

Для внешнего API-сервиса при использовании физического приложения доступен переключатель «Использовать Api». Его значение определяет, использует ли настройка API, поэтому включайте его только по требованиям конкретного оператора.

Настройте встроенный виджет

После выбора «Встроенный виджет» заполните блок «SIP-провайдер»: «SIP-домен», «Тип провайдера», «Транспорт» и «Порт». Для OnlinePbx по умолчанию указан тип провайдера onlinepbx, а для произвольной SIP-телефонии — generic-sip; порт по умолчанию — 5060.

Если оператор выдал INI-профиль, нажмите «Подгрузить из файла». DoCRM считывает из него домен, порт, транспорт и кодеки; логин и пароль сотрудника из файла не переносит.

В блоке «Поведение звонка» выберите «Тип перевода» («Слепой» или «Зрячий»), «Режим перевода» и «Результат звонка». «Результат звонка» можно выключить, сделать доступным по выбору или обязательным.

Настройте Skorozvon

Для Skorozvon в карточке сервиса заполните «Название», «ID приложения» и «Ключ приложения». Поля домена, типа софтфона, префикса и постфикса для него не показываются.

После сохранения в карточке «Настройка телефонии» DoCRM показывает webhook Skorozvon. Скопируйте этот URL в настройки приложения Skorozvon, если это требуется на стороне оператора.

Назначьте данные сотрудникам

Откройте «Команда» → «Сотрудники», выберите сотрудника и перейдите к редактированию. Раскройте аккордеон «Телефония: …». В нём отображается отдельный блок для каждого подключённого сервиса.

Для OnlinePbx, Новофона через SIP и Voximplant заполните «Телефония: Логин» и «Телефония: Пароль». Для встроенного виджета эти поля называются «SIP провайдера: логин» и «SIP провайдера: пароль». Если у встроенного виджета не указать SIP-данные, сотрудник останется только внутренним WebRTC-пользователем.

Для Skorozvon заполните «Skorozvon: Email» и «Skorozvon: API key». Затем нажмите «Загрузить список сотрудников» и при необходимости выберите нужного человека в списке «Skorozvon: сотрудник». Сохраните карточку сотрудника.

Если отображается поле «Адреса», выберите адреса сотрудника, для которых ему доступен этот сервис. DoCRM предлагает только пересечение адресов сотрудника и самого подключения телефонии.

Ежедневная работа сотрудника со звонком и телефонным виджетом описана в статье «Телефония: виджет, вызов и карточка звонка».

Готово: в карточке «Настройка телефонии» появляется сервис и состояние его ключей, а в карточках нужных сотрудников заполнены индивидуальные данные телефонии. После этого DoCRM может сопоставлять звонки с сотрудниками и использовать выбранный способ вызова.