Особенности настройки Tariscope для анализа CDR от 3CX Phone System

Tariscope (SoftPI) позволяет вам собирать, обрабатывать и анализировать информацию о вызовах из различных телефонных систем, включая 3CX Phone System различных версий. Tariscope обеспечивает огромное число преимуществ для работы с 3CX Phone System. С перечнем этих преимуществ вы можете познакомиться в следующей странице.

В целом конфигурация Tariscope для 3CX Phone System аналогична настройке для работы с любой АТС, и описание этой настройки вы можете найти в документе “Tariscope 4.x. Руководство администратора”.

Мы рассмотрим только особенности конфигурации Tariscope именно для 3CX Phone System.

Выбор 3CX Phone System в Tariscope. Конфигурация основных параметров

Выбор типа АТС, с которой Tariscope будет собирать и обрабатывать CDR данные, может быть выполнен как на стадии первоначальной настройки, так и на стадии специфической конфигурации.

Если вы выполняете первоначальную настройку Tariscope, вам следует выбрать 3CX Phone System на 4-м шаге этой настройки.

Описание специфической конфигурации вы можете прочитать в следующей статье.

Подключение к 3CX Phone System

Для сбора CDR данных используется служба Tariscope Observer. Вам следует создать новый профиль для сбора данных с 3CX Phone System. Как настроить формат данных CDR в 3CX Phone System, вы может познакомиться в статье.

3CX Phone System может использовать три способа для передачи CDR в биллинговую систему:

• Файл в папке. Файл может содержать либо все вызовы, либо может генерироваться для каждого вызова отдельно.
• Служба 3CX CDR работает как TCP сервер.
• Служба 3CX CDR работает как TCP клиент.

Для первого варианта служба Tariscope Observer должна использовать в качестве источника данных значение Папка и файл.

Для второго варианта служба Tariscope Observer должна использовать в качестве источника данных значение TCP клиент.

Для третьего варианта служба Tariscope Observer должна использовать в качестве источника данных значение TCP сервер.

Мониторинг вызовов в реальном времени

Tariscope позволяет вам отслеживать вызовы в реальном времени. Для этого вы должны иметь лицензию Tariscope с функцией ограничения, установить флаг в позиции Мониторинг активных вызовов при настройке параметров сбора CDR, и установить клиентские приложения Tariscope на компьютере, где установлена IP-АТС 3CX Phone System.

Tariscope Observer содержит страницу Активные вызовы, которая позволяет отслеживать вызовы в реальном времени. Пример страницы Активные вызовы показан на рисунке 1.

Рисунок 1

Эта страница отображает вызовы, которые выполняются в текущий момент или которые закончились не более чем одну минуту назад. Каждый вызов отображается в таблице в виде двух строк: Исходящей и Входящей ветвей вызова.

Таблица содержит следующие столбцы:

• ID вызова. Отображается идентификатор вызова.
• ID. Отображается идентификатор ветви вызова.
• Дата начала. Отображается дата и время создания ветви вызова.
• Направление. Отображается направление ветви вызова. Существует два типа направлений: Исходящий и Входящий. Направление Исходящий назначается для каждой ветви вызова, где поле Номер A отображает телефонный номер вызывающей стороны. Направление Исходящий применяется для каждой ветви вызова, где поле Номер A отображает телефонный номер вызываемого абонента.
• Статус. Отображается статус ветви вызова.
• Номер А. Для внутренних вызовов, это поле отображает телефонный номер вызывающего абонента в Исходящей ветви вызова и телефонный номер вызываемого абонента для Входящей ветви вызова. Для исходящих вызовов, это поле показывает внутренний номер вызывающего абонента для Исходящей ветви вызова и номер шлюза для Исходящей ветви вызова.
• Номер B. Для внутренних вызовов, это поле отображает телефонный номер вызываемого абонента в Исходящей ветви вызова и телефонный номер вызывающего абонента для Входящей ветви вызова. Для внешних исходящих вызовов, это поле отображает набранный номер для обоих ветвей вызова.
• Дата соединения. Отображается дата и время установления соединения в данной ветви вызова.
• Дата завершения. Отображается дата и время завершения вызова для этой ветви вызова.
• Продолжение. Отображается текущая продолжительность данной ветви вызова.
• Стоимость. Отображается текущая стоимость вызова.
• От абонента. Отображается имя абонента из базы данных Tariscope.
• В город. Отображается наименование населенного пункта, наименование оператора мобильной связи или имя конкретного абонента, куда выполняется исходящий вызов.
• Осталось времени. Если в Tariscope установлен лимит на баланс абонента, то это поле показывает, как долго еще может длится данный вызов, исходя из состояния баланса.

Пользователь Tariscope может настроить требуемый список этих полей. Для этого щелкните дважды правой кнопкой мыши на заголовке этой таблицы. Появится меню, как показано на рисунке 2.

Рисунок 2

Выбирете желаемые поля.

Данные таблицы Активные вызовы могут быть отсортированы по любому полю, например, это могут быть поля: Продолжительность, Стоимость или В город. При необходимости вы можете также сгруппировать данные по какому-либо полю.

Для быстрой оценки состояния вызова в зависимости от его состояния используются различные цвета шрифта:

• синим цветом отображается записи, отображающие процесс набора номера,
• вызовы с установленным соединением отображаются зелёным цветом,
• серым цветом выделяются недавно завершившиеся вызовы.

Для вызовов, которые должны быть автоматически разъединены менее чем через 10 секунд по причине, что состояние баланса абонента достигнет заданной величины, применяется выделение фона красным цветом. Напомним, что выполнение автоматического разъединения вызовов возможно, если лицензия на Tariscope содержит функцию ограничения и вы выполнили предварительную конфигурацию Tariscope.

Конфигурация Tariscope для использования функции ограничения

Функция ограничения позволяет администратору Taiscope задать ограничения на определенный тип телефонных вызовов для абонента, группы абонентов или маршрута (шлюза). Ограничение может задаваться как в денежных единицах, так и в секундах. Ограничение может быть установлено на месяц, неделю или день. Тип телефонного трафика, на который устанавливается ограничение, определяется категорией вызова. Более детальную информацию по функции ограничения смотрите на следующей странице.

Для настройки функции ограничения в Tariscope следует выполнить следующие действия:

• Включить функцию ограничения.
• Создать категорию вызовов, которая будет использоваться для определенного типа вызовов, к которым будет применяться ограничение.
• Назначить эту категорию вызовов соответствующим телефонным кодам.
• Создать классы ограничений.
• Задать лимиты абонентам, группам абонентов или маршрутам.
• Установить период действия функции ограничения.

Включение функции ограничения

В дереве конфигурации программы Tariscope выберите ветвь Все узлы. Программа Tariscope будет иметь вид, как показано на рисунке 3.

Рисунок 3

В списке Контролировать расходы выберите любое значение, которое соответствует вашей лицензии, отличное от  Не контролировать. На панели инструментов щелкните по кнопке Сохранить.

Создание категорий

Категории вызовов используются для выбора определенного типа вызовов, который вы хотите ограничивать. Категории связываются с определенными телефонными кодами.

Как создать новую категорию вызовов смотрите в следующей статье.

Назначение категории вызова телефонным кодам

Для назначения категории вызовов определенным телефонным кодам перейдите на страницу настройки Операторы и тарифы → конкретный оператор связи → Outgoing (для исходящих вызовов) или Incoming (для входящих вызовов) → Номера и коды или Номера и коды (таблицы). Выберите телефонные коды, которые должны принадлежать категории. Используя функцию множественной замены, установите требуемую категорию. Повторите эти действия для других телефонных кодов, которым нужно назначить другую категорию вызовов.

Создание классов ограничений

В конфигурационном дереве Tariscope выберите Все узлы → требуемый узел → Устройства связи → требуемая телефонная система → Классы ограничений. Программа Tariscope будет выглядеть подобно тому, как показано на рисунке 4.

Рисунок 4

Для этой страницы используются следующие понятия.

Класс сервиса - это идентификатор, который используется конкретным типом АТС для определения прав доступа к различным направлениям вызовов. Класс сервиса передается в сценарий ограничения, который использует его в процессе выполнения. Формат и значение класса сервиса зависит от типа устройства связи.

Категория вызова - это категория, которая присваивается каждому вызову модулем тарификации биллинговой системы в соответствии с направлением вызова. Одно из назначений категорий вызовов - это задание типа телефонного трафика, который следует учитывать для установки ограничений. Перечень категорий можно получить на странице настройки Администрирование -> Категории. Привязать телефонные коды к категориям можно на странице настройки Администрирование -> Операторы и тарифы -> конкретный оператор -> Номера и коды.

Группа ограничений - это набор правил, согласно которым выбирается класс сервиса в зависимости от лимитов, установленных абоненту, и состояния расхода по этим лимитам. Список групп ограничений общий для всех устройств узла связи, но элементы группы и соответствующие им классы сервиса привязаны к конкретной АТС (устройству связи). Необходимо создать, как минимум, два элемента группы ограничений, например, один элемент, куда будет входит класс сервиса, разрешающий телефонные разговоры, другой элемент — запрещающий такие разговоры. Группы ограничений привязываются к абонентам.

Классы ограничений позволяет настроить классы сервиса для каждой комбинации доступных/ограниченных категорий вызовов для абонентов. В простейшем случае каждая группа классов будет содержать по два элемента - "все разрешено" (с установленным флагом Все категории) и "все запрещено" (Со всеми снятыми флагами). Если нужно ограничивать разные категории вызовов индивидуально, то нужно создать элементы групп ограничений со всеми возможными комбинациями категорий и соответствующим классом сервиса. Tariscope автоматически выберет элемент, подходящий под текущее состояние ограничений абонента, и передаст его в сценарий.

Вы можете назначить произвольное имя для любой группы и ее элементам.

Задание ограничений для абонентов

Выберите в дереве настроек ваш узел связи → Абоненты. Выберите требуемого абонента, которому вы хотите установить ограничения на вызовы и щелкните по иконке Изменить на панели инструментов. На панели инструментов появившегося окна щелкните по кнопке Детали. Окно программы примет вид, как показано на рисунке 5.

Рисунок 5

Щелкните по кнопке Добавить. Появится окно Кредит по категории, как показано на рисунке 6.

Рисунок 6

В списке Категория выберите категорию вызовов, для которой будет устанавливаться лимит.

В списке Тип ограничения выберите тип ограничения: Деньги или Секунды.

В списке Класс ограничения выберите требуемый класс ограничения.

В позиции Кредит введите величину кредита (лимита) в деньгах или секундах, в зависимости от предыдущего выбора. В случае использования денег кредит задается в основной для Tariscope валюте. Ограничение по времени задается в секундах.

Щелкните OK.

Если вам необходимо установить ограничения для других категорий вызова, повторите приведенные выше шаги настройки для других категорий вызовов.

Повторите указанные выше шаги настройки для других абонентов.

Период действия функции ограничения

Период действия функции ограничения устанавливается при настройке службы Tariscope Observer. В дереве настроек выберите ветвь Сбор данных/Observer → служба, которая собирает CDR данные из 3CX Phone System → Настройка. Окно программы будет иметь вид подобный показанному на рисунке 7.

Рисунок 7

Щелкните по кнопке Сценарии и в окне Сценарии Tariscope Observer выберите пункт Изменение класса абонента (рисунок 8).

Рисунок 8

В списке Интервал автоподключения задайте желаемый интервал. Это период, когда ограничения будут действовать. Это интервал будет применяться после даты очистки ограничений.

Спикок содержит следующие пункты:

• каждый день,
• каждую неделю,
• каждый месяц,
• каждый год.

В позиции Дата автоподключения установите дату, когда будет выполнен следующий автоматический сброс установленных ограничений. Щелкните OK. Для сохранения заданных параметров в службе Observer щелкните по иконке Сохранить на панели инструментов (рисунок 7).

Детальное описание некоторых функций Tariscope

Автоматическое добавление абонентских данных из базы данных 3CX Phone System

Эта функция позволяет автоматически создавать абонентов в базе данных Tariscope. В начале каждого вызова Tariscope проверяет наличие телефонного номера, который участвует в вызове, в базе данных Tariscope. Если этот номер отсутствует, Tariscope загружает параметры абоонента из базы данных 3CX Phone System.

Эта функция существенно упрощает администрирование, позволяя автоматически добавлять данные абонентов в Tariscope.

Эта функция не может одновременно использоваться с функцией Сбрасывать вызовы от неизвестного абонента.

Для включения этой функции, в настройке окна Настройка обработки для 3CX (рисунок 3.12.1.1) выберите Мониторинг активных вызовов и Автоматически создавать абонентов из базы 3CX Phone System.

Синхронизация параметров абонентов

Эта функция обеспечивает автоматическую синхронизацию абонентских данных базы данных Tariscope с базой данных 3CX Phone System. Tariscope синхронизирует следущие данные: имя абонента, телефонный номер, электронный адрес. В начале каждого вызова Tariscope проверяет параметры абонента, участвующего в вызове, с данными 3CX Phone System. Если они отличаются, то Tariscope синхронизирует свою базу данных с данными 3CX Phone System. Эта функция позволяет администратору изменять данные абонента только в АТС 3CX Phone System. В Tariscope они будут обновляться автоматически.

Вы может использовать эту функцию совместно с функцией Автоматически создавать абонентов из базы 3CX Phone System.

Для включения этой функции, в настройке окна Настройка обработки для 3CX (рисунок 3.12.1.1) выберите Мониторинг активных вызовов и Синхронизировать имя абонента, номер и адрес Email из базы 3CX Phone System.

Разъединение вызовов на основе состояния счета абонента

Эта функция может быть использована только в редакции Tariscope Provider. Она работает следующим образом. В начале вызова Tariscope рассчитывает возможную максимальную продолжительность вызова, при которой состояние счета абонента достигнет заданной величины, например, 0. Как только этот момент наступает Tariscope прекращает вызов.Все новые попытки выполнять вызовы будут сбрасываться Но абонент сможет выполнять бесплатные вызовы, например, внутренние. После того, как абонент пополнит свой счет и эта ифнормация поступитт в Tariscope, Tariscope позволит абоненту снова выполнять платные вызовы.

Для внедрения этой функции:

• в настройках окна Настройка обработки для 3CX (рисунок 3.12.1.1) выберите Мониторинг активных вызовов,
• в файле main.xml, установите значение 'true' в тегах: <LimitSubscribersByBalance>true</LimitSubscribersByBalance>
• укажите величину баланса счета абонента, когда эта функция должна применяться, в тегах: <BalanceThreshold>0</BalanceThreshold>

Сброс вызовов с неизвестных внутренних номеров

Эта функция позволяет вам бороться с возможным фродом. Вы может запретить выполнение всех вызовов, выполненных с телефонных номеров, которые отсутствуют в базе данных Tariscope.

Чтобы установить эту функцию, в настройках окна Настройка обработки для 3CX (рисунок 3.12.1.1) выберите Мониторинг активных вызовов и Сбрасывать вызовы с неизвестных внутренних номеров.

Эта функция не может одновременно использоваься с функцией Автоматически создавать абонентов из базы 3CX Phone System.

Разъединение продолжительных вызовов

Вы можете задать порог длительности разговора. Если продолжительность какого-либо вызова достигнет этого порога, вызов будет сброшен. Для внедрения этой функции:

• в настройках окна Настройка обработки для 3CX (рисунок 3.12.1.1) выберите Мониторинг активных вызовов,
• установите величину порога длительности вызова в секундах в тегах: <DropCallDurationThreshold>0</DropCallDurationThreshold>

Значение 0 означает, что вызовы не ограничиваются по продолжительности.

Разъединение дорогих вызовов

Вы можете задать порог стоимости разговора. Если стоимость какого-либо вызова достигнет этого порога, вызов будет сброшен. Для внедрения этой функции:

• в настройках окна Настройка обработки для 3CX (рисунок 3.12.1.1) выберите Мониторинг активных вызовов,
• укажите величину порога стоимости разговора в тегах: <DropCallCostThreshold>0</DropCallCostThreshold>

Значение 0 означает, что вызовы не ограничиваются по стоимости разговора.

Разъединение вызовов по шаблону

Tariscope позволяет сбрасывать вызовы, сделанные на определенные телефонные номера.

Для внедрения этой функции:

• в настройках окна Настройка обработки для 3CX (рисунок 3.12.1.1) выберите Мониторинг активных вызовов,
• задайте шаблон телефонного номера в тегах: <DropCallRulesNumberPattern>*</DropCallRulesNumberPattern>.

Значение '*' означает, что данное правило не применяется, т.е. возможно выполнять вызовы на любые телефонные номера.