Документация Phone Desktop Assistant v 0.2
Приложение «Phone Desktop Assistant» предназначено для установки на рабочий компьютер, чтобы расширить функционал телефонного аппарата, включенного в ECSS-10.
Основные возможности:
- Вызов любого абонента из приложения;
- Прием входящего вызова, в свернутом положении — всплывающее окно с возможностью принять/отменить вызов;
- Перевод вызова;
- Запись разговора — включение/отключение до или во время разговора;
- Корпоративный или персональный справочник с возможностью поиска по номеру или имени;
- Просмотр истории вызовов;
- Click2call — работа со ссылками типа «tel:<number>» из приложения;
- Русский/английский интерфейс;
- Регулируемые размеры окна, сворачивание в трей;
- Вкладка настроек подключения и языка интерфейса.
Доступны сборки для ОС Winows 7 / Windows 10, а также для Linux (Ubuntu).
Инсталляция приложения
Инсталляция приложения в OC Windows
Установочный файл можно получить, обратившись в службу технической поддержки.
- Необходимо запустить ecss-phone-desktop-assistant Setup <version>.exe:
- После чего нужно разрешить приложению установку кнопкой «Да».
- По завершении установки необходимо нажать кнопку «Готово ».
Настройки приложения находятся по следующему пути:
c:\Users\<UserName>\AppData\Roaming\ecss-phone-desktop-assistant\
Файл user-preferences.json имеет следующее содержание:
{"windowBounds":{"width":400,"height":500},"secureNginx":true,"nginxPort":8098,"secureWebSocket":true,"webSocketPort":"8099","windowOffset":{"x":1145,"y":431,"width":400,"height":500},"nodeWebSocketProxyURL":"wss://192.168.1.21:8099","locale":"ru","callApiServer":"192.168.1.21"}
Для входа в приложение необходимо заполнить имя или IP сервера. Порт по умолчанию — 8099,
где
- <адрес сервера> — любой доступный адрес ECSS-10.
На странице авторизации нужно указать номер в качестве логина и пароль, полученный у системного администратора:
В случае, если не выбран профиль — необходимо выбрать профиль с названием default.
При вводе неправильного логина или пароля приложение выведет ошибку:
После успешного логина приложение готово к работе:
При выходе из приложения — оно сворачивается в трей, его можно запустить кликнув мышкой по иконке:
После выхода из приложения настройки местоположения и размера окна сохраняются.
Инсталляция приложения в ОС Linux
Рассмотрим установку приложения на примере Ubuntu-18.04.
Сам пакет можно получить обратившись в техническую поддержку. После получения можно установить с помощью менеджера приложений или командой в терминале:
sudo dpkg -i ecss-phone-desktop-assistant_<version>_amd64_ubuntu18.deb
Чтобы получить пароль для доступа к своему аккаунту, необходимо обратиться к администратору своего домена или администратору ECSS.
Настройка бэкэнда и создание аккаунтов описаны в разделе «Интеграция ECSS-10 с Phone Desktop Assistant».
ВНИМАНИЕ! Не нужно получать пару SIP логин/пароль. Нужен пароль именно для доступа к сервису ассистент (выставляется на алиасе).
Также, для вашего абонента будут подключены необходимые услуги и сделаны необходимые настройки.
В основном меню приложений появится ECSS Phone Desktop Assistant.
При входе настраивается номер телефона, для которого будет работать приложение:
Первый раз приложение потребует указать адрес сервера, к которому необходимо подключиться, нужно указать имя или адрес сервера и порт,
где:
- <Адрес> — имя или адрес сервера ECSS, можно использовать любой доступный IP;
- <Порт> — порт, на который отправлять запросы, по умолчанию — 8099;
На следующем шаге необходимо заполнить номер телефона и пароль, которые получены у системного администратора:
В случае, если не выбран профиль — необходимо выбрать профиль с названием default.
По умолчанию соединение является защищенным.
Во вкладке «Настройки» хранятся данные о серверах:
После ввода адреса/порта нажать кнопку «Подключиться».
На странице авторизации нужно указать номер в качестве логина и пароль, полученный у системного администратора.
Также на этой странице можно сменить язык интерфейса нажав кнопку «English (Русский)»:
При вводе неправильного логина или пароля приложение выведет ошибку:
После успешного логина приложение готово к работе:
Настройки приложения сохраняются в домашнем каталоге пользователя в файле:
~/.config/ecss-phone-desktop-assistant/user-preferences.json
Описание работы приложения
Приложение позволяет расширить функционал обычного телефонного аппарата:
Предварительные условия (настройки аккаунта на сервере) — у абонента тип терминала должен быть smart, активированы услуги chold, ctr, clip, cnip.
Установка описана в разделе Инсталляция приложения.
Интерфейс
Окно приложения состоит из двух частей: слева функциональная панель с вкладками, справа соответствующая рабочая область.
Иконки вкладок панели функционального меню имеют подсказки (при наведении курсора), но при желании его можно развернуть, нажав снизу кнопку разворачивания панели — .
Размеры окна можно изменять, передвигать, а также сворачивать в системный трей. Имеются русский и английский интерфейсы.
Верхняя панель окна(пример)
Элементы панели
Статус подключения | |
240100 | Номер |
Светлана | Имя |
Выйти(сменить пользователя) | |
Свернуть(компактный вид) | |
Закрыть(в системный трей) |
При сворачивании окно принимает компактный вид:
В этом состоянии оно всегда находится поверх других окон. Его также можно передвигать за верхнюю панель. Местоположение окна сохраняется.
При закрытии окно приложения сворачивается в системный трей, при клике выводится контекстное меню с выбором, показать или закрыть приложение:
Обзорная панель (Dashboard)
Обзорная панель (Dashboard) — основная рабочая зона приложения. Здесь можно сделать или принять вызов, переадресовать, поставить на удержание и включать/отключать запись разговора.
В поле поиска можно вводить как номер, так и имя. Работает по неполному совпадению.
Вызовы (Calls)
Вызовы (Calls) — страница истории вызовов с настраиваемым фильтром. Фильтр работает по неполному совпадению.
Фильтр по направлению работает по следующим признакам:
- Все;
- Входящие;
- Исходящие;
- Пропущенные входящие;
- Неотвеченные исходящие;
- Все перехваченные.
Корпоративный справочник
На вкладке «Корпоративный справочник» можно выбрать номер для вызова. Работает поиск как по имени, так и по номеру.
Настройки
На вкладке настроек можно изменить настройки соединения с сервером, а также выбрать язык интерфейса (русский или английский).
Возможности приложения
Исходящий вызов
Вводим в поле номер телефона Б или имя. Работает поиск по неполному совпадению.
Нажимаем на карточку найденного в списке абонента.
Одновременно идет вызов на аппарат номера, привязанного к приложению (Callback) и на номер Б. Если на телефонном аппарате (A) разрешено принятие интеркома, происходит автоподнятие трубки и включение громкой связи.
Идет вызов на абонента Б, появляется панель вызова. Присутствует возможность во время вызова отклонить соединение, а также включить запись разговора до или после ответа абонента.
Карточка вызова после ответа:
Также возможна интеграция обработчика ссылок типа «tel:<tel_number>» в системе. Например, после выбора обработчика доступен вызов по номерам в приложении 2ГИС:
Клик по номеру телефона вызывает меню выбора обработчика в браузере:
Можно выбрать обработчик «ecss-phone-desktop-assistant». Кликнуть на чекбокс, чтобы «Запомнить мой выбор» для открытия ссылок «tel:».
Входящий вызов
В приложении можно принять входящий вызов. Окно может быть свернуто в трей, но при поступлении входящего вызова выходит всплывающее окно, где можно принять или отклонить вызов.
Во вкладке обзорной панели можно также включить и запись разговора.
Перевод вызова
Если во время разговора нужно сделать трансфер на другой номер — необходимо нажать иконку «Переадресация звонка» на панели вызова.
В появившемся поле нужно ввести номер или имя абонента, которому необходимо перевести вызов, выбрать из списка, нажать иконку «+» и кнопку «OK».
После нажатия «ОК» идет освобождение номера А и соединение абонентов В и С.
Удержание вызова
Приложение позволяет ставить на удержание абонента Б.
После поднятия трубки абонентом Б возможно его взятие на удержание нажатием «Удержание вызова».
Абонент Б переходит в режим удержания и слышит музыку.
Далее у абонента А есть возможности совершить другой вызов, снять абонента Б с удержания или закончить звонок:
Запись разговора
В ассистенте реализована возможность записи разговора. Эта функция работает после нажатия на кнопку «Начать запись разговора» .
В любой момент запись можно остановить кнопкой
После завершения вызова можно скачать или прослушать запись, кликнув в журнале вызовов на записи иконку дополнительной информации .
Скачивание:
Прослушивание:
Передвижением ползунка прогресса можно прослушать любую часть разговора. Доступен также регулятор громкости воспроизведения.
Перехваты вызовов
Услуга перехвата вызовов для пользователя должна быть активирована администратором виртуальной АТС. Описание услуги приведено в разделе Перехват вызова (Pickup).
Если входящий/исходящий вызов был перехвачен или вызов был перехвачен из приложения, в истории вызовов при клике на иконку информации можно получить подробности об использовании сервиса.
Для удобства и эффективного поиска присутствует возможность использования фильтров. Пример:
- 1 — выбираем только перехваченные вызовы;
- 2 — клик на иконку информации об использованных сервисах
- 3 — распахиваем список использованных сервисов для данного вызова;
Функционал приложения постоянно расширяется, желательно следить за выпуском новых версий.