Настройки

Возможности раздела Настройки:

Удалённые хранилища

Во вкладке Удалённые хранилища отображаются все внешние хранилища, используемые в системе и предназначенные для выгрузки, хранения аудиофайлов и CDR.

Для перехода во вкладку: раздел Настройки → вкладка Удалённые хранилища

Удаленные хранилища

Добавить внешнее хранилище

Чтобы добавить новое внешнее хранилище, необходимо:

  1. раздел Настройки → вкладка Удалённые хранилища

  2. нажать кнопку Кнопка Добавить → окно Добавить удалённое хранилище

    Добавить удалённое хранилище
  3. указать параметры добавляемого хранилища:

    • поле Имя: ввести наименование хранилища, используемое в системе

    • поле Путь: указать адрес / место расположения хранилища

    • поле Тип: выбрать тип хранилища (dir или ftp)

      Если удалённое хранилище находится на FTP-сервере (выбран тип хранилища ftp), то для аутентификации на данном сервере, необходимо заполнить данные в следующих полях:

      • Хост

      • Порт

      • Имя пользователя

      • Пароль

      Удалённое FTP-хранилище
      Если данные необходимо передавать в зашифрованном виде, то необходимо перевести переключатель TLS в положение Кнопка ON
      Если активирован переключатель Проверить сертификат, то проверка сертификата в режиме TLS не производится
  4. нажать кнопку Сохранить

Удалить внешнее хранилище

Для удаления внешнего хранилища, необходимо:

  1. раздел Настройки → вкладка Удалённые хранилища

  2. выбрать хранилище Кнопка Выбрать → нажать кнопку Кнопка Удалить → подтвердить удаление нажав кнопку Кнопка Да

Аудиофайлы

Во вкладке Аудиофайлы находятся аудиофайлы, загруженные администратором в систему и доступные для дальнейшего использования в сервисах телефонии, таких как IVR, Голосовая почта, Очередь вызовов и других.

Для перехода во вкладку: раздел Настройки → вкладка Аудиофайлы

Аудиофайлы

Добавление аудиофайла

Для загрузки доступны аудиофайлы любого формата

Для загрузки аудиофайлов, необходимо:

  1. раздел Настройки → вкладка Аудиофайлы

  2. нажать кнопку Кнопка Добавить → окно Добавить аудиофайл

    Добавить аудиофайл
  3. настроить параметры добавляемого аудиофайла:

    • поле Имя: ввести наименование аудиофайла отображаемое в web-интерфейсе

    • переключатель Общий доступ: установить уровень доступа

      Если переключатель Общий доступ активирован, то аудиофайл будет доступен всем пользователям системы, в противном случае — только пользователю, загрузившему данный аудиофайл
    • поле Выберите аудиофайл: выбрать и добавить аудиофайл

  4. нажать кнопку Сохранить

Удаление аудиофайла

Для удаления аудиофайла:

  1. раздел Настройки → вкладка Аудиофайлы

  2. выбрать аудиофайл Кнопка Выбрать → нажать кнопку Кнопка Удалить → подтвердить удаление нажав кнопку Кнопка Да

Сертификаты

Во вкладке Сертификаты находятся TLS-сертификаты и приватные ключи, используемые для шифрования сигнального трафика.

Для шифрования сигнального трафика необходимо сгенерировать TLS-сертификат. Такой сертификат позволяет шифровать данные, передаваемые по SIP-протоколу.

Для SIP TLS используется порт 5061

Для перехода во вкладку: раздел Настройки → вкладка Сертификаты

certificate

Добавление сертификата / ключа

Чтобы добавить сертификат / ключ, необходимо:

  1. раздел Настройки → вкладка Сертификаты

  2. нажать кнопку Кнопка Добавить → окно Добавить сертификат

    add_certificate
  3. настроить параметры сертификата:

    • поле Название: ввести наименование добавляемого сертификата / ключа

    • поле Выбрать файл: выбрать добавляемый сертификат / ключ

  4. нажать кнопку Сохранить

При создании TLS-сертификата создаются самоподписанный сертификат безопасности и приватный ключ, которые необходимо в дальнейшем загрузить в соответствующие параметры системных настроек:

  • поле its.tls_certificate: загрузить используемый TLS-сертификат

  • поле its.tls_private_key: загрузить используемый приватный ключ

  • поле its.tls_domain: указать наименование домена, например, root, в котором необходимо функционирование TLS-сертификата

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

  1. подключиться по ssh

  2. выполнить перезапуск все сервисов с помощью команды:

    sudo ivacs-ctl restart
    Запуск скрипта необходимо выполнять поочерёдно на каждом сервере

    или

    sudo ivacs-ctl restart all
    Запуск скрипта необходимо выполнять только на одном сервере

Шаблоны электронной почты

Во вкладке Шаблоны электронной почты можно создать шаблоны писем, которые затем будут отправляться пользователям на электронную почту при пропущенных звонках.

Для перехода во вкладку: раздел Настройки → вкладка Шаблоны электронной почты

Шаблоны электронной почты

Создание шаблона

  1. раздел Настройки → вкладка Шаблоны электронной почты

  2. нажать кнопку Кнопка Добавить → окно Добавить шаблон

    Добавить шаблон
  3. указать параметры шаблона:

    • поле Код: ввести код типа шаблона (уникальный идентификатор сервиса)

      В зависимости от значения, указанного в поле Код, шаблон используется для разных сервисов
    • поле Тема: ввести тему письма, отображаемую в заголовке письма

    • поле Текст: ввести шаблон электронного письма в текстовом формате

    • поле Текст HTML: ввести шаблон электронного письма в html-формате

  4. нажать кнопку Сохранить

Поддерживаемые типы шаблонов:

Код шаблона Событие, вызывающее отправку сообщения Шаблон по умолчанию (в текстовом формате) Параметры шаблона

voicemail

Добавление записи в голосовую почту абонента

Voicemail waiting for you from {{ .FromName }}.
This letter was sent by a mail robot.
This is the manufacturer’s pattern.
Follow the link to listen http://{{ .WebServer }}/subscribers/{{ .SubscriberID }}/voicemail

SubscriberID, FileRecordID, DomainID

cdr_report_success

Успешное завершение формирования CDR-отчета

Successfully generated CDR report for {{ .ReportName }}.
File name: {{ .FileName }}.
Domain name: {{ .DomainName }}.
Time: {{ .Time }}.

Time, ReportName, DomainName, FileName

cdr_report_failed

Ошибочное завершение формирования CDR-отчета

Failed to generate CDR report for {{ .ReportName }}.
Error: {{ .Error }}.
Status code: {{ .Status }}.
Domain name: {{ .DomainName }}.
Time: {{ .Time }}.

Time, ReportName, DomainName, Status, Error

Параметры шаблонов:

Код параметра Код используемого шаблона Описание

FromName

Везде

Имя отправителя (в случае, если имя отправителя не определено)

ToName

Везде

Полное имя получателя составленное из полей аккаунта (firstname, middlename, lastname)

WebServer

Везде

Имя или адрес хоста web-сервера IVA CS.
Может использоваться для составления ссылки на ресурс.
Код параметра устанавливается из системной настройки ics_web_server

Time

cdr_report_success cdr_report_failed

Время завершения формирования отчета CDR

ReportName

cdr_report_success cdr_report_failed

Имя отчета CDR

DomainName

cdr_report_success cdr_report_failed

Имя домена в котором формировался отчет CDR

FileName

cdr_report_success

Имя файла отчета CDR

Error

cdr_report_failed

Сообщение об ошибке

Status

cdr_report_failed

Код ошибки (число)

SubscriberID

voicemail

Идентификатор абонента для которого оставлено голосовое сообщение

DomainID

voicemail

Идентификатор домена (абонента для которого оставлено голосовое сообщение)

Удаление шаблона

Для удаления шаблона электронной почты:

  1. раздел Настройки → вкладка Шаблоны электронной почты

  2. выбрать шаблон Кнопка Выбрать → нажать кнопку Кнопка Удалить → подтвердить удаление нажав кнопку Кнопка Да

Сопоставление кодов Q.931

Во вкладке Сопоставление кодов Q.931 можно ознакомиться с преобразованиями кодов завершения вызова по стандартам Q.931 и SIP.

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

Для перехода во вкладку: раздел Настройки → вкладка Сопоставление кодов Q.931

Сопоставление кодов Q.931

Чтобы добавить сопоставление кода Q.931 в таблицу, необходимо:

  1. раздел Настройки → вкладка Сопоставление кодов Q.931

  2. нажать кнопку Кнопка Добавить → окно Добавить сопоставление кода Q.931

    Добавить код
  3. указать параметры сопоставляемого кода:

    • поле Код Q.931: ввести код Q.931

    • поле Код SIP: ввести код SIP

    • поле Причина разъединения: указать причину разъединения

  4. нажать кнопку Сохранить

Для просмотра / редактирования добавленного кода, необходимо:

  1. раздел Настройки → вкладка Сопоставление кодов Q.931

  2. нажать на название кода → окно Настройки сопоставления кода Q.931

    Настройки сопоставления кода Q.931

Системные настройки

Во вкладке Системные настройки находятся параметры различных системных настроек.

Для перехода во вкладку: раздел Настройки → вкладка Системные настройки

Системные настройки

Таблица системных настроек

Ключ Сервис Тип Значение По умолчанию Описание

dial_timeout

swl_report

Длительность

5s

Да

Таймаут подключения к внешнему хранилищу

ics_web_server

swl_notify

Текст

127.0.0.1

Да

Адрес хоста web-сервера IVA CS. Используется в параметрах шаблонов сервиса нотификации для формирования web-ссылок (например, ссылка на голосовую почту)

sendmail.max_count_sessions

swl_notify

Int 64

1

Да

Максимальное количество одновременных соединений с почтовым сервером

sendmail.session_ttl

swl_notify

Длительность

600s

Да

Максимальное время жизни одного соединения с сервером

sendmail.max_mail_per_connection

swl_notify

Int 64

10

Да

Максимальное количество отправленных писем в одном соединении с почтовым сервером

sendmail.proto

swl_notify

Текст

smtp

Да

Почтовый протокол. На текущий момент сервис swl_notify поддерживает только протокол SMTP

sendmail.ext_app_id

swl_notify

Текст

Да

Имя (идентификатор) внешнего приложения

sendmail.from_name

swl_notify

Текст

Да

Имя отправителя письма, если имя пустое, то используется имя из параметра sendmail.ext_app_id

sendmail.email

swl_notify

Текст

Да

Почтовый ящик отправителя, обязательно заполняется если параметр Login (из параметра sendmail.login) не совпадает с адресом электронной почты

sendmail.insecure_skip_verify

swl_notify

Bool

false

Да

Игнорирование недоверенных сертификатов при использовании TLS

sendmail.ssl

swl_notify

Bool

false

Да

Если Port равен 465, то SSL автоматически устанавливается в состояние true

sendmail.connect_timeout

swl_notify

Длительность

3s

Да

Время, отведённое на установление соединения и авторизацию

sendmail.tls_policy

swl_notify

Int 64

1

Да

Политика использования TLS:

  • По требованию сервера: 0

  • Режим TLS не используется: -1

  • Режим TLS используется (обязателен по умолчанию): 1

sendmail.password

swl_notify

Текст

Да

Пароль пользователя или пароль для внешнего приложения (из параметра sendmail.ext_app_id)

sendmail.login

swl_notify

Текст

Да

Логин на почтовом сервере

sendmail.port

swl_notify

Int 64

0

Да

Номер порта почтового сервера

sendmail.host

swl_notify

Текст

Да

IP-адрес или FQDN почтового сервиса

syslog_connection_string

swl_audit

Текст

Да

Адрес сервера syslog для отправки на него событий аудита.
Формат адреса: {network}://{address}. Например, tcp://10.0.202.55. Для подключения к локальному syslog нужно оставить network пустым, то есть ://

update.accounts_step

swl_ldap

Длительность

20s

Да

Частота синхронизации пользователей

update.accounts_delay

swl_ldap

Длительность

0s

Да

Длительность задержки перед первой синхронизацией пользователей после запуска сервиса

update.auth_sources_step

swl_ldap

Длительность

900s

Да

Частота обновления источников авторизации

update.auth_sources_delay

swl_ldap

Длительность

900s

Да

Длительность задержки перед первым обновлением источника авторизации после запуска сервиса

ldap_default_timeout

swl_ldap

Длительность

5s

Да

Длительность таймаута на запрос данных из одного источника авторизации для синхронизации пользователей

delete.old_dtmf_signals_age

swl_dtmf

Длительность

30s

Да

Длительность хранения DTMF сигнала

delete.old_dtmf_signals_step

swl_dtmf

Длительность

10s

Да

Частота очистки старых DTMF сигналов

delete.old_dtmf_signals_delay

swl_dtmf

Длительность

0s

Да

Длительность задержки перед первой очисткой старых DTMF сигналов после запуска сервиса

first_in_queue_retry_interval

swl_dtmf

Длительность

1s

Да

Частота попыток набора группы вызова абонентом, стоящем на первом месте в очереди вызова

load.dtmf_routine_step

swl_dtmf

Длительность

60s

Да

Частота обновления кэша DTMF правил в сервисе

load.dtmf_routine_delay

swl_dtmf

Длительность

0s

Да

Длительность задержки перед первым обновление кэша DTMF правил в сервисе после его запуска

load.audio_step

swl_dtmf

Длительность

86400s

Да

Частота обновления кэша аудиозаписей

load.audio_delay

swl_dtmf

Длительность

0s

Да

Длительность задержки перед первым обновлением кэша аудиозаписей после запуска сервиса

load.actions_step

swl_dtmf

Длительность

86400s

Да

Частота обновления кэша действий

load.actions_delay

swl_dtmf

Длительность

0s

Да

Длительность задержки перед первым обновлением кэша действий после запуска сервиса

notification_max_try_count

swl_dtmf

Int 64

3

Да

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

notification_capture_timeout

swl_dtmf

Длительность

40s

Да

Время, которое даётся сервису на выполнение исходящего вызова с уведомлением по расписанию

time_location

swl_call

6

{}

Да

не используется в настоящее время

audio.call_recording

swl_call

Текст

TODO

Да

не используется в настоящее время

enable_dial_from_any_host

swl_call

Bool

false

Нет

Возможность выполнить звонок для абонента с экземпляра ITS в котором этот абонент зарегистрирован, даже если у вызывающего абонента другой экземпляр ITS (в одной подсети)

enable_subscriber_loop_back

swl_call

Bool

false

Да

Возможность дозвониться абоненту на себя

disable_loop_by_ip_port

swl_call

Bool

true

Да

Определение уникальности абонента по IP-адресу

max_depth_redirects

swl_call

Int 64

10

Да

Максимальное число переадресаций при определении маршрута для звонка

disabled_video_codecs

swl_call

Текст

Да

Список отключённых видеокодеков. Разделитель ,

disabled_audio_codecs

swl_call

Текст

Да

Список отключённых аудиокодеков. Разделитель ,

audio.music_on_hold

swl_call

UUID

00000000-0000-0000-0000-000000000000

Нет

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

validate_b_leg_number_from_gateway

swl_call

Bool

false

Нет

Включение / отключение валидации Б-номеров для звонков пришедших со шлюза

video_enabled

swl_call

Bool

true

Да

Включить функцию звонка с видео

leg_a_search_gw_before_user

swl_call

Bool

true

Да

Приоритет при аутентификации для вызывающего шлюза, а не для абонента

load.black_list_step

swl_call

Длительность

5s

Да

Частота обновления кэша чёрных списков пользователей

load.black_list_delay

swl_call

Длительность

0s

Да

Длительность задержки перед первым обновлением кэша чёрных список пользователей после запуска сервиса

load.routes_step

swl_call

Длительность

900s

Да

Частота обновления кэша маршрутов для маршрутизации вызовов

load.routes_delay

swl_call

Длительность

10s

Да

Длительность задержки перед первым обновлением кэша маршрутов для маршрутизации вызовов после запуска сервиса

load.domains_step

swl_call

Длительность

900s

Да

Частота обновления кэша доменов

load.domains_delay

swl_call

Длительность

5s

Да

Длительность задержки перед первым обновлением кэша доменов после запуска сервиса

load.codecs_step

swl_call

Длительность

600s

Да

Частота обновления кэша кодеков

load.codecs_delay

swl_call

Длительность

0s

Да

Длительность задержки перед первым обновлением кэша кодеков после запуска сервиса

load.features_step

swl_call

Длительность

300s

Да

Частота обновления кэша кодов абонентских функций

load.features_delay

swl_call

Длительность

0s

Да

Длительность задержки перед первым обновлением кэша кодов абонентских функций

candidates.call_group_storage_ttl

swl_call

Длительность

300s

Да

не используется в настоящее время

candidates.no_pickup_storage_ttl

swl_call

Длительность

300s

Да

не используется в настоящее время

client_redirect_enabled

swl_call

Bool

false

Да

Включить обработку редиректов, инициированных терминалами (ответ 302)

limits.subscriber.domain

swl_backend

Int 64

-1

Да

Максимальное количество абонентов для одного домена (при -1 ограничений нет)

max_notification_numbers

swl_backend

Int 64

100

Да

Ограничение по количеству номеров для сервиса оповещений

subscription.finalize_checker_step

swl_backend

Длительность

0s

Да

Тик проверки ожидания прихода последних обновлений по подписке от пользовательского интерфейса на обновление сущностей при её удалении (например, при локальном выходе)

subscription.finalize_checker_timeout

swl_backend

Длительность

1s

Да

Длительность ожидания прихода последних обновлений по подписке от пользовательского интерфейса на обновление сущностей при её удалении (например, при локальном выходе)

subscription.check_delay

swl_backend

Длительность

2s

Да

Периодичность проверки обновлений по подписке элементов пользовательского интерфейса на обновление сущностей

socket.request_id_timeout

swl_backend

Длительность

600s

Да

Таймаут обработки запроса из сервиса Socket

auth.default_ttl

swl_backend

Длительность

600s

Да

не используется в настоящее время

nats_run_timeout

swl_registry_cli

Длительность

5s

Да

Таймаут подключения к NATS во время использования Registry CLI

monitor.process_shutdown_duration

swl_registry

Длительность

60s

Да

Допустимая длительность завершения процесса

monitor.reg_db_timeout

swl_registry

Длительность

5s

Да

Таймаут подключения к внутренней базе данных сервиса

monitor.check_period

swl_registry

Длительность

10s

Да

не используется в настоящее время

its.timeout_configuration_zrpc

swl_registry

Длительность

5s

Да

не используется в настоящее время

its.timeout_configuration

swl_registry

Длительность

5s

Да

не используется в настоящее время

its.check_latency

swl_registry

Длительность

7s

Да

Длительность задержки перед повторной проверкой состояния ITS после того, как в результате предыдущей проверки была получена ошибка

its.cache_cleanup_interval

swl_registry

Длительность

420s

Да

Частота очистки экземпляров ITS, определенных балансировщиком нагрузки для конкретного звонка

its.cache_expiration

swl_registry

Длительность

300s

Да

Длительность хранения экземпляра ITS, определенного балансировщиком нагрузки для конкретного звонка

its.get_codecs_list_interval

swl_registry

Длительность

3600s

Да

Частота обновления списка кодеков, обрабатываемых ITS

its.get_services_info_interval

swl_registry

Длительность

900s

Да

Частота проверки состояния ITS

its.instances

swl_registry

Текст

[]

Да

не используется в настоящее время

sendmail.max_attach_size

swl_notify

Int 64

10485760

Да

Максимальный размер вложения (в байтах), для отправки в электронном письме

audio.call_beep

swl_call

UUID

00000000-0000-0000-0000-000000000000

Да

Аудиофайл, устанавливаемый вместо гудков при дозвоне

audio.dnd_message

swl_call

UUID

00000000-0000-0000-0000-000000000000

Да

Аудиофайл, устанавливаемый на режим DND

audit_actions_with_objects

swl_backend

Bool

true

Да

Проводить аудит действий с объектами (создание, изменение, удаление и добавление)

inform_about_call_record

swl_call

Bool

true

Да

Предупреждать о записи разговора

ringing_timeout

swl_call

Длительность

30s

Да

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

its.allow_diversion

swl_registry

Bool

true

Да

Включить обработку SIP-заголовка Diversion. Для применения изменений необходимо перезапустить сервисы ITS

its.tls_domain

swl_registry

Текст

Да

Значение параметра, необходимое для нормального функционирования SIP Signaling over TLS (по умолчанию необходимо указать наименование домена)

its.tls_private_key

swl_registry

UUID

Значение из загружаемого файла

Нет

Приватный ключ

its.tls_certificate

swl_registry

UUID

Значение из загружаемого файла

Нет

Самоподписанный сертификат безопасности

gc.remove_deleted_files_enabled

swl_gc

Bool

true

Да

Настройка включения очистки хранилища от файлов помеченных в базе данных на удаление

gc.remove_deleted_files_init_delay

swl_gc

Длительность

0s

Да

Задержка включения очистки хранилища от удалённых файлов после запуска swl_gc

gc.remove_deleted_files_step

swl_gc

Длительность

10s

Да

Периодичность запуска очистки хранилища от удалённых файлов

gc.remove_deleted_files_delay

swl_gc

Длительность

168h

Да

Задержка между пометкой файла на удаление и добавлением его в очередь на очистку

gc.remove_deleted_files_max_per_step

swl_gc

Int 64

10

Да

Максимальное количество файлов, которое может быть удалено за один шаг очистки

gc.remove_deleted_files_mode

swl_gc

Int 64

1

Да

Режим удаления файлов (для типа хранилища local)

Значение

Политика использования

1

перемещение в папку files-dir + "_deleted" (например для /var/lib/ivasw/files — /var/lib/ivasw/files_deleted)

2

безвозвратно