Настройки
Возможности раздела Настройки:
-
настройка внешних удалённых хранилищ
-
добавление пользовательских аудиофайлов
-
работа с сертификатами
-
настройка шаблонов электронной почты
-
работа с системными настройками
Удалённые хранилища
Во вкладке Удалённые хранилища отображаются все внешние хранилища, используемые в системе и предназначенные для выгрузки, хранения аудиофайлов и CDR.
Для перехода во вкладку: раздел Настройки → вкладка Удалённые хранилища
Добавить внешнее хранилище
Чтобы добавить новое внешнее хранилище, необходимо:
-
раздел Настройки → вкладка Удалённые хранилища
-
нажать кнопку
→ окно Добавить удалённое хранилище
-
указать параметры добавляемого хранилища:
-
поле Имя: ввести наименование хранилища, используемое в системе
-
поле Путь: указать адрес / место расположения хранилища
-
поле Тип: выбрать тип хранилища (dir или ftp)
Если удалённое хранилище находится на FTP-сервере (выбран тип хранилища ftp), то для аутентификации на данном сервере, необходимо заполнить данные в следующих полях:
-
Хост
-
Порт
-
Имя пользователя
-
Пароль
Если данные необходимо передавать в зашифрованном виде, то необходимо перевести переключатель TLS в положение
Если активирован переключатель Проверить сертификат, то проверка сертификата в режиме TLS не производится -
-
-
нажать кнопку

Аудиофайлы
Во вкладке Аудиофайлы находятся аудиофайлы, загруженные администратором в систему и доступные для дальнейшего использования в сервисах телефонии, таких как IVR, Голосовая почта, Очередь вызовов и других.
Для перехода во вкладку: раздел Настройки → вкладка Аудиофайлы
Добавление аудиофайла
| Для загрузки доступны аудиофайлы любого формата |
Для загрузки аудиофайлов, необходимо:
-
раздел Настройки → вкладка Аудиофайлы
-
нажать кнопку
→ окно Добавить аудиофайл
-
настроить параметры добавляемого аудиофайла:
-
поле Имя: ввести наименование аудиофайла отображаемое в web-интерфейсе
-
переключатель Общий доступ: установить уровень доступа
Если переключатель Общий доступ активирован, то аудиофайл будет доступен всем пользователям системы, в противном случае — только пользователю, загрузившему данный аудиофайл -
поле Выберите аудиофайл: выбрать и добавить аудиофайл
-
-
нажать кнопку

Сертификаты
Во вкладке Сертификаты находятся TLS-сертификаты и приватные ключи, используемые для шифрования сигнального трафика.
Для шифрования сигнального трафика необходимо сгенерировать TLS-сертификат. Такой сертификат позволяет шифровать данные, передаваемые по SIP-протоколу.
| Для SIP TLS используется порт 5061 |
Для перехода во вкладку: раздел Настройки → вкладка Сертификаты
Добавление сертификата / ключа
Чтобы добавить сертификат / ключ, необходимо:
-
раздел Настройки → вкладка Сертификаты
-
нажать кнопку
→ окно Добавить сертификат
-
настроить параметры сертификата:
-
поле Название: ввести наименование добавляемого сертификата / ключа
-
поле Выбрать файл: выбрать добавляемый сертификат / ключ
-
-
нажать кнопку

При создании TLS-сертификата создаются самоподписанный сертификат безопасности и приватный ключ, которые необходимо в дальнейшем загрузить в соответствующие параметры системных настроек:
-
поле its.tls_certificate: загрузить используемый TLS-сертификат
-
поле its.tls_private_key: загрузить используемый приватный ключ
-
поле its.tls_domain: указать наименование домена, например, root, в котором необходимо функционирование TLS-сертификата
После загрузки TLS-сертификата и приватного ключа необходимо перезагрузить системные сервисы, выполнив следующие действия:
-
подключиться по ssh
-
выполнить перезапуск все сервисов с помощью команды:
sudo ivacs-ctl restartЗапуск скрипта необходимо выполнять поочерёдно на каждом сервере или
sudo ivacs-ctl restart allЗапуск скрипта необходимо выполнять только на одном сервере
Шаблоны электронной почты
Во вкладке Шаблоны электронной почты можно создать шаблоны писем, которые затем будут отправляться пользователям на электронную почту при пропущенных звонках.
Для перехода во вкладку: раздел Настройки → вкладка Шаблоны электронной почты
Создание шаблона
-
раздел Настройки → вкладка Шаблоны электронной почты
-
нажать кнопку
→ окно Добавить шаблон
-
указать параметры шаблона:
-
поле Код: ввести код типа шаблона (уникальный идентификатор сервиса)
В зависимости от значения, указанного в поле Код, шаблон используется для разных сервисов -
поле Тема: ввести тему письма, отображаемую в заголовке письма
-
поле Текст: ввести шаблон электронного письма в текстовом формате
-
поле Текст HTML: ввести шаблон электронного письма в html-формате
-
-
нажать кнопку

Поддерживаемые типы шаблонов:
Параметры шаблонов:
| Код параметра | Код используемого шаблона | Описание |
|---|---|---|
FromName |
Везде |
Имя отправителя (в случае, если имя отправителя не определено) |
ToName |
Везде |
Полное имя получателя составленное из полей аккаунта (firstname, middlename, lastname) |
WebServer |
Везде |
Имя или адрес хоста web-сервера IVA CS. |
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 |
Идентификатор домена (абонента для которого оставлено голосовое сообщение) |
Сопоставление кодов Q.931
Во вкладке Сопоставление кодов Q.931 можно ознакомиться с преобразованиями кодов завершения вызова по стандартам Q.931 и SIP.
Таблица сопоставления кодов формируется для каждого домена и допускает возможность гибкой настройки кодов разъединения, а также сброс к значениям по умолчанию.
Для перехода во вкладку: раздел Настройки → вкладка Сопоставление кодов Q.931
Чтобы добавить сопоставление кода Q.931 в таблицу, необходимо:
-
раздел Настройки → вкладка Сопоставление кодов Q.931
-
нажать кнопку
→ окно Добавить сопоставление кода Q.931 -
указать параметры сопоставляемого кода:
-
поле Код Q.931: ввести код Q.931
-
поле Код SIP: ввести код SIP
-
поле Причина разъединения: указать причину разъединения
-
-
нажать кнопку

Для просмотра / редактирования добавленного кода, необходимо:
Системные настройки
Во вкладке Системные настройки находятся параметры различных системных настроек.
Для перехода во вкладку: раздел Настройки → вкладка Системные настройки
Таблица системных настроек
| Ключ | Сервис | Тип | Значение | По умолчанию | Описание | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
dial_timeout |
swl_report |
Длительность |
5s |
Да |
Таймаут подключения к внешнему хранилищу |
||||||
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 |
||||||
swl_notify |
Текст |
Да |
Имя (идентификатор) внешнего приложения |
||||||||
sendmail.from_name |
swl_notify |
Текст |
Да |
Имя отправителя письма, если имя пустое, то используется имя из параметра sendmail.ext_app_id |
|||||||
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:
|
||||||
sendmail.password |
swl_notify |
Текст |
Да |
Пароль пользователя или пароль для внешнего приложения (из параметра sendmail.ext_app_id) |
|||||||
swl_notify |
Текст |
Да |
Логин на почтовом сервере |
||||||||
sendmail.port |
swl_notify |
Int 64 |
0 |
Да |
Номер порта почтового сервера |
||||||
swl_notify |
Текст |
Да |
IP-адрес или FQDN почтового сервиса |
||||||||
swl_audit |
Текст |
Да |
Адрес сервера syslog для отправки на него событий аудита. |
||||||||
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 |
Да |
Длительность задержки перед первым обновлением кэша действий после запуска сервиса |
||||||
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 |
Текст |
Да |
Список отключённых аудиокодеков. Разделитель , |
|||||||
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 |
Да |
Аудиофайл, устанавливаемый вместо гудков при дозвоне |
||||||
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 |
||||||
swl_registry |
Текст |
Да |
Значение параметра, необходимое для нормального функционирования SIP Signaling over TLS (по умолчанию необходимо указать наименование домена) |
||||||||
swl_registry |
UUID |
Значение из загружаемого файла |
Нет |
Приватный ключ |
|||||||
swl_registry |
UUID |
Значение из загружаемого файла |
Нет |
Самоподписанный сертификат безопасности |
|||||||
gc.remove_deleted_files_enabled |
swl_gc |
Bool |
true |
Да |
Настройка включения очистки хранилища от файлов помеченных в базе данных на удаление |
||||||
gc.remove_deleted_files_init_delay |
swl_gc |
Длительность |
0s |
Да |
Задержка включения очистки хранилища от удалённых файлов после запуска swl_gc |
||||||
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)
|








