Звонок с сайта для сотрудников с помощью серверного HTTP интерфейса
Содержание
Задача: запуск дозвона на номер с сайта для сотрудников.
Пусть имеется кнопка на сайте с назначенным на нее номером (например, 74952294989). Если сотрудник нажимает на нее, то сервер инициирует звонок на указанный номер. Проблема заключается в определении сотрудника, который совершает звонок.
В Oktell существует клиентский и серверный HTTP интерфейс. С помощью этих интерфейсов внешнее ПО имеет возможность получить состояния внутренних объектов, инициировать запуск служебных сценариев с ожиданием исполнения и без, осуществить звонок по настроенным правилам и т.д.
Решение с помощью клиентского HTTP интерфейса
Клиентский HTTP интерфейс использует запрос на локальный порт (по умолчанию, 4059), который прослушивается клиентским приложением. При нажатии на кнопку предлагается запускать команду:
http://127.0.0.1:4059/callto?number=74952294989
Команда инициирует дозвон по номеру на внешнюю (или внутреннюю) линию. В случае использования клиентского HTTP интерефейса, сервер Oktell всегда может определить какой сотрудник запустил команду и вызывается соответствующее устройство у сотрудника (ip-телефон, usb-телефон или гарнитура). При отключенном приложении, поступающие команды клиентского HTTP интерфейса исполняться не будут.
Решение с помощью серверного HTTP интерфейса
При использовании серверного HTTP интерфейса предлагается использоваться команду.
http://192.168.0.1:4055/wp_autocallstart?user=admin&number=74952294989&direction=city&sequence=back
- Укажите ip-адрес сервера, в примере 192.168.0.1. Проверьте, что порт 4055 занят приложением oktellserver.
- Запрос выполняется от имени указанной линии (параметр line), указанного пользователя (параметр user) или указанного рабочего места (параметр wp). Достаточно указания только одного из вышеприведенных параметров. В качестве значения может использоваться guid-идентификатор, название, имя пользователя, логин, номер линии и т.д. По указанному значению однозначно определяется внутренняя линия, от имени которой и исполняется команда.
- number - обязательный параметр.
- direction - необязательный параметр. По умолчанию используется автоопределение (если указанный номер найден среди внутренних номеров, осуществляется звонок вовнутрь, в противном случае осуществляется звонок наружу.
- pbx - звонок внутрь
- city - звонок вовне
- sequence - необязательный параметр. По умолчанию стандартный прямой вызов (direct).
- direct - сначала вызывается абонент, после ответа производится обратный вызов линии.
- back - сначала осуществляется вызов самой линии, а затем вызов от ее имени указанного номера.
Решения:
1. На сайте предлагается ввести форму аутентификации, где пользователи смогут ввести логин от Oktell. Затем при нажатии на кнопку вызова, формируется ссылка, где в поле user подставляется логин и далее команда отправляется на сервер Oktell.
- Условие: Сотрудник должен быть назначен как "пользователь по умолчанию" для своего телефона в карте сети.
либо
2. На сайте вводится автоматическое определение ip-адреса. Ip-адрес подставляется в поле "wp".
- Условие: Компьютер должен быть связан с телефоном логической связью. В свойствах компьютера пропишите ip-адрес компьютера (если в свойствах компьютера вы пропишете имя компьютера, то и в поле "wp" необходимо подставлять имя компьютера").
Пример:
http://192.168.0.1:4055/wp_autocallstart?wp=192.168.0.82&number=74952294989&direction=city&sequence=back
http://192.168.0.1:4055/wp_autocallstart?wp=Comp082&number=74952294989&direction=city&sequence=back
Использование библиотеки Okbutton
Библиотека Okbutton.js позволяет организовать голосовой канал.
Ссылка на документацию: https://js.oktell.ru/okbutton/