📕Приложение В
Администрирование КОСКО УПАТС.
Продукт Router
Является продуктом коммуникационного домена (КД). Предназначен для обработки голосового и не голосового трафика по единым стандартам и правилам.
Продукт Router предназначен для:
управления внутренними SIP-абонентами
управления внешними SIP-транками
управления WebService каналами интеграции
управления WebService Eventing событийными каналами
создания преднастроенных (системных) каналов интеграции с различными сервисами
управления IVR сценариями
управления SVC сценариями и расписанием служебных задач
управления маршрутизацией
управления нормализацией номерной емкости при звонках через SIP-транки и между КД
управления правилами записи разговоров
Для управления КД необходимо авторизоваться через WS сервер того сайта, где обслуживается данный КД.
Первоначальные учетные записи администратора устанавливаются в родительском домене (Мастер домен, Домен управления лицензиями).
Web интерфейс администрирования КД
Аутентификация
Для работы в Web интерфейсе управления КОСКО УПАТС необходимо пройти процедуру аутентификации. Для этого в адресной строке браузера необходимо ввести IP-адрес или URL (fqdn) имя Web-сервера для управления.
Для прохождения процедуры аутентификации необходимо заполнить поля:
После нажатия на Войти система проверит корректность введенных данных.
Если все верно, то откроется Главная страница
Если в учетных данных найдена ошибка, то появится сообщение об ошибке
В случае 3 - х ошибок аутентификации в течении 1 минуты IP адрес источника будет заблокирован на 3 минуты. Если в эти 3 минуты
попробовать войти снова, то счетчик времени блокировки сбросится на 3 минуты вне зависимости от корректности введенных значений. Блокировка действует на Web-сервере
После успешной аутентификации создается сессия, устанавливается cookie (RCookie) браузера и все запросы идут через эту сессию. Для одновременной работы в двух Доменах или под разными учетными записями необходимо открыть два разных браузера или использовать режим инкогнито для второй сессии
Главная страница
Здесь представлены доступные пользователю приложения - администрирования и ролевые. Набор приложений определяется ролями доступа пользователя в текущем домене. При нажатии на область блока приложения производится его запуск в текущем окне. При необходимости приложение можно открыть в новом окне/вкладке средствами браузера.
Общий вид раздела:
Логотип КОСКО УПАТС в верхней части страницы является ссылкой, по которой можно перейти в данное окно из любого раздела системы.
В правой верхней части доступна информация о текущем пользователе и активном домене. При нажатии на кнопку откроется раскрывающийся список, можно выбрать любой из доступных пользователю доменов (без дополнительной аутентификации).
Всякий раз, при выборе нового домена, список разделов главной страницы может изменяться, в зависимости от настроенных в новом домене ролей доступа.
Для завершения сеанса работы и выхода из системы достаточно нажать кнопку в верхней правой части окна.
Основной экран WEB приложения Администрирование
Верхняя часть экранной формы выглядит следующим образом:
Кнопка , расположенная в верхней левой части, и логотип КОСКО УПАТС позволяет вернуться на Главная страница.
В правой верхней части доступна информация о пользователе и активном домене.
Для завершения сеанса работы и выхода из системы достаточно нажать кнопку в верхней правой части окна.
Левая часть экранной формы содержит панель навигации.
С ее помощью можно перемещаться между разделами/объектами администрирования.
Центральная часть экранной формы содержит таблицу с данными выбранного в левой части раздела.
Внизу слева таблицы располагается кнопка "Фокус на таблице". При ее включении (кнопка становится красного цвета) таблица расширяется на весь экран, скрывая левую часть с панелью навигации. Повторное нажатие на эту кнопку возвращает отображение таблицы к исходному виду.
В верхней левой части над таблицей расположено поле для ввода фильтра. Фильтрация позволяет отображать в таблице только те объекты, которые соответствуют критерию фильтра. Фильтр может быть простым (с одним критерием) и сложным (с несколькими критериями, разделенными запятой). При написании фильтра допускается применение масок:
% - любые символы
ИЛИ через ; (например, "a;b" означает поиск a или b)
диапазон чисел
10;50означает поиск в диапазоне [-inf, 10] ИЛИ [50, +inf]
В верхней правой части над таблицей расположены три кнопки Новый объект , Экспорт/импорт и песочные часы.
Кнопка позволяет добавить новую запись в текущий раздел. Набор полей для заполнения и внешний вид формы ввода зависит от текущего объекта и подробно описано в Разделы администрирования.
Кнопка Экспорт/импорт дает возможность восстановить данные из ранее сохраненного файла в формате csv (Импорт) или выгрузить данные из таблицы объектов (Экспорт). Здесь же можно посмотреть шаблон для импорта данных (Шаблон).
Историю изменений свойств объектов можно посмотреть по кнопке
Можно выбрать диапазон дат
В рамках диапазона дат доступны следующие закладки
Все - все события в текущем диапазоне
Добавлено - все новые записи в текущем диапазоне
Изменено - все записи, которые были изменены в текущем диапазоне
Удалено - все записи, которые были удалены в текущем диапазоне
Выбрано - все события по выбранной записи (одной) в текущем диапазоне
Горячие клавиши
При работе с карточкой объекта можно воспользоваться горячими клавишами.
Карточка объекта:
Если в карточке были сделаны изменения система предупредит вас об этом.
В данном окне действуют следующие горячие клавиши:
Во всех приложениях при popup окнах действуют следующие горячие клавиши:
Общие настройки разделов
Маски и модификации
Правила работы с масками
Маскирование используется в КОСКО УПАТС для возможности меньшим количеством правил описать необходимое поведение системы. Маска выделяет значимые символы анализируемых полей для сравнения и принятия решения. В основном используется при обработке звонков.
При создании правил используется механизм базовых символьных правил, основанный на фиксированном местоположении анализируемых символов.
Базовые символьные правила маскирования
При создании маски используются следующие символы:
Примеры масок:
Правила работы с модификаторами
Модификации предназначены для изменения значение поля перед дальнейшей обработкой. На вход подается первоначальное значение, на выходе получаем значение после его обработки.
Использование правил модификации позволяет сократить количество правил, необходимых для обработки полного набора значений входных параметров.
При создании правил модификации могут использоваться два механизма:
базовые посимвольные правила, основанные на подмене
RegEx выражения
Базовые символьные правила модификаций
Правило выполняется над всеми символами входного значения слева направо.
Примеры модификаций
RegEx выражения модификации
Используется php RegEx ядро.
К исходному значению применяется шаблон pattern с опциями opts, и обнаруженный(- ые) блок(-и) заменяется(-ются) на шаблон replace. Результат может снова быть подан на следующую операцию RegEx-модификации, и так далее конечное число раз.
Общая структура записи RegEx-модификатора:
reg - константа
pattern - выражение
substitution - правило выборки
options - опции из (могут не указываться) ◦ g - global ◦ i - case-insensitive
Примеры
Управление расписанием активности правил
При создании определенных правил в КОСКО УПАТС возможно задать расписание их срабатывания.
Расписание определяет время в часовом поясе объекта, когда настройка будет активна. Пример:
Поля управления Расписанием (на примере одного из разделов)
Рис. 8. Экранная форма создания расписания в формате Ручного ввода
Любое время - активность правила не проверяется по времени. Настройка по умолчанию
Рабочие часы - активно в рабочее время. Рабочее время устанавливается в Общие настройки и Рабочее расписание
Вне рабочие часы - активно в нерабочее время
Ручной ввод - правила задаются вручную ниже в интервале активности
Расписание используется в следующих разделах:
Маршрутизация Выбор вектора
Маршрутизация Выбор правила
Правила переадресации
Правила записей разговоров
Разделы администрирования
Каналы коммуникаций
SIP устройства
В этом каталоге создаются учетные записи для подключения абонентских SIP устройств. В качестве абонентов могут выступать
аппаратные SIP телефоны
программные SIP телефоны
WebRTC телефоны
SIP-FXO шлюзы
Статус SIP абонентов
В основной таблице раздела можно отобразить текущее состояние SIP устройств. Изначально столбец Статус скрыт. Для его отображения необходимо поставить галочку слева от записи Статусы (около кнопки Новый объект ).
Для обновления статусов в таблице необходимо использовать кнопку обновления, которая находится справа от Статусы или перезагрузить страницу.
Если хоть 1 устройство зарегистрировано под данной учетной записью, статус имеет значение Зарегистрировано. При одном клике на данный статус внутри таблицы открывается окно с информацией о зарегистрированных устройствах.
Пример информации при одном зарегистрированном SIP устройстве:
Описание полей в ответе:
addr (^) IP-адрес SIP устройства. Если SIP устройство за NAT, то отображается локальный внутренний адрес устройства expires Оставшееся время жизни регистрации, сек. path.domain IP-адрес пограничной роли SG (SIP Gate) через которую это SIP устройство подключено к КОСКО УПАТС path.port Порт роли SG для приема пакетов от SIP устройства path.proto Внутренний транспортный протокол между SG и B2BUA, всегда = TCP path.user Внутренний идентификатор SIP устройства в хранилище КОСКО УПАТС port Порт SIP устройства proto Транспортный протокол, используемый между SIP устройством и ролью SG Описание полей при создании/редактировании записи
Блок Название поля
Основные Отображаемое имя
количество различных SIP устройств, которые могут одновременно быть зарегистрированы под текущей учетной записью
количество лицензий devices которые будут зарезервированы под текущую учетную запись
0 - подключение под этой учетной записью невозможно. Используется для создания номера и использования его для правил маршрутизации, переадресации
1 - только одно устройство единовременно может быть подключено. Значение по умолчанию
2 и более - позволяет подключить несколько SIP устройств одновременно. При звонке на этот номер будет использоваться SIP Forking на все подключенные устройства
Аутентификационные данные
Настройки вызова
1 - Неограниченно (по умолчанию)
0 - Входящие вызовы запрещены
1 и более - ограничение количества занятых линий для входящего звонка
Комментарий
Поле Отображаемое имя
Поле Отображаемое имя может содержать:
буквы русского и английского алфавита
цифры
символы - рекомендуется использовать только
макросы
Доступные макросы:
{D} - подставить исходный DisplayName из входящего запроса
{d} - подставить исходный DisplayName из входящего запроса в нижнем регистре
{U} - подставить исходный UserName из входящего запроса
{u} - подставить исходный UserName из входящего запроса в нижнем регистре
{E} - подставить пустоту
Изменение поле DisplayName отрабатывает для:
INVITE
180 Ringing и 183 Session Progress (поля P-Asserted-Identity, Remote-Party-Id)
200 OK
re-INVITE при SessionChange
SIP провайдеры
В этом разделе создаются SIP транки подключения:
к операторам/провайдерам SIP-телефонии (ITSP)
к пиринговым SIP-АТС предприятия
к SIP-FXO, SIP-E1 шлюзам
Реализовано два типа подключения:
с регистрацией на стороне внешней АТС
без регистрации - доверенное подключение
Общий вид раздела:
Поля, доступные при создании и редактировании записи:
Блок Название поля
Основные Код Код, который используется для ссылок на этого провайдера из других объектов настройки (например, из Правил маршрутизации). Уникальный набор английских букв и цифр Активно Включение/выключение данной учетной записи RoleID конфигурации
Блок (^) Название поля Описание Количество линий Количество линий всего Максимальное количество соединительных линий, которое может быть одновременно задействовано (количество одновременных SIP диалогов). Это лицензируемый параметр из количества доступных внешних линий КД (параметр siptrunks). При достижении лимита новые звонки (входящие и исходящие) будут отклонены Количество исходящих линий Максимальное количество задействованных соединительных линий (количество одновременных SIP диалогов), которое блокирует использование текущего подключения для новых Исходящих звонков. На Входящие вызовы параметр не влияет. Должен быть меньше или равен Количество линий всего. Если не задан, то равен Количество линий всего Аутентификация
С
включено - КОСКО УПАТС регистрируется на удаленной SIP- АТС
выключено - между КОСКО УПАТС и удаленной SIP-АТС устанавливается доверительное подключение без регистрации Имя пользователя
Блок (^) Название поля Описание Подключение Адрес Outbound Proxy-сервер IP/fqdn адрес Outbound прокси-сервера. Если пусто, то не используется. Порт Outbound Proxy-сервер Порт удаленной стороны
Outbound Proxy-сервера, если он задан
SIP сервер, если Адрес Outbound Proxy-сервер не задан
Доп.настройки
включено - все русские буквы в поле DisplayName SIP пакета будут заменены на соответствующие английские (перевод из UTF8 в ASCII)
выключено - изменения в DisplayName не вносятся (значение по умолчанию)
Блок (^) Название поля Описание Настройки медиа (одна из двух настроек должна быть включена) Использовать свой Media шлюз
включено - SIP и RTP трафик отправляются с одного IP на сторону провайдера (требуется корректная настройка в конфигурационном файле роли BGMG (boarder gate Media gate) на сервере с ESG из поля RoleID)
выключено - RTP трафик будет отправляться на сторону провайдера от MG (MediaGate) роли, ближайшей к инициатору вызова (минимально нагруженный MG на сайте, где был инициирован первичный INVITE пакет)
включено - все re-INVITE пакеты прозрачно отправляются на сторону провайдера (обычно используется при связи с другой АТС внутри организации и при режиме работы Без регистрации )
выключено - re-INVITE не отправляются на сторону SIP провайдера и обрабатываются ролью ESG. Обычно используется при подключении к внешним операторам связи и при режиме работы С регистрацией
Блок (^) Название поля Описание Проверка доступности Режимпроверки доступности Используется для проверки доступности SIP провайдера, а также для поддержания NAT сессий. Возможные варианты настройки:
Отключено - проверка доступности выключена
Поддержка открытого NAT (пакет rn) - запросы с типом rn, которые используются только для поддержания работы через NAT (не анализируются в качестве доступности внешнего подключения)
SIP OPTIONS запрос - Основной режим проверки доступности. Отправляется SIP OPTIONS запрос, на который ожидается SIP 200 OK ответ
SIP REGISTER запрос - Вспомогательный режим проверки доступности ТОЛЬКО в случае, если SIP провайдер не поддерживает SIP OPTIONS и работает в режиме С регистрацией. Периодически инициируется сессия регистрации, которая обрывается. Анализируется наличие ответа от удаленной стороны.
STUN взаимодействие - режим проверки доступности через STUN запрос/ответ.
Комментарий
Альтернативные адреса провайдера
При получении любого SIP пакета от провайдера ESG роль проверяет IP адрес на безопасность - IP адрес источника должен находится в списке разрешенных для текущей учетной записи. Если это не так, то пакет отбрасывается.
При указании значения в поле Альтернативные адреса провайдера можно задать несколько значений через запятую. Формат каждого значения должен быть одним из:
protocol:ip/fqdn:port
protocol:ip/fqdn - порт любой
ip/fqdn:port - протокол любой
ip/fqdn - порт и протокол любой
Можно использовать маски и регулярные выражения RegEx.
Маски (только для IP адресов)
от одной до трех цифр (192.168.123.*)
X (одна цифра) (192.168.12X.*)
Регулярные выражения можно использовать для IP адресов и fqdn. Подробное описание в главе Маски и модификации в разделе RegEx выражения модификации. Примеры:
Список разрешенных адресов содержит:
все IP адреса из поля Альтернативные адреса провайдера. Возможно несколько значений через запятую. Указывается IP адрес или fqdn. Если указаны fqdn имена, то в список попадают все адреса, которые получены КОСКО УПАТС при проверке через DNS
все IP адреса из поля Адрес Outbound Proxy-сервер. Возможно одно значение - IP или fqdn. Если указано fqdn имя, то в список попадают все адреса, которые вернутся в ответе от DNS
если поле Адрес Outbound Proxy-сервер пустое, то все IP адреса из поля SIP сервер. Возможно одно значение - IP или fqdn. Если указано fqdn имя, то в список попадают все адреса, которые вернутся в ответе от DNS
Альтернативные Outbound Proxy-серверы
Очередность выбора действующего Outbound Proxy-сервера из возможных вариантов:
Проверяется возможность регистрации/доступности по основным параметрам ◦ Адрес Outbound Proxy-сервер (если задан) или SIP сервер ◦ Порт Outbound Proxy-сервер (если не задан, то 5060) ◦ Транспортный протокол
Если основные параметры дают сбой или происходит ошибка в уже работающей связи, то КОСКО УПАТС начинает проверять доступность оператора (успешная регистрация и/или доступность OPTIONS) через все альтернативные прокси по порядку
Один раз установив регистрацию, сервер продолжает работать с этим прокси вплоть до сброса регистрации, изменения настроек SIP провайдера, либо до ошибки проверки доступности
Состояния подключения и режимы проверки доступности
Подключение считается доступным, если:
Подключение активировано (поле Активно включено)
Регистрация пройдена успешно (если режим С регистрацией ). При ошибке аутентификации повтор через 3 секунды
Количество текущих активных звонков через это подключение меньше, чем значение поля Количество линий всего
Механизм проверки доступности отработал корректно (для режимов SIP OPTIONS запрос, SIP REGISTER запрос и STUN взаимодействие) - на запрос от КОСКО УПАТС получен корректный ответ. Если не получено 3 - х ответов подряд, по транк считается недоступным
Признак доступности транка SIP провайдера влияет на работу Маршрутизации, а именно результирующее действие Внешняя линия применяется только если транк доступен (в противном случае правило игнорируется и проверка маршрутизации продолжается).
Выбор SIP провайдера для входящих INVITE
В КОСКО УПАТС на одном сайте может быть несколько Ролей ESG, которые обслуживают внешние транки различных коммуникационных доменов. Параметр RoleID указывает какую именно Роль будет использовать текущий транк для исходящих и входящих SIP пакетов. При входящем в КОСКО УПАТС SIP INVITE актуальна задача определения какому именно домену и SIP провайдеру принадлежит этот пакет. Алгоритм анализа следующий:
для SIP провайдеров С регистрацией : ◦ В SIP пакете в поле To находится Логин@Домен из настроек SIP провайдера ◦ В SIP пакете в поле From находится Логин@Домен из настроек SIP провайдера
для SIP провайдеров Без регистрации : ◦ В SIP пакете в поле Contact находится Логин@Домен из настроек внешней линии (применяется если поле Имя пользователя не пустое) ◦ В SIP пакете в поле Contact находится *@Домен из настроек внешней линии (применяется если поле Имя пользователя пустое)
Внешние интеграции
В этом разделе создаются внешние интеграционные каналы, посредством которых производится настройка взаимодействия КОСКО УПАТС с внешним миром по интерфейсу http(s) WebHook и WebSocket, а также канал подписки на события из КОСКО УПАТС.
Интеграционные каналы:
Публичный канал – открытый канал интеграции для обработки входящих запросов от внешних систем (при получении запроса запускается указанный SVC сценарий) и для определения URL исходящих запросов
Событийный канал Eventing – канал интеграции, в котором внешние информационные системы получают события от КОСКО УПАТС по активностям, на которые они подписываются
Стартовая страница раздела представлена следующим образом:
Поля, доступные при создании и редактировании записи:
Рис. 14. Экранная форма создания нового объекта
Блок Название поля Описание
Основные Код Код канала интеграции
Публичный канал - тип канала интеграции, при котором фиксируется URL внешней системы для исходящих запросов и определяется SVC сценарий для обработки входящих запросов
Событийный канал Eventing – канал, через который внешние ИС могут подписываться на события из КОСКО УПАТС (подробно Eventing канал подписки на события описан в отдельном документе)
сценарий должен завершится корректно (компонент Стоп)
переменная с именем response_code содержит http код ответа, по умолчанию 200
переменная с именем response_content содержит тело ответа в необходимом формате, по умолчанию отсутствует
переменная с именем response_headers дополнительные заголовки ответа. По умолчанию пустая строка и только стандартные HTTP- заголовки. Если среди указанных заголовков отсутствует стандартный заголовок Content-Type, то по умолчанию его значение устанавливается в application/octet-stream. Пример:
Блок Название поля Описание
Роль WS Локальный токен При получении запроса на этот токен Система идентифицирует его принадлежность к текущему каналу интеграции WebService. Запрос должен прийти на любой WebServer, который может обслуживать текущий домен. Токен генерируется автоматически и не может быть изменен. Адреса на которые можно отправлять запросы от внешних систем ([WS] - IP/fqdn Web Server КОСКО УПАТС):
Публичный канал ◦ WebHook запрос на http(s)://[WS]/api/token/v1/[token_local] ◦ WebSocket подключения на ws(s)://[WS]/api/ws/token/v1/[token_local]
Канал подписки Eventing ◦ WebHook подписка на http(s)://[WS]/api/token/v1/[token_local]/subscri be ◦ WebSocket подключение на ws(s)://[WS]/api/token/v1/[token_local]/subscribe
Внешняя система
Блок Название поля Описание
Сценарии обработки
startparam(1) - JSON-объект связанного с каналом интеграции
startparam(2) - Метод HTTP-запроса. Например, "POST"
startparam(3) - URL HTTP-запроса
startparam(4) - Тело запроса
startparam(5) - Список заголовков из HTTP-запроса
startparam(6) - IP-адрес отправителя HTTP-запроса
startparam(7) - протокол HTTP-запроса
Комментарий
Обработка звонка
IVR сценарии
В этом разделе происходит управление всеми IVR сценариями существующими в рамках данного Коммуникационного Домена.
Поля, доступные при создании и редактировании записи:
Название поля Описание
Код сценария Буквенно-численный идентификатор сценария в рамках Домена. На него ссылаются записи других объектов (например, в Коды абонентских функций). Доступны латинские символы и цифры
Дата последнего изменения сценария
Ссылка на сценарий Открытие сценария на редактирование в новой вкладке браузера
Уровень логирования
Отключено (значение по умолчанию)
Только ошибки
Ошибки и предупреждения
Все события
Комментарии Возможность указать полезную информацию под записью
Очереди
В данном разделе настраиваются очереди обработки звонков группами операторов (SIP устройствами). Очереди могут обслуживать:
входящие вызовы с внешних линий
входящие вызовы с внутренних линий
входящие вызовы от абонентов других доменов
входящие вызовы от IVR сценариев дозвона (для организации исходящего КЦ, прогрессивного/предиктивного обзвона)
Поля, доступные при создании и редактировании записи:
Блок Название поля Описание
Основные
Блок Название поля Описание
Алгоритмы выбора
Каскадный (по умолчанию) - выбирает из свободных ресурсов ровно в том порядке, как они указаны в списке в поле Операторы(агенты)
Случайный - выбирает случайный ресурс из свободных на данный момент
Случайный с учетом приоритетов - выбирает из свободных ресурсов самый приоритетный ресурс, а если их несколько, то выбирает среди них случайным образом
SPQ (Strict Priority Queueing) – режим выбора очереди на основании поля Приоритет очереди. Пока очередь с высоким приоритетом (меньшим числом) не будет свободна, более низкоприоритетные очереди не будут обслуживаться. Если несколько очередей имеют одинаковый приоритет, то выбор по максимальному времени ожидания абонента внутри очередей
WFQ (Weighted Fair Queueing) – режим выбора очереди на основании поля Вес очереди. В данном случае система случайным образом выбирает следующую очередь в соответствии с весом очереди
SPQ+WFQ - режим выбора очереди по алгоритму SPQ, и если несколько очередей выбрано, то между ними выбор по алгоритму WFQ.
Блок Название поля Описание
IVR- сценарии
Блок Название поля Описание
Управление дозвонами до операторов
Управление ожиданием абонента в очереди
Блок Название поля Описание
Постобработка
Комментарии
Групповые номера
Групповой номер - номер, который содержит в себе несколько других номеров и определяет последовательность их вызова системой. В групповой номер могут входить другие групповые номера и номера из SIP устройства.
Номера внутри группового номера объединяются в наборы. Набор - один или несколько равнозначных номеров. Для каждого набора можно определить продолжительность вызова в секундах. По умолчанию продолжительность вызова - 30 секунд.
Поля, доступные при создании и редактировании записи:
Название поля Описание
Тип обхода Определяет последовательность обхода между наборами:
по очереди - обход последовательно с Набор1 до Набор10
все одновременно - звонок отправляется на все наборы одновременно
случайный порядок - последовательность наборов определяется случайно
Подгруппа набора 1 ~ Подгруппа набора 10
Продолжительность вызова набора 1 ~ Продолжительность вызова набора 10
Перехват звонка по групповым номерам
Комментарии Возможность указать полезную информацию под записью
Правила переадресации
В этом каталоге настраиваются правила и виды переадресации по внутренним номерам.
Поля, доступные при создании и редактировании записи:
Блок (^) Название поля Описание Основные Название Текстовое поле не обязательное к заполнению. Возможность указать название правила переадресации Приорите т Приоритет правила. Чем меньше значение, тем выше приоритет Активно Переключатель состояния правила:
true - включено
false - выключено
Безусловная
Нет регистрации
Занято
Нет ответа
Отклонено
Режим DND
Ошибка вызова
Другая причина
Номера переадресаций
Блок (^) Название поля Описание Расписание Расписание Определяет время, когда правило будет Активно Интервал активности (если Расписание = Ручной ввод ) Определяет недельное расписание активности правила. Подробно в Управление расписанием активности правил Комментарий Комментарии Возможность указать полезную информацию под записью Правила переадресации применяются только для вызова внутренних номеров (при срабатывании Выбор правила с действием SIP абонент) Типы переадресаций Тип Описание Безусловная Абсолютная (безусловная) переадресация. Применяется до вызова номера. Срабатывает всегда вне зависимости от состояний изначально вызываемого абонента. Переводит BLF подписки на конечный номер автоматически Нет регистрации Номер определен в SIP устройства, но ни одно устройство не зарегистрировано. Правило проверяется до коммутации на первоначальный номер Занято Вызываемый номер занят, применяется при SIP коде ответа 486 Нет ответа Нет ответа в течении заданного времени вызова (поле Продолжительность вызова в SIP устройства) либо получен SIP код ответа 408 Отклонено Вызов отклонен. Применяется при SIP коде ответа 603 Режим DND На SIP устройстве включен режим DND, применяется по SIP кодам ответа 404 или 480 Ошибка вызова По любой ошибке системы (любая нештатная работа) Другая причина Пришел не обрабатываемый SIP код ответа
Пример:
Обработка сервиса
Служебные сценарии
В этом разделе происходит управление существующих служебных сценариев в рамках данного Домена.
Поля, доступные при создании и редактировании записи:
Название поля Описание
Название сценария Название сценария удобное для восприятия. Возможно использовать русские и английские символы, пробел, цифры
Код сценария Буквенно-численный идентификатор сценария в рамках Домена. На него ссылаются записи других объектов. Доступны латинские символы и цифры
Дата последнего изменения сценария
Ссылка на сценарий Открытие сценария на редактирование в новой вкладке браузера
Уровень логирования
Отключено (значение по умолчанию)
Только ошибки
Ошибки и предупреждения
Все события
Комментарии Возможность указать полезную информацию под записью
Служебные задачи
В этом разделе настраиваются правила запуска Служебные сценарии по расписанию
Поля, доступные при создании и редактировании записи:
Одноразовый запуск в заданное время
Периодический многократный запуск
включено - допускается одновременное выполнение нескольких экземпляров служебного сценария
выключено - перед стартом нового экземпляра проверяется факт завершения предыдущей копии. Если не завершена, то новый экземпляр не запускается
(^) Расписание Только для многократного запуска. Определяет время, когда правило будет Активно
Любое время - активность правила не проверяется по времени. Настройка по умолчанию.
Рабочие часы - активно в рабочее время настройки домена
Вне рабочие часы - активно в нерабочее время
Ручной ввод - правила задаются вручную
Ролевые приложения
В этом разделе настраиваются Ролевые приложения и происходит управление ролями доступа Пользователей к Ролевым приложениям на Главной странице
Поля, доступные при создании и редактировании записи:
Установка ролевого приложения
Создать Служебный сценарий
Создать RoleApp приложение. Подробнее в Файл ролевого приложения
Создать новую запись в текущем разделе
Выгрузить zip-архив с RoleApp a. получить ID Ролевого приложения (после создания открыть карточку на редактирование и скопировать значение поля id) b. выгрузить zip-архив используя HTTP метод PUT на URL-адрес указав Content-Type = multipart/form-data
Проверить корректность загруженного файла a. выполнить HTTP запрос на тот же адрес методом GET b. загрузится файл attachment (переименовать в attachment.zip и он должен быть равен первоначально загруженному zip-архиву)
После установки ролевого приложения и корректной связи по ролям доступа с Пользователи оно появляется в списке приложений на Главная страница.
Файл ролевого приложения
Ролевое приложение представляет из себя zip-архив, который будет распакован на сервере при установке. Архив содержит в себе две значимые части:
Файл roleapp.json содержит описание приложения
Непосредственно web-приложение, выполняемое на стороне браузера
Пример структуры файлов Ролевого приложения:
Файл roleapp.json
Должен быть валидным json файлом, размер которого не превышает 10Kb. Пример json файла:
Название ключа Описание
name Название ролевого приложения. Значение поля будет использовано для названия ролевого приложения на Главная страница если поле Название приложения не заполнено. Тип поля – строка Обязательная переменная
description Описание ролевого приложения. Значение будет отображаться на Главная страница в блоке Ролевого приложения. Тип поля – строка Обязательная переменная
order Порядок^ ролевого^ приложения^ при^ сортировке^ Главная^ страница. Тип поля – число Необязательная переменная
iconPath Путь до иконки в архиве приложения относительно папки ролевого приложения. Иконка будет отображаться на Главная страница Обязательная переменная
Название ключа Описание
folder (^) Подпапка внутри архива в качестве папки с web-документами (по умолчанию используется весь архив от корня) Необязательная переменная Если указан, то в результате по url установленного приложения будет доступен не корень архива, а указанная подпапка (в url не появляется). Например, если “folder”:”dist”, то index.html должен быть размещен в подпапке dist и файл roleapp.json нельзя будет получить из прямого URL (/app/appname/roleapp.json ) ├── dist │ └── index.html └── roleapp.json Для получения примера Ролевого приложения можно обратиться в службу Технической Поддержки
Маршрутизация
Выбор вектора
Любой вызов, который поступает в КОСКО УПАТС проходит через Маршрутизацию. Цель маршрутизации - определить где находится Номер В и отправить на него INVITE.
Настройка маршрутизации двухфакторная:
первым выбирается вектор (настройки текущего раздела)
затем внутри вектора выбирается результирующее правило (настройки раздела Выбор правила)
если результирующего правило внутри вектора не найдено, то проверяются остальные векторы
если результирующее правило не найдено по всем правилам маршрутизации, то вызов отклоняется
Данный раздел предназначен для настройки правил выбора вектора.
Поля, доступные при создании и редактировании записи:
Блок Название поля Описание
Основные Название Текстовое название вектора для визуальной идентификации Приоритет Определяет порядок проверки правил (чем меньше значение, тем выше приоритет) Вектор Текстовое поле указания Вектора. Несколько правил могут ссылаться на одно текстовое значение
Блок Название поля Описание
Фильтрация
(правила написания масок в Правила работы с масками)
правило для всех направлений
Внутренние SIP абоненты - абоненты, определенные в разделе SIP устройства
Внешние SIP операторы - внешние линии, определенные в разделе SIP провайдеры
Другие КД - звонок из другого КД текущей копии КОСКО УПАТС. Может быть ◦ SIP абонент другого КД ◦ внешняя линии другого КД ◦ транзитно через другой КД
Расписание
Комментарий
Выбор правила
В текущем разделе создаются правила управления маршрутизацией внутри вектора (вектор выбирается в разделе Выбор вектора).
Если в результате обработки правил не будет выбрано результирующее (ни одно правило не сработает или не может быть применено), то происходит возврат в раздел Выбор вектора и далее дальнейший поиск подходящего вектора.
Поля, доступные при создании и редактировании записи:
Рис. 30. Экранная форма создания нового объекта
Блок Название поля Описание
Основные Название Текстовое название правила для визуальной идентификации Вектор Выбор вектора из созданных в разделе Выбор вектора. Идентификация происходит по текстовому совпадению Приоритет Определяет порядок проверки правил (чем меньше значение, тем приоритетнее) Действие Определяет результирующее действие текущего правила:
Внутренний абонент - на номер, определенный в каталогах SIP устройства и Групповые номера
В другой КД - запрос дальнейшего действия будет отправлен в таблицу маршрутизации домена их поля "КД получателя"
Внешняя линия - вызов будет отправлен на выбранного в поле Оператор SIP для внешнего звонка SIP провайдера
Код абонентских функций - дальнейшая обработка звонка по логике, определенной в каталоге "Коды абонентских функций"
Запретить вызов - вызов будет завершен и отправлен инициатору SIP пакет с кодом 403
правило для всех направлений
Внутренние SIP абоненты - абоненты, определенные в разделе SIP устройства
Внешние SIP операторы - внешние линии, определенные в разделе SIP провайдеры
Другие КД - звонок из другого КД текущей копии КОСКО УПАТС. Может быть ◦ SIP абонент другого КД ◦ внешняя линии другого КД ◦ транзитно через другой КД
(^) Маска номера источника Маска для Номера А (^) Маска КД источника Маска имени домена, откуда пришел запрос на маршрутизацию в текущий домен Заполнение поля актуально для Направление источника = * или Другие КД (^) Маска оператора SIP телефонии Маска для фильтрации SIP провайдеры по полю Код Заполнение поля актуально для Направление источника = * или Внешние SIP операторы (^) Маска номера назначения Маска для Номера В Модификация (правила написания модификаторов в Правила работы с модификаторами) Изменение номера источника Правило позволяет изменить номер источника. Используется ТОЛЬКО при обработке следующими правилами маршрутизации. Данный модификатор изменяет Номер А в INVITE правой стороны (для этого используются Нормализация кросс-доменных звонков при звонках между доменами или Нормализация номеров внешних линий при звонках на внешнюю линию. По умолчанию - T Изменение номера назначения Модификатор изменяет Номер В, который далее используется для обработки следующими правилами маршрутизации и в поле To INVITE правой стороны. По умолчанию - T
Блок Название поля Описание
Расписание Расписание Определяет время, когда правило будет Активно
Комментарий
Коды абонентских функций
В этом разделе настраиваются правила маршрутизации и применения Кодов абонентских функций. С точки зрения логики обработки звонков Коды абонентских функций являются обычными номерами, которые могут маршрутизироваться по общим правилам маршрутизации между доменами и отличаются только действием в Выбор правила.
Поля, доступные при создании и редактировании записи:
префикс - значение из текущего поля
остаток - Номер В за вычетом префикса
Перехват звонка
Перехват звонка по групповым номерам
Конференция - запуск/вход в конференц-комнату
Сценарий IVR - запуск IVR-сценария по коду
Очередь - перевод звонка в голосовую очередь
Голосовая почта - работа с сообщениями в ящике голосовой почты
Отправка голосовой почты - прием сообщения голосовой почты и размещение его в ящике
Парковка - расположение абонента на парковочном месте
Взятие с парковки - освобождение парковочного места и взятие припаркованного абонента в разговор
Интерком - вызов абонента в режиме громкой связи
Вторжение - вызов абонента с принудительным прерыванием его текущего разговора (постановка на удержание)
Перехват звонка
Перехват звонка с указанием точного номера, с которого необходимо сделать перехват на текущего абонента. В качестве префикса задается featurecode, а остаток определяет абонентский номер перехвата.
Пример :
Перехват звонка по групповым номерам
Перехват звонка только с тех номеров, которые объединены с текущим через любой Групповые номера с установленным признаком Участвует в Перехват звонка по групповым номерам. Если звонят несколько номеров, объединенных с перехватывающим, то перехват осуществляется для наиболее долго звонящего. Используется только значение Префикс (остаток не используется).
Пример
Конференция
Управляет создание неуправляемых конференц-комнат типа meet-me. Префикс определяет featurecode, остаток определяет номер конференц-комнаты.
Если конференц-комната не существует, то она создается при первом звонке на нее. Если конференц-комната существует, то абонент добавляется в нее. Конференц-комната удаляется при выходе из нее последнего участника
Длина номера конференц-комнаты может быть любой (определяется правилами Маршрутизация до попадания в таблицу КАФ). Права доступа разграничиваются на базе Выбор правила.
Пример
При необходимости создать “закрытую” комнату для сбора совещаний секретарем необходимо:
Сценарий IVR
Переключение на IVR сценарий автоматического обслуживания абонента в голосовом и сервисном режиме. Остаток не используется. В поле Дополнительный параметр выбирается IVR сценарий запуска.
Очередь
Переключение в Очередь обслуживания голосовых вызовов. Идентификация очереди возможна двумя вариантами:
в поле Дополнительный параметр необходимо указать значение из поля Номер Очереди для идентификации
если Дополнительный параметр пуст, то Номер Очереди берется как Остаток
Голосовая почта
Данных featurecode осуществляет переключение на сервис работы с сообщениями, находящимися в голосовом ящике. Алгоритм обслуживания определен скрытым IVR- сценарием и может быть переназначен в рамках домена. Номер голосового ящика вычисляется как Остаток. На телефоне MWI должен быть настроен как Префикс+Остаток того голосового ящика, который необходимо "мониторить".
Вопросы безопасности решаются в рамках маршрутизации в Выбор правила.
Пример
Отправка голосовой почты
Данный featurecode осуществляет переключение на запись (оставление) голосового сообщения. Алгоритм обслуживания определен скрытым IVR-сценарием и может быть переназначен в рамках домена. Номер почтового ящика вычисляется как Остаток. Обычно применяют условные Правила переадресации для переключения в Голосовую почту.
Голосовой ящик - номер в рамках домена КОСКО УПАТС, не связанный с номерами SIP устройства. Количество голосовых ящиков не лимитируется.
Пример
Безопасность решается на уровне правил маршрутизации.
Парковка
Данный featurecode осуществляет постановку вызова на парковочное место. Каждое парковочное место одновременно может обслуживать только одного абонента. Алгоритм обслуживания определен скрытым IVR-сценарием и может быть переназначен в рамках домена. Номер парковочного места вычисляется как Остаток.
Пример
Взятие с парковки
Данный featurecode осуществляет взятие вызова с парковочного места. Алгоритм обслуживания определен скрытым IVR-сценарием и может быть переназначен в рамках домена. Номер парковочного места вычисляется как Остаток.
Пример
Интерком
SIP-телефон вызываемой стороны автоматически отвечает на вызов и переводится в режим громкой связи (функция должна поддерживаться SIP-телефоном и быть включена на нем). Остаток определяет номер вызываемого абонента в режиме Интерком. После его выделения запускается маршрутизация от А до Остаток и в результате будет вызов в режиме Интерком. В случае срабатывания Правила переадресации происходит блокировка в целях обеспечения безопасности.
Пример
Вторжение
При срабатывании кода Вторжение происходит выделение номера (Остаток), по которому нужно сделать звонок, и он направляется на новый цикл поиска правил. Если действие результирующего правила из Выбор правила НЕ “Внутренний абонент”, то отправляется обычный вызов. Иначе проверяется текущий статус SIP-абонента:
абонент свободен - отправляется обычный вызов
абонент занят - отправляется вызов в режиме Интерком (если у вызываемого абонента (абонент B) достигнуто ограничение Количество одновременных вызовов в настройках SIP устройства, то оно игнорируется). В этом случае тот абонент, с кем разговаривал абонент B ставится на удержание, а абонент B продолжает разговор с абонентом, кто позвонил через вторжение.
Пример
В системе определен FeatureCode 94 как номер Вторжение (Маска номера назначения = *94#) Абонент А набирает *94#1006 Система разбирает номер на составляющие части Если абонент B с номером 1006 занят (находится в разговоре с абонентом C), то вызов на В выполняется в режиме Интерком. Абонент C ставится на удержание, номер 1006 вступает в разговор с абонентом А. На аппарате абонента B (номер 1006) должен поддерживаться режим Интерком Абонент B не теряет разговор с абонентом С, он может переключаться между абонентами, соединить А и С, перевести А и/или С на другой номер, создать трехстороннюю конференцию
Нормализация номеров
Нормализация кросс-доменных звонков
Этот раздел позволяет управлять номером источника (Номером А) при звонках между КД (при кроссдоменных звонках). Номер назначения (Номер В) меняется в Маршрутизации.
Настройки позволяет гибко создавать глобальную номерную емкость без изменения внутри доменных правил и учетных записей.
Примеры использования функционала:
Корректное модификация номера А в случае пересекающейся номерной емкости между КД
Корректное модификация номера А в случае переводов звонка
Создание глобальной номерной емкости распределенной системы поверх локальных пересекающихся номерных планов различных подразделений (разных КД)
Логика проверки правил:
первое сработавшее правило является окончательным и останавливает дальнейшую проверку)
последовательность проверки правил: a. начале проверяются правила в домене получателя звонка b. если проверка в КД получателя не дала результата, то проверяется таблица в домене источника звонка c. если проверка в КД источника не дала результата, то проверяется таблица в КД уровня L1, который является родителем по иерархии домена источника звонка
Поля, доступные при создании и редактировании записи:
Блок Название поля Описание
Основные Приоритет Определяет порядок проверки правил (чем меньше значение, тем выше приоритет)
Результирующее действие
применить правило - текущее правило модификации Номера А будет применено, дальнейший поиск будет остановлен
закончить проверку - закончить проверку по текущей таблице и перейти к следующей таблице по логики обработки
Блок Название поля Описание
Фильтрация для правила
правило для всех направлений
входящий в текущий КД
исходящий из текущего КД
Комментарий
Нормализация номеров внешних линий
Этот раздел предназначен для управления нормализацией основных полей при входящих и исходящих SIP пакетах с SIP провайдеры.
Поля нормализации:
Номер А
Имя отображения А (DisplayName A)
Номер В
Примеры использования функционала:
Если по одной учетной записи SIP провайдера подается несколько номеров, то при исходящем звонке необходимо корректно подставить один из них (к примеру в зависимости от номера внутреннего абонента)
При входящем звонке от SIP провайдера, который подключен к другой IP-АТС компании, необходимо нормализовать номер источника для поддержания глобальной внутрикорпоративной маршрутизации
Поля, доступные при создании и редактировании записи:
Блок Название поля Описание
Основные Приоритет Определяет порядок проверки правил (чем меньше значение, тем выше приоритет) Оператор SIP телефонии
Блок Название поля Описание
Фильтрация для правила
исходящий на внешнюю линию (от КОСКО УПАТС на внешнего SIP провайдера)
входящий с внешней линии (от внешнего SIP провайдера на КОСКО УПАТС)
Модификация данных
Комментарий
Раздельная модификация Номера А и В
Если стоит задача модификации Номера А (50 номеров) и Номера В (40 номеров) независимо друг от друга, то для решения этой задачи полным перебором необходимо создать 50*40=2000 правил модификаций.
Для упрощения задачи введен режим независимой модификации вначале Номера А и DisplayName, а затем Номера В. Для включения этого режима на первом сработавшем правиле поле Изменение номера назначения должно быть равно priority=X, где X - любое не отрицательное число. В этом случае алгоритм работы будет следующим:
Управление записями разговоров
Правила хранения записей
В этом разделе настраиваются правила хранения записей разговоров.
Поля, доступные при создании и редактировании записи:
При удалении правила все закрепленные за данным правилом записи разговоров будут удалены ближайшей операцией.
При изменении периода хранения в большую сторону. Ближайшей операцией производится перерасчет периода хранения записи разговора. Запись разговора будет хранится дольше на количество увелеченных дней.
При изменении периода хранения в меньшую сторону. Ближайшей операцией производится перерасчет периода хранения записи разговора. Запись разговора будет хранится меньше на количество уменьшенных дней. Если срок хранения уже истек, то запись разговора будет удалена в ближайшую ночь.
Правила записей разговоров
В этом разделе настраиваются правила записи разговоров.
Поля, доступные при создании и редактировании записи:
Выключено - разговор не будет записан
Правило хранения (^) Выпадающий список правил, созданных в разделе Правила хранения записей
(Любое направление) - правило для всех направлений
А и B в текущем КД - звонки между абонентами текущего КД
Входящий звонок в текущий КД - внешние звонки в текущий КД (с внешней линии или из другого КД)
Исходящий звонок из текущего КД - звонки из текущего КД наружу (на внешнюю линию или в другой КД)
Сработавшее правило является конечным (проверка подходит ли правило осуществляется по полям блока Фильтрация)
Настройки домена
Общие настройки
В данном разделе находится информация по текущему КД. Создавать и удалять записи в этом каталоге нельзя. Для редактирования поля необходимо на нем два раза кликнуть.
Название поля Описание
Зарезервировано лицензий для устройств КД
devices - количество учетных записей SIP устройств
ivrscripts - количество IVR Сценариев
sipqueue - количество операторов в очередях КЦ
siptrunks - количество линий в SIP операторах
svcscripts - количество SVC Сценариев
webservice_public - количество Внешних интеграций с типом Публичный канал
webservice_subscr - количество Внешних интеграций с типом Событийный канал Eventing
{
Рабочий график Режим графика работы:
0 - не задан
1 - ручной ввод в поле Рабочее время
2 - наследование от родительского домена
Редактирование рабочего времени
Для редактирования рабочего времени необходимо кликнуть по таблице 2 раза, выделить нужное время и нажать на кнопку сохранить. Выделенное рабочее время, подсвечивается красным цветом.
S3 объектное хранилище
Задается массив подключений.
Необходимо указать только один элемент массива.
Пример:
Ключ Yandex speechkit
Сервис Yandex speechkit позволяет распознать или озвучить любой текст.
Для настройки необходим выполнить следующее:
Создать Сервисный аккаунт Яндекс
Назначьте сервисному аккаунту роль editor или выше на каталог, в котором он был создан
Создать API ключ для Сервисный аккаунта https://cloud.yandex.ru/docs/iam/operations/ api-key/create
Загрузить этот API ключ в настройки КОСКО УПАТС
После этого все обращения в YSK будут использовать этот API ключ для авторизации.
Пользователи
В этом каталоге настраиваются пользователи и администраторы коммуникационного домена.
Стартовая страница раздела представлена следующим образом:
Поля, доступные при создании и редактировании записи:
Ролевых приложений. Список ролей и доступ к приложениям определяется при создании Ролевые приложения
Системных Web приложений. Подробно в Роли системных Web приложений
Роли системных Web приложений
Рабочее расписание
В данном разделе указываются исключения для рабочего графика работы текущего Домена. Сам рабочий график настраивается в Общие настройки в блоке Рабочий график и Рабочее время.
Поля, доступные при создании и редактировании записи:
выключено - разовое правило
включено - ежегодное правило
Название поля Описание
Тип Указывается тип дня после замены:
Нерабочий день - указанный день будет нерабочим
Рабочий за день недели - указанный день будет вместо другого дня
Согласно настройке - ручная настройка расписания
Замена дня недели
За указанный день - признак дня неделе не меняется
Понедельник - работа в указанный день по Понедельнику
Вторник - работа в указанный день по Вторнику
Среда - работа в указанный день по Среде
Четверг - работа в указанный день по Четвергу
Пятница - работа в указанный день по Пятнице
Суббота - работа в указанный день по Субботе
Воскресенье - работа в указанный день по Воскресенью
Комментарии Возможность указать полезную информацию под записью
Адресная книга
Этот раздел позволяет управлять адресной книгой в рамках Домена. Данные могут быть синхронизированы с внешними системами учета кадров (например, с AD/LDAP) через служебный сценарий по расписанию, а также могут быть заполнены вручную. Объект используется для:
Селекторных совещаний
DisplayName SIP устройств
Поля, доступные при создании и редактировании записи:
Блок Название поля Описание
Номера телефонов
Должность
E-mail E-mail адрес Почтовые адреса для связи. Поле несет в себе
Комментарий
Last updated