CLS. Руководство администратора - История изменений

V.Kazantsev: /* Термины и определения */

2026-01-13T08:39:29Z

Термины и определения

← Предыдущая версия		Версия от 11:39, 13 января 2026
Строка 46:		Строка 46:
	\|/opt/cls/logs/calls/		\|/opt/cls/logs/calls/
	\|Директория для хранения логов одиночных звонков		\|Директория для хранения логов одиночных звонков
			\|-
			\|global_max_channels
			\|20
			\|Ограничение максимального количества одновременных звонков. Суммарно, по всем активным листам.
	\|-		\|-
	! colspan="3" \|freeswitch		! colspan="3" \|freeswitch

YurchenkoV в 09:50, 1 сентября 2025

2025-09-01T09:50:29Z

← Предыдущая версия		Версия от 12:50, 1 сентября 2025
Строка 14:		Строка 14:

	'''Instance''' (Инстанция) - активный экземпляр ListCaller, выполняющий обзвон.		'''Instance''' (Инстанция) - активный экземпляр ListCaller, выполняющий обзвон.


			'''Конфигурирование параметров сервиса'''
			{\| class="wikitable"
			\|+
			!Параметр
			!По умолчанию
			!Назначение
			\|-
			! colspan="3" \|logs
			\|-
			\|logs.path
			\|logs/
			\|Директория для хранения логов. Примеры абсолютного пути: "/var/log/ups/"
			\|-
			\|logs.backups
			\|10
			\|Количество файлов ротации.
			\|-
			\|logs.maxSize
			\|5242880
			\|Максимальный размер одного логфайла.
			\|-
			! colspan="3" \|
			\|-
			\|list_log_dir
			\|/opt/cls/logs/lists/
			\|<nowiki>Директория для хранения логов обзвона \| уведомления по каждому списку</nowiki>
			\|-
			\|call_log_dir
			\|/opt/cls/logs/calls/
			\|Директория для хранения логов одиночных звонков
			\|-
			! colspan="3" \|freeswitch
			\|-
			\|freeswitch.server
			\|127.0.0.1
			\|Адрес, на котором работает FreeSWITCH
			\|-
			\|freeswitch.port
			\|8021
			\|Порт, на котором работает FreeSWITCH
			\|-
			\|freeswitch.auth
			\|ClueCon
			\|Пароль для аутентификации при подключении к Event Socket у FreeSwitch
			\|-
			\|freeswitch.src_profile
			\|internal
			\|Какой SIP-профиль FreeSWITCH должен использовать в качестве '''источника''' для исходящего звонка
			\|-
			\|freeswitch.dst_profile
			\|internal
			\|В какой SIP-профиль будет отправлен вызов после его обработки внутри FreeSWITCH
			\|-
			\|freeswitch.src_context
			\|ses
			\|Диалплан (Dialplan) FreeSWITCH, который будет использоваться для '''обработки вызова на этапе его происхождения (origination)'''. Диалплан — это набор правил и инструкций, которые определяют, как обрабатывать вызов.
			\|-
			\|freeswitch.dst_trunk
			\|10.2.0.220:5060
			\|Куда именно отправить вызов.
			\|-
			! colspan="3" \|ses
			\|-
			\|ses.host
			\|127.0.0.1
			\|Адрес сервиса ses для рассылки уведомлений
			\|-
			\|ses.port
			\|6190
			\|Порт сервиса ses для рассылки уведомлений
			\|}

YurchenkoV в 09:11, 19 августа 2025

2025-08-19T09:11:21Z

← Предыдущая версия		Версия от 12:11, 19 августа 2025
Строка 1:		Строка 1:
	CLS. Руководство администратора		CLS. Руководство администратора (в разработке)

			===== '''Общее описание''' =====
			Сервис массового обзвона и уведомлений, поддерживающий множественные каналы связи и гибкую настройку

			===== '''Термины и определения''' =====
			'''CLS''' (Call List Service) - сервис массового обзвона и уведомлений с поддержкой множественных каналов связи.

			'''Swagger UI''' – интерактивная веб-консоль с кратким описанием методов API и возможностью выполнять запросы к сервису CLS в реальном времени.

			'''Список обзвона \| уведомления''' (Call List) - набор контактов с метаданными для выполнения массовой рассылки или обзвона.

			'''ListCaller''' - основной класс, управляющий выполнением кампании по конкретному списку.

			'''Instance''' (Инстанция) - активный экземпляр ListCaller, выполняющий обзвон.

YurchenkoV: Содержимое страницы заменено на «CLS. Руководство администратора»

2025-07-30T12:15:19Z

Содержимое страницы заменено на «CLS. Руководство администратора»

← Предыдущая версия		Версия от 15:15, 30 июля 2025
Строка 1:		Строка 1:
	CLS. Руководство ~~пользователя~~		CLS. Руководство администратора

	~~===== '''Общее описание''' =====~~


	~~===== '''Термины и определения''' =====~~
	~~Сервис Call List Service (CLS) – сервис обзвона списков~~

	Swagger UI – интерактивная веб-консоль с кратким описанием методов API и возможностью выполнять запросы к сервису CLS.



	~~===== '''Описание методов API BSS''' =====~~
	Запросы осуществляются по протоколу HTTP 1.1 на адрес сервера с доступным сервисом CLS. По умолчанию используется порт 6188/tcp.

	~~Авторизация запросов не требуется. HTTP-запросы должны иметь заголовок <code>"accept: application/json"</code>~~


	~~{\| class="wikitable" style="width: 110%"~~
	~~\|+'''''Описание методов API'''''~~
	~~! style="color:green;width: 15%" \|'''POST/bss/backup/{ip}'''~~
	~~! colspan="3" style="width: 85%" \|<small>Принудительный бэкап сервера. На выходе id задания или сообщение об ошибке</small>~~
	\|-
	~~\| colspan="2" style="width: 50%" \|~~
	* <small>'''ip''' - ip адрес сервера данные с которого будут сохранены. IP адрес и каталоги с данными должны быть в конфиге</small>
	~~\| colspan="2" style="width: 50%" \|<small>{ "task_id": "73c8b134-4883-445c-ba9d-3058962bda43" }</small>~~
	\|-
	~~! style="color:green;width: 15%" \|'''POST/bss/config'''~~
	~~! colspan="3" style="width: 85%" \|<small>Обновить конфигурацию. Установит новый конфиг и заставит сервис его перечитать.</small>~~
	\|-
	~~\| colspan="2" style="width: 50%" \|<small>config - json новой конфигурации, структура как у config.json</small>~~
	~~\| colspan="2" style="width: 50%" \|<small>{ "message": "Configuration updated and reload requested" }</small>~~
	\|-
	~~! style="color:blue;width: 15%" \|'''GET/bss/config'''~~
	~~! colspan="3" style="width: 85%" \|<small>Получить текущую конфигурацию</small>~~
	\|-
	~~\| colspan="2" style="width: 50%" \|<small>Нет параметров</small>~~
	~~\| colspan="2" style="width: 50%" \|<small>Содержимое файла cjnfig.json</small>~~
	\|-
	~~! style="color:blue;width: 15%" \|'''GET/bss/tasks'''~~
	~~! colspan="3" style="width: 85%" \|<small>Получить список всех заданий и их результатов за последние два дня</small>~~
	\|-
	~~\| colspan="2" style="width: 50%" \|<small>Нет параметров</small>~~
	~~\| colspan="2" style="width: 50%" \|<small>Список словарей заданий. в каждом элементы:</small>~~
	~~<small>task_id, ip_address, status, result, timestamp</small>~~
	\|}

YurchenkoV: Новая страница: «CLS. Руководство пользователя ===== '''Общее описание''' ===== ===== '''Термины и определения''' ===== Сервис Call List Service (CLS) – сервис обзвона списков Swagger UI – интерактивная веб-консоль с кратким описанием методов API и возможностью выполнять запросы к сервису CLS. ===== '...»

2025-07-30T12:14:10Z

Новая страница: «CLS. Руководство пользователя ===== '''Общее описание''' ===== ===== '''Термины и определения''' ===== Сервис Call List Service (CLS) – сервис обзвона списков Swagger UI – интерактивная веб-консоль с кратким описанием методов API и возможностью выполнять запросы к сервису CLS. ===== '...»

Новая страница

CLS. Руководство пользователя

===== '''Общее описание''' =====

===== '''Термины и определения''' =====
Сервис Call List Service (CLS) – сервис обзвона списков

Swagger UI – интерактивная веб-консоль с кратким описанием методов API и возможностью выполнять запросы к сервису CLS.

===== '''Описание методов API BSS''' =====
Запросы осуществляются по протоколу HTTP 1.1 на адрес сервера с доступным сервисом CLS. По умолчанию используется порт 6188/tcp.

Авторизация запросов не требуется. HTTP-запросы должны иметь заголовок <code>"accept: application/json"</code>

{| class="wikitable" style="width: 110%"
|+'''''Описание методов API'''''
! style="color:green;width: 15%" |'''POST/bss/backup/{ip}'''
! colspan="3" style="width: 85%" |Принудительный бэкап сервера. На выходе id задания или сообщение об ошибке
|-
| colspan="2" style="width: 50%" |
* '''ip''' - ip адрес сервера данные с которого будут сохранены. IP адрес и каталоги с данными должны быть в конфиге
| colspan="2" style="width: 50%" |{ "task_id": "73c8b134-4883-445c-ba9d-3058962bda43" }
|-
! style="color:green;width: 15%" |'''POST/bss/config'''
! colspan="3" style="width: 85%" |Обновить конфигурацию. Установит новый конфиг и заставит сервис его перечитать.
|-
| colspan="2" style="width: 50%" |config - json новой конфигурации, структура как у config.json
| colspan="2" style="width: 50%" |{ "message": "Configuration updated and reload requested" }
|-
! style="color:blue;width: 15%" |'''GET/bss/config'''
! colspan="3" style="width: 85%" |Получить текущую конфигурацию
|-
| colspan="2" style="width: 50%" |Нет параметров
| colspan="2" style="width: 50%" |Содержимое файла cjnfig.json
|-
! style="color:blue;width: 15%" |'''GET/bss/tasks'''
! colspan="3" style="width: 85%" |Получить список всех заданий и их результатов за последние два дня
|-
| colspan="2" style="width: 50%" |Нет параметров
| colspan="2" style="width: 50%" |Список словарей заданий. в каждом элементы:
task_id, ip_address, status, result, timestamp
|}