Телефония Oktell: настройка

Плагин передаёт номер телефона из карточки в клиент Oktell на компьютере пользователя. Звонок совершает сам клиент; ERP с АТС напрямую не взаимодействует.

У плагина нет отдельных прав. Значок звонка появляется у всех параметров типа "телефон", работа пользователя описана в руководстве пользователя.

Как передаётся номер

По нажатию значка браузер пользователя отправляет GET-запрос на адрес

http://127.0.0.1:4059/switchto?number=<номер>

Это локальный интерфейс клиента Oktell. Перед отправкой из номера удаляются все символы, кроме цифр. Если клиент не запущен, пользователь видит сообщение об ошибке.

Настройка параметра-телефона

Ключи задаются в конфигурации параметра (Администрирование → Параметры).

Ключ Назначение

Ключ	Назначение
`oktell.call.custom.url`	Свой адрес вместо адреса клиента Oktell. Например, серверный обработчик, который сам выполняет звонок.
`showPrefixMenu=true`	Показывать меню выбора префикса при нажатии значка.
`prefix.<n>.key`	Префикс, который добавляется перед номером.
`prefix.<n>.value`	Подпись префикса в меню.

oktell.call.custom.url

Свой адрес вместо адреса клиента Oktell. Например, серверный обработчик, который сам выполняет звонок.

showPrefixMenu=true

Показывать меню выбора префикса при нажатии значка.

prefix.<n>.key

Префикс, который добавляется перед номером.

prefix.<n>.value

Подпись префикса в меню.

В oktell.call.custom.url можно использовать подстановки:

Подстановка Значение

Подстановка	Значение
`${number}`	Номер, только цифры.
`${userId}`	Идентификатор пользователя.
`${userLogin}`	Логин пользователя.
`${objectId}`	Идентификатор объекта, в карточке которого находится параметр.
`${objectType}`	Тип объекта.

${number}

Номер, только цифры.

${userId}

Идентификатор пользователя.

${userLogin}

Логин пользователя.

${objectId}

Идентификатор объекта, в карточке которого находится параметр.

${objectType}

Тип объекта.

Пример:

oktell.call.custom.url=/admin/dynamic.do?action=runDynamicClass&class=<класс>&method=call&processId=${objectId}&number=${number}
showPrefixMenu=true
prefix.1.key=8
prefix.1.value=междугородний

Если ответ на запрос — JSON со status: error, пользователь увидит текст поля message.

Вкладка звонка исполнителю

В конфигурации типа процесса:

oktell:processShowCallDealer=1
oktell:processShowCallDealer.tabName=Звонок исполнителю

Вкладка показывает номер исполнителя процесса и кнопку Позвонить, которая передаёт номер в клиент Oktell (http://127.0.0.1:4059/callto). Номер определяет динамический класс ru.bgcrm.dyn.ufanet.ExecutorPhoneNumberFinder: без него в установке вкладка выводит ошибку.

Настройки пользователя

В профиле пользователя есть группа Телефония Oktell. Включённое по умолчанию подтверждение номера хранится в персонализации, ключ plugin.oktell.call.confirm (0 — не подтверждать).