Звонок с сайта для сотрудников с помощью серверного HTTP интерфейса

Материал из Oktell
Перейти к: навигация, поиск

Наверх

Задача: запуск дозвона на номер с сайта для сотрудников.

Пусть имеется кнопка на сайте с назначенным на нее номером (например, 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
Запуск сценария на дозвон.PNG


Использование библиотеки Okbutton

Библиотека Okbutton.js позволяет организовать голосовой канал.

Ссылка на документацию: https://js.oktell.ru/okbutton/