Действия

CLS. Руководство пользователя: различия между версиями

Материал из Флора AI

Нет описания правки
Нет описания правки
Строка 290: Строка 290:
* <small>'''id''' - id списка | инстанции (одно и тоже)</small>
* <small>'''id''' - id списка | инстанции (одно и тоже)</small>
|<code><small>{</small></code>
|<code><small>{</small></code>
     "id": "86c08271-8415-4ba5-bcf1-e1115a602bd8",
     <code><small>"id": "86c08271-8415-4ba5-bcf1-e1115a602bd8",</small></code>
     "name": "Test Call List",
     <code><small>"name": "Test Call List",</small></code>
     "source": "8000",
     <code><small>"source": "8000",</small></code>
     "limits": {
     <code><small>"limits": {</small></code>
    "no_answer_timeout": 5,
        <code><small>"no_answer_timeout": 5,</small></code>
    "dial_tries": 1,
        <code><small>"dial_tries": 1,</small></code>
    "max_channels": 2,
        <code><small>"max_channels": 2,</small></code>
    "redial_timeout": 200,
        <code><small>"redial_timeout": 200,</small></code>
    "watchdog": 60
        <code><small>"watchdog": 60</small></code>
     },
     <code><small>},</small></code>
     "timeintervals": [
     <code><small>"timeintervals": ["default"],</small></code>
        "default"
     <code><small>"holidays": ["2025-09-14"],</small></code>
    ],
     <code><small>"channel": "voice",</small></code>
     "holidays": [
     <code><small>"running": true,</small></code>
        "2025-09-14",
     <code><small>"progress": {</small></code>
    ],
        <code><small>"total_items": 1,</small></code>
     "channel": "voice",
        <code><small>"processed_items": 1,</small></code>
     "running": true,
        <code><small>"completed": false,</small></code>
     "progress": {
        <code><small>"reason": ""</small></code>
    "total_items": 1,
     <code><small>},</small></code>
    "processed_items": 1,
     <code><small>"job_info": {</small></code>
    "completed": false,
         <code><small>"has_job": true,</small></code>
    "reason": ""
         <code><small>"job_id": "86c08271-8415-4ba5-bcf1-e1115a602bd8",</small></code>
     },
         <code><small>"next_run": "2025-12-24 20:00:00+03:00"</small></code>
     "job_info": {
     <code><small>},</small></code>
         "has_job": true,
     <code><small>"created": "2025-08-18T14:57:17.762777",</small></code>
         "job_id": "86c08271-8415-4ba5-bcf1-e1115a602bd8",
     <code><small>"items": [</small></code>
         "next_run": "2025-12-24 20:00:00+03:00"
         <code><small>{</small></code>
     },
             <code><small>"destinations": ["6000"],</small></code>
     "created": "2025-08-18T14:57:17.762777",
             <code><small>"metadata": {}</small></code>
     "items": [
         <code><small>}</small></code>
         {
     <code><small>]</small></code>
             "destinations": ["6000"],
             "metadata": {}
         }
     ]
<code><small>}</small></code>
<code><small>}</small></code>
|-
|-

Версия от 17:13, 18 августа 2025

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

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


Основные возможности:

  • Выбор канала связи
    • голосовые звонки - интеграция с FreeSWITCH для исходящих звонков
    • telegram | VK - интеграция с SES для последующей отправки уведомления в мессенджер
  • Управление списками обзвона
    • CRUD операции - создание, чтение, изменение, удаление списков
    • Импорт/Экспорт - загрузка и выгрузка контактов из CSV
    • Автозагрузка - динамическое расширение списков через скрипт
    • Планировщик - cron-подобное расписание запуска обзвонов
  • Конфигурация и лимиты
    • Глобальные настройки - централизованное управление конфигурацией
    • Временные интервалы - точное управление временем работы
    • Праздники - учет выходных дней при обзвонах
    • Лимиты обзвона - контроль нагрузки и таймаутов
  • Мониторинг и отчетность
    • Реальное время - отслеживание статуса обзвонов
    • Логирование - детальные логи всех звонков / уведомлений
    • API - полный программный доступ ко всем функциям


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

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

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

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

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

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

Описание методов API

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

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

Содержимое документа зависит от результата выполнения запроса. При наличии ошибки в качестве ответа вернется переменная error=1 и описание в переменной message. Для удобства проверки методов по ссылке http://АДРЕС:6188 будет отображен интерфейс Swagger со всеми методами с возможностью их проверки.

Описание методов API
Управление обзвонами
POST /calls/call Прямой звонок с номера на номер
{ 
   "source": "8000",

   "destination": "6000",

   "limits": {

       "no_answer_timeout": 10,

       "dial_tries": 1,

       "max_channels": 2,

       "redial_timeout": 600,

       "watchdog": 240

   },

   "metadata": {}

}

{ 
     "error": 0,

     "message": "сообщение о статусе результата"

}

POST /calls/start Старт списка обзвона | оповещения
  • id - id списка
 { 
     "error": 0,

     "message": "сообщение о статусе результата"

}

POST /calls/stop Остановка списка обзвона | оповещения
  • id - id списка
 { 
     "error": 0,

     "message": "сообщение о статусе результата"

}

Управление списками обзвона | оповещения
POST /lists/add Добавление нового списка для обзвона | оповещения
{

  "name": "Test Call List", - имя списка

  "source": "8000", - источник вызова | оповещения

  "limits": { - лимиты для вызова (опционально)

    "no_answer_timeout": 10,

    "dial_tries": 1,

    "max_channels": 2,

    "redial_timeout": 600,

    "watchdog": 240

  },

  "dialed": 0,

  "timeintervals": [

    "default" - id временного интервала

  ],

  "channel": "voice", - используемый канал

  "channel_parameters": { - используется для каналов telegram и vk

    "robot_id": "",

    "endpoint": ""

  },

  "script_before_dial": "", - скрипт для выполнения перед каждым вызовом | оповещением

  "script": "", - скрипт дозагрузки элементов для обзвона

  "autoload": false, - автоматическая дозагрузка элементов для обзвона при старте списка

  "scheduler": [ - планировщик выполнения обзвона | оповещения

    "35 14 * * *" - cron-расписание запуска обзвона

  ],

  "items": [

    {

      "destinations": [ - телефоны | user_id для каналов отличных от voice

        "6000"

      ],

      "metadata": {} - дополнительная произвольная информация

    }

  ]

}

{ 
 "error": 0,

 "message": "success",

 "id": "123e4567-e89b-12d3-a456-426614174000"

}

DELETE /lists/delete/{id} Удаление существующего списка для обзвона | оповещения
  • id - id списка
 { 
     "error": 0,

     "message": "сообщение о статусе результата"

}

GET /lists/export/{id} Экспорт списка для обзвона | оповещения в CSV файл
  • id - id списка
 { 
     "error": 0,

     "message": "сообщение о статусе результата"

}

POST /lists/import/{id} Экспорт списка для обзвона | оповещения из CSV файла
  • csv - csv файл с элементами списка
  • id - id списка
 { 
     "error": 0,

     "message": "сообщение о статусе результата"

}

GET /lists/list Получения всех списков для обзвона | оповещения из БД
No parameters { 
   "error": 0,
   "lists": []

}

POST /lists/load/{id} Дозагрузка в существующую инстанцию списка обзвона | оповещения элементов из скрипта
  • id - id списка
 { 
     "error": 0,

     "message": "сообщение о статусе результата"

}

PUT /lists/modify/{id} Изменение существующего списка для обзвона | оповещения
  • payload как в POST /lists/add
  • id - id списка
 { 
     "error": 0,

     "message": "сообщение о статусе результата"

}

GET /lists/status/{id} Получение статуса существующего списка для обзвона | оповещения
  • id - id списка
 { 
   "error": 0,{
   "status": {
       "total_items": 0,
       "processed_items": 0,
       "completed": false,{
       "reason": "",
       "running": false
   }

}

Управление инстанциями обзвона | оповещения
POST /instances/add/{list_id} Создание инстанции обзвона | оповещения на основе списка, без запуска обзвона | оповещения
  • id - id списка
 { 
     "error": 0,

     "message": "сообщение о статусе результата"

}

GET /instances/get/{instance_id} Получить детальную информацию о конкретной инстанции
  • id - id списка | инстанции (одно и тоже)
 { 
   "id": "86c08271-8415-4ba5-bcf1-e1115a602bd8",
   "name": "Test Call List",
   "source": "8000",
   "limits": {
       "no_answer_timeout": 5,
       "dial_tries": 1,
       "max_channels": 2,
       "redial_timeout": 200,
       "watchdog": 60
   },
   "timeintervals": ["default"],
   "holidays": ["2025-09-14"],
   "channel": "voice",
   "running": true,
   "progress": {
       "total_items": 1,
       "processed_items": 1,
       "completed": false,
       "reason": ""
   },
   "job_info": {
       "has_job": true,
       "job_id": "86c08271-8415-4ba5-bcf1-e1115a602bd8",
       "next_run": "2025-12-24 20:00:00+03:00"
   },
   "created": "2025-08-18T14:57:17.762777",
   "items": [
       {
           "destinations": ["6000"],
           "metadata": {}
       }
   ]

}

GET /instances/list Получение списка инстанций
No parameters
DELETE /instances/remove/{instance_id} Удаление инстанции обзвона | оповещения
id - id списка | инстанции (одно и тоже) { 
     "error": 0,

     "message": "сообщение о статусе результата"

}

Управление временными интервалами
Источник — https://wiki.connect2ai.net/index.php?title=CLS._Руководство_пользователя&oldid=2996