Звонок с сайта для сотрудников с помощью серверного HTTP интерфейса — различия между версиями
Материал из Oktell
(Новая страница: « Наверх '''Цель''': запуск дозвона на номер с сайта для сотрудников. Пусть имеет...») |
м (→Использование библиотеки Okbutton) |
||
| (не показаны 4 промежуточные версии этого же участника) | |||
| Строка 1: | Строка 1: | ||
[[Практики | Наверх]] | [[Практики | Наверх]] | ||
| − | + | __TOC__ | |
| − | + | '''Задача''': запуск дозвона на номер с сайта для сотрудников. | |
| − | + | Пусть имеется кнопка на сайте с назначенным на нее номером (например, 74952294989). Если сотрудник нажимает на нее, то сервер инициирует звонок на указанный номер. Проблема заключается в определении сотрудника, который совершает звонок. | |
| + | В Oktell существует [[Клиентский_HTTP_интерфейс | клиентский]] и [[Серверный_HTTP_интерфейс | серверный]] HTTP интерфейс. С помощью этих интерфейсов внешнее ПО имеет возможность получить состояния внутренних объектов, инициировать запуск служебных сценариев с ожиданием исполнения и без, осуществить звонок по настроенным правилам и т.д. | ||
| − | + | ||
| + | ==Решение с помощью клиентского HTTP интерфейса== | ||
'''Клиентский HTTP интерфейс''' использует запрос на '''локальный порт''' (по умолчанию, '''4059'''), который прослушивается клиентским приложением. При нажатии на кнопку предлагается запускать команду: | '''Клиентский HTTP интерфейс''' использует запрос на '''локальный порт''' (по умолчанию, '''4059'''), который прослушивается клиентским приложением. При нажатии на кнопку предлагается запускать команду: | ||
| Строка 14: | Строка 16: | ||
http://127.0.0.1:4059/callto?number=74952294989 | 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 | http://192.168.0.1:4055/wp_autocallstart?user=admin&number=74952294989&direction=city&sequence=back | ||
| Строка 34: | Строка 35: | ||
** '''back''' - сначала осуществляется вызов самой линии, а затем вызов от ее имени указанного номера. | ** '''back''' - сначала осуществляется вызов самой линии, а затем вызов от ее имени указанного номера. | ||
| − | Решения: | + | '''Решения''': |
1. На сайте предлагается ввести форму аутентификации, где пользователи смогут ввести логин от '''Oktell'''. Затем при нажатии на кнопку вызова, формируется ссылка, где в поле '''user''' подставляется логин и далее команда отправляется на сервер '''Oktell'''. | 1. На сайте предлагается ввести форму аутентификации, где пользователи смогут ввести логин от '''Oktell'''. Затем при нажатии на кнопку вызова, формируется ссылка, где в поле '''user''' подставляется логин и далее команда отправляется на сервер '''Oktell'''. | ||
* '''Условие''': Сотрудник должен быть назначен как "'''пользователь по умолчанию'''" для своего телефона '''в карте сети'''. | * '''Условие''': Сотрудник должен быть назначен как "'''пользователь по умолчанию'''" для своего телефона '''в карте сети'''. | ||
| − | + | ||
| + | либо | ||
| + | |||
2. На сайте вводится автоматическое определение '''ip-адреса'''. '''Ip-адрес''' подставляется в поле "'''wp'''". | 2. На сайте вводится автоматическое определение '''ip-адреса'''. '''Ip-адрес''' подставляется в поле "'''wp'''". | ||
| Строка 51: | Строка 54: | ||
[[Файл:Запуск сценария на дозвон.PNG | center | 700px]] | [[Файл:Запуск сценария на дозвон.PNG | center | 700px]] | ||
| − | + | ||
| − | + | ||
| + | ==Использование библиотеки Okbutton== | ||
| + | |||
| + | Библиотека Okbutton.js позволяет организовать голосовой канал. | ||
| + | |||
| + | '''Ссылка на документацию:''' https://js.oktell.ru/okbutton/ | ||
Текущая версия на 11:13, 31 марта 2023
Содержание
Задача: запуск дозвона на номер с сайта для сотрудников.
Пусть имеется кнопка на сайте с назначенным на нее номером (например, 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/
