IVA ДОКУМЕНТАЦИЯ
ОБНОВЛЕНИЯ

Отправка событий СОРМ

IVA CS может передавать в комплекс СОРМ уведомления о событиях вызовов, использовании дополнительных видов обслуживания (ДВО), а также блокировке и разблокировке терминалов.

Компоненты Call, DTMF и Backend формируют события и передают их компоненту Audit. Компонент Audit кодирует сообщения по правилам ASN.1 BER и отправляет их на заданные IP-адрес и UDP-порт приемника СОРМ.

Канал событий СОРМ и передача медиатрафика — разные механизмы.

Событие voiceConnected содержит адреса, порты и сведения о кодеке, но не содержит RTP-пакеты разговора. Для передачи RTP-трафика в комплекс СОРМ необходимо отдельно использовать сетевой ответвитель или SPAN-порт сетевого оборудования. Встроенное зеркалирование RTP-трафика средствами IVA CS в данной функции не выполняется

Передаваемые события

Событие Описание

fullNrRecv

Получен полный набранный номер. Событие формируется при начале обработки вызова и содержит, в частности, идентификатор вызова, номер вызывающего абонента и набранный номер

alerting

Начато оповещение вызываемого абонента, например его терминал перешел в состояние вызова

answer

Вызываемый абонент ответил на вызов

disconnect

Соединение завершено. Причина завершения передается в поле discCause в виде протокола и кода причины

release

Освобождены ресурсы участника вызова. Причина освобождения передается в поле discCause в виде протокола и кода причины

voiceConnected

Сформированы параметры медиасоединения. В варианте SPAN передаются локальные адреса и порты IVA CS, в варианте RTP — удаленные адреса и порты участников, а также сведения о кодеке

dtmf

Во время вызова получен DTMF-сигнал

ssvUse

Использовано ДВО

ssvOn

ДВО включено

ssvOff

ДВО выключено

ssvCheck

Запрошено состояние ДВО

block

Терминал заблокирован

unBlock

Терминал разблокирован

События одного вызова связаны общим значением CallUID. Состав и количество событий зависят от сценария вызова. Например, для каждого плеча вызова могут формироваться отдельные сообщения voiceConnected и release.

Типы ДВО

В сообщениях о ДВО его тип передается числовым кодом:

Код Значение ДВО

0

DND

Не беспокоить

1

RedirectAlways

Безусловная переадресация

2

RedirectSchedule

Переадресация по расписанию

3

RedirectOnBusy

Переадресация при занятости

4

RedirectNoPickup

Переадресация при отсутствии ответа

5

DirectedPickup

Направленный перехват вызова

6

CallGroupPickup

Перехват вызова в группе

Настройка отправки событий

Перед настройкой необходимо получить IP-адрес и UDP-порт приемника СОРМ, а также проверить сетевую доступность приемника с каждого хоста IVA CS.

Для настройки отправки событий необходимо:

  1. создать резервную копию конфигурационного файла /etc/ivasw/logic.yaml:

    sudo cp /etc/ivasw/logic.yaml /etc/ivasw/logic.yaml.bak

  2. открыть файл /etc/ivasw/logic.yaml и добавить или изменить следующие параметры:

    SWL:
  AUDIT:
    SORM_ADDR: "192.168.171.184:9999"
  BACKEND:
    SEND_SORM_EVENTS: true
  CALL:
    SEND_SORM_EVENTS: true

    где 192.168.171.184 — IP-адрес приемника СОРМ, а 9999 — его UDP-порт.

    Если разделы SWL, AUDIT, BACKEND или CALL уже присутствуют в файле, необходимо изменить существующие разделы, не создавая ключи повторно и не удаляя остальные параметры.

    В конфигурациях, в которых используются плоские имена параметров, этим настройкам соответствуют следующие ключи:

    Параметр в YAML Плоское имя параметра

    SWL.AUDIT.SORM_ADDR

    SWL_AUDIT_SORM_ADDR

    SWL.BACKEND.SEND_SORM_EVENTS

    SWL_BACKEND_SEND_SORM_EVENTS

    SWL.CALL.SEND_SORM_EVENTS

    SWL_CALL_SEND_SORM_EVENTS

  3. перезапустить IVA CS для применения настроек:

    sudo ivacs-ctl restart

Настройку и перезапуск необходимо выполнить на каждом хосте кластера IVA CS.

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