Активация услуги cc_agent через CoCon CLI

Для того чтобы оператор мог зарегистрироваться на телефонном номере, для данного телефонного номера должна быть активирована услуга cc_agent. Рекомендуется активировать эту услугу только для тех телефонных номеров, которые специально зарезервированы для регистрации на них операторов. Здесь нужно соблюсти осторожность, так как супервизор имеет возможность прослушивать любой телефонный номер из тех, которые заняты его агентами.

Не стоит активировать услугу cc_agent для всех телефонных номеров в виртуальной АТС кроме случаев, когда вы точно осознаете что делаете.

Пример активации услуги cc_agent:

admin@[restfs1@ecss1]:/$ domain/test.domain/ss/activate 103 cc_agent 
Success: Supplementary service cc_agent activated for domain "test.domain" address "103"

Услуга cc_agent должна быть установлена в виртуальной АТС, и разрешена для использования этим оператором. Если услуга не установлена, то вам нужно воспользоваться инструкцией по установке и использованию услуги в ECSS-10.

Создание операторов и супервизоров в CoCon CLI

Очередь может работать как с обычными телефонными номерами, так и расширенными операторами, обладающими дополнительными возможностями. Для того чтобы добавить расширенного оператора, его нужно предварительно создать.

Команды по управлению агентами в call-центре см. в разделе Команда управления агентами.

Раскрыть описание команд

В данном разделе описаны команды управления агентами в Call-центре.

declare

Команда позволяет создать агентов виртуального call-центра.

Путь команды:

/domain/<DOMAIN>/cc/agent/declare

Синтаксис:

declare {<AgentRange> | auto} <Parameters>

Параметры:

<AgentRange> - интервал идентификаторов агентов. Идентификатор агента - целое число, которое будет использоваться для управления агентом с телефонного аппарата. Значение auto говорит о том, что будет автоматически выбран свободный идентификатор.
<Parameters> - список параметров через запятую:

Таблица 1

Свойство	Значение	Описание
auto_complete_timeout	0..3600(сек) или infinity	таймер автоматического завершения постобработки в секундах, 0 - означает, что этап постобработки отключен
auto_logout_timeout	5-720 мин. По умолчанию - 120	период неактивности оператора, после которого осуществляется выход из сессии
call_recording	boolean, по умолчанию false	включена или нет запись разговора для агента
description	строка	краткое описание агента
display_name	строка	отображаемое имя агента
group	строка, по умолчанию default	группа, к которой относится агент
load	pos_integer, по умолчанию 1	количество одновременных вызовов, которое могут быть распределены на агента
password	строка	пароль для аутентификации, состоит из чисел и имеет длину не менее 4-х символов
pickup	true/false, по умолчанию false	перехват прямого вызова в call-центре
skills	[skill[/subskill]:quality, ...]	список умений, который определяет способности и уровень квалификации оператора <police \| psychologie>(quality 0-100)
supervisor	true/false, по умолчанию false	включение привилегий "супервизора", способность регистрироваться в АРМ супервизора и наблюдать за операторами в своей группы
working_timeout	5-1440 мин. По умолчанию - 120	интервал времени в течении которого агент должен быть не подключен к системе (logout) после которого "смена" для статистики закрывается

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cc/agent/declare 555 auto_complete_timeout = 15, call_recording = true, skills = [police: 99]
ok

[exec at: 23.02.2019 10:34:57, exec time: 91ms, nodes: ds1@ecss1]

clean

Команда позволяет очистить свойства определенных агентов виртуального call-центра.

Путь команды:

/domain/<DOMAIN>/cc/agent/clean

Синтаксис:

clean <AgentRange> <Property>

Параметры:

<AgentRange> - идентификатор агента или шаблон. Шаблон ag{1-20} задает список из 20 агентов: ag1, ag2, ..., ag20;
<Property> - имя свойства. В системе существует набор стандартных свойств (group, load и другое) и свойства, состоящие из нескольких слов, разделенных символом "\", в общем виде выглядят: "general\specific\private"

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cc/agent/clean 555 skills 
ok
Configuration changes will be applied after re-login

[exec at: 23.02.2019 10:57:45, exec time: 91ms, nodes: ds1@ecss1]

info

Команда позволяет отобразить значения одного либо всех свойств определенных агентов виртуального call-центра.

Путь команды:

/domain/<DOMAIN>/cc/agent/info

Синтаксис:

info <AgentRange> [<Property> | <Pattern>]

Параметры:

<AgentRange> - идентификатор агента или шаблон. Шаблон ag{1-20} задает список из 20 агентов: ag1, ag2, ..., ag20;
<Property> - имя свойства. В системе существует набор стандартных свойств (agent_id, load и другое) и свойства, состоящие из нескольких слов, разделенных символом "\", в общем виде выглядят: "general\specific\private".
<Pattern> - шаблон, с которым будет сравниваться свойство. Отличается от свойства наличием символа "*"(wildcard). Символ "*" соответствует 1 и более слову (не символу) в сложном свойстве. Например, шаблону "general\specific\*" будет соответствовать свойство "general\specific\private", а "general\spe*" не будет являться корректным шаблоном.

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cc/agent/info 5{00-02}
┌─────┬────────────────────────────────────┐
│Agent│             Properties             │
├─────┼────────────────────────────────────┤
│500  │agent_id              <<"500">>     │
│     │auto_complete_timeout 5 sec.        │
│     │call_recording        false         │
│     │description           1 линия ТП    │
│     │display_name                        │
│     │group                 ltp1          │
│     │load                  1             │
│     │password              500500        │
│     │pickup                false         │
│     │skills                psychologie:80│
│     │supervisor            true          │
│     │working_timeout       120 min.      │
│501  │agent_id              <<"501">>     │
│     │auto_complete_timeout 5 sec.        │
│     │call_recording        false         │
│     │description           1 линия ТП    │
│     │display_name                        │
│     │group                 ltp1          │
│     │load                  1             │
│     │password              500500        │
│     │pickup                false         │
│     │skills                psychologie:80│
│     │supervisor            false         │
│     │working_timeout       120 min.      │
│502  │agent_id              <<"502">>     │
│     │auto_complete_timeout 5 sec.        │
│     │call_recording        false         │
│     │description           1 линия ТП    │
│     │display_name                        │
│     │group                 ltp1          │
│     │load                  1             │
│     │password              500500        │
│     │pickup                false         │
│     │skills                psychologie:80│
│     │supervisor            false         │
│     │working_timeout       120 min.      │
└─────┴────────────────────────────────────┘

[exec at: 23.02.2019 10:39:25, exec time: 75ms, nodes: ds1@ecss2]

list

Команда предназначена для просмотра списка агентов виртуального call-центра.

Путь команды:

/domain/<DOMAIN>/cc/agent/list

Синтаксис:

list [ --password ]

Параметры:

--password - показывать колонку password в результате команды, или нет. По умолчанию колонка не показывается.

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cc/agent/list --password

┌────────┬────────────┬───────┬──────────┬───────────┬────────┬────────┬────────┬───────┬────┬──────────────┐
│Agent id│Display name│ Group │Supervisor│Description│Password│  Auto  │Working │ Auto  │Load│    Skills    │
│        │            │       │          │           │        │complete│timeout │logout │    │              │
│        │            │       │          │           │        │timeout │        │timeout│    │              │
├────────┼────────────┼───────┼──────────┼───────────┼────────┼────────┼────────┼───────┼────┼──────────────┤
│500     │            │ltp1   │true      │1 линия ТП │500500  │5       │120 min.│inf    │1   │psychologie:80│
│501     │            │ltp1   │          │1 линия ТП │500500  │5       │120 min.│inf    │1   │psychologie:80│
│502     │            │ltp1   │          │1 линия ТП │500500  │5       │120 min.│inf    │1   │psychologie:80│
│503     │            │ltp1   │          │1 линия ТП │500500  │5       │120 min.│inf    │1   │psychologie:80│
│504     │            │ltp1   │          │1 линия ТП │500500  │5       │120 min.│inf    │1   │psychologie:80│
│505     │            │ltp1   │          │1 линия ТП │500500  │5       │120 min.│inf    │1   │psychologie:80│
│506     │            │ltp1   │          │1 линия ТП │500500  │5       │120 min.│inf    │1   │psychologie:80│
│507     │            │ltp1   │          │1 линия ТП │500500  │5       │120 min.│inf    │1   │psychologie:80│
│508     │            │ltp1   │          │1 линия ТП │500500  │5       │120 min.│inf    │1   │psychologie:80│
│509     │            │ltp1   │          │1 линия ТП │500500  │5       │120 min.│inf    │1   │psychologie:80│
│510     │            │ltp2   │true      │           │500500  │5       │120 min.│inf    │1   │              │
│511     │            │ltp2   │          │           │500500  │5       │120 min.│inf    │1   │              │
│512     │            │ltp2   │          │           │500500  │5       │120 min.│inf    │1   │              │
│513     │            │ltp2   │          │           │500500  │5       │120 min.│inf    │1   │              │
│514     │            │ltp2   │          │           │500500  │5       │120 min.│inf    │1   │              │
│515     │            │ltp2   │          │           │500500  │5       │120 min.│inf    │1   │              │
│516     │            │ltp2   │          │           │500500  │5       │120 min.│inf    │1   │              │
│517     │            │ltp2   │          │           │500500  │5       │120 min.│inf    │1   │              │
│518     │            │ltp2   │          │           │500500  │5       │120 min.│inf    │1   │              │
│519     │            │ltp2   │          │           │500500  │5       │120 min.│inf    │1   │              │
│520     │            │ltp3   │true      │           │500500  │5       │120 min.│inf    │1   │              │
│521     │            │ltp3   │          │           │500500  │5       │120 min.│inf    │1   │              │
│522     │            │ltp3   │          │           │500500  │5       │120 min.│inf    │1   │              │
│523     │            │ltp3   │          │           │500500  │5       │120 min.│inf    │1   │              │
│524     │            │ltp3   │          │           │500500  │5       │120 min.│inf    │1   │              │
│525     │            │ltp3   │          │           │500500  │5       │120 min.│inf    │1   │              │
│526     │            │ltp3   │          │           │500500  │5       │120 min.│inf    │1   │              │
│527     │            │ltp3   │          │           │500500  │5       │120 min.│inf    │1   │              │
│528     │            │ltp3   │          │           │500500  │5       │120 min.│inf    │1   │              │
│529     │            │ltp3   │          │           │500500  │5       │120 min.│inf    │1   │              │
│555     │            │default│          │           │        │15      │120 min.│inf    │1   │              │
└────────┴────────────┴───────┴──────────┴───────────┴────────┴────────┴────────┴───────┴────┴──────────────┘

[exec at: 23.02.2019 10:58:31, exec time: 92ms, nodes: ds1@ecss2]

remove

Команда предназначена для удаления агентов виртуального call-центра.

Путь команды:

/domain/<DOMAIN>/cc/agent/remove

Синтаксис:

remove <AgentRange>

Параметры:

<AgentRange> - идентификатор агента или шаблон. Шаблон ag{1-20} задает список из 20 агентов: ag1, ag2, ..., ag20;

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cc/agent/remove 555
ok

[exec at: 23.02.2019 11:01:39, exec time: 83ms, nodes: ds1@ecss1]

set

Команда предназначена для изменения свойств агентов виртуального call-центра или создания нового свойства с указанным значением.

Путь команды:

/domain/<DOMAIN>/cc/agent/set

Синтаксис:

set <AgentRange> <Property> <Value>

Параметры:

<AgentRange> - идентификатор агента или шаблон. Шаблон ag{1-20} задает список из 20 агентов: ag1, ag2, ..., ag20;
<Property> - имя свойства. Возможные значения приведены в таблице 1, а так же свойства из таблицы 2:

Таблица 2

Свойство	Значение	Описание
integration\confluence	string, по умолчанию не задано	Ключ доступа (API key) пользователя Confluence
integration\redmine	<Login> <Password> - учетные данные пользователя Redmine	учетные данные пользователя Redmine <Login> - имя учетной записи; <Password> - пароль учетной записи
integration\redmine\task\project	string, по умолчанию не задано	имя Redmine проекта по умолчанию. В рамках указанного проекта будут создаваться задачи при поступлении вызова в КЦ
integration\redmine\task\subject	string, по умолчанию не задано	шаблон темы создаваемой задачи в Redmine при поступлении вызова в КЦ. Поддерживает макро-переменные (макро-переменные указываются через процент, например %CGPN.digits%). Возможные макро-переменные: CGPN.digits - номер вызывающего (А) абонента; CDPN.digits - номер вызываемого (Б) абонента; CGPN.display_name - имя вызывающего абонента; CDPN.display_name - имя вызываемого абонента; DATE - текущая дата; TIME - текущее время; AGENT_ID - идентификатор агента КЦ, на которого распределился вызов; QUEUE_ID - имя очереди, через которую вызов распределился на агента КЦ (если вызов пришел напрямую на агента КЦ, то данное поле будет пустым); WORKITEM_ID - внутренний идентификатор заявки в КЦ
integration\redmine\task\body	string, по умолчанию не задано	шаблон тела создаваемой задачи в Redmine при поступлении вызова в КЦ. Поддерживает макро-переменные аналогичные тем, что используются для переменной integration\redmine\task\subject

<Value> - значение, которое будет установлено свойству.

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cc/agent/set 5{00-09} skills [psychologie:80]
ok
Configuration changes will be applied after re-login

[exec at: 23.02.2019 10:38:56, exec time: 83ms, nodes: ds1@ecss1]

where

Команда предназначена для списка очередей к которым подключен агент.

Путь команды:

/domain/<DOMAIN>/cc/agent/where

Синтаксис:

where <AgentId>

Параметры:

<AgentId> - идентификатор агента.

Пример:

admin@[sip1@ecss1]:/$ domain/biysk.local/cc/agent/where 500 
line1.

[exec at: 23.02.2019 11:00:52, exec time: 83ms, nodes: ds1@ecss1]

В виртуальной АТС изначально нет ни одного оператора. Посмотреть список операторов, можно, используя команду list.

admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/list 
┌────────┬────────────┬─────┬──────────┬───────────┬────────┬────────┬────┐
│Agent id│Display name│Group│Supervisor│Description│Password│  Auto  │Load│
│        │            │     │          │           │        │complete│    │
├────────┼────────────┼─────┼──────────┼───────────┼────────┼────────┼────┤
└────────┴────────────┴─────┴──────────┴───────────┴────────┴────────┴────┘

Пример 1:

Создадим нового оператора. Для создания оператора необходимо явно указать его целочисленный идентификатор. Этот идентификатор будет использоваться для входа в АРМ и управления оператором с телефонного аппарата.

admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/declare 1 
ok

[exec at: 29.06.2016 22:51:13, exec time: 29ms, nodes: ds1@ecss1]
admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/list      
┌────────┬────────────┬───────┬──────────┬───────────┬────────┬────────┬────┐
│Agent id│Display name│ Group │Supervisor│Description│Password│  Auto  │Load│
│        │            │       │          │           │        │complete│    │
├────────┼────────────┼───────┼──────────┼───────────┼────────┼────────┼────┤
│1       │            │default│          │           │        │        │1   │
└────────┴────────────┴───────┴──────────┴───────────┴────────┴────────┴────┘

Если не указывать группу, то оператору автоматически будет выставлена группа по умолчанию - default. Если мы не укажем пароль данному оператору, то такой оператор не сможет выполнить вход в систему.

Редакция свойств оператора.

Свойства оператора можно редактировать после его создания:

admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/set 1 display_name "Иван Васильевич"  
ok

admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/set 1 supervisor true               
ok

admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/set 1 description "Супервизор главной группы" 
ok

admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/set 1 password 142354  
ok

┌────────┬───────────────┬───────┬──────────┬─────────────────────────┬────────┬────────┬────┐
│Agent id│ Display name  │ Group │Supervisor│       Description       │Password│  Auto  │Load│
│        │               │       │          │                         │        │complete│    │
├────────┼───────────────┼───────┼──────────┼─────────────────────────┼────────┼────────┼────┤
│1       │Иван Васильевич│default│true      │Супервизор главной группы│142354  │        │1   │
└────────┴───────────────┴───────┴──────────┴─────────────────────────┴────────┴────────┴────┘

В именах и описании можно использовать кириллицу.

Мы можем создавать несколько операторов одной командой, с помощью интервала:

admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/declare {3-4} 
ok

[exec at: 29.06.2016 23:04:58, exec time: 48ms, nodes: ds1@ecss1]
admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/list         
┌────────┬───────────────┬───────┬──────────┬─────────────────────────┬────────┬────────┬────┐
│Agent id│ Display name  │ Group │Supervisor│       Description       │Password│  Auto  │Load│
│        │               │       │          │                         │        │complete│    │
├────────┼───────────────┼───────┼──────────┼─────────────────────────┼────────┼────────┼────┤
│1       │Иван Васильевич│default│true      │Супервизор главной группы│142354  │        │1   │
│3       │               │default│          │                         │        │        │1   │
│4       │               │default│          │                         │        │        │1   │
└────────┴───────────────┴───────┴──────────┴─────────────────────────┴────────┴────────┴────┘

Команда создания оператора может автоматически выбрать целочисленный идентификатор оператора с помощью опции auto:

admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/declare auto display_name = Алекс, description = Оператор главной группы, password = 335123
ok

[exec at: 29.06.2016 23:11:38, exec time: 32ms, nodes: ds1@ecss1]
admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/list                                                                                       
┌────────┬───────────────┬───────┬──────────┬─────────────────────────┬────────┬────────┬────┐
│Agent id│ Display name  │ Group │Supervisor│       Description       │Password│  Auto  │Load│
│        │               │       │          │                         │        │complete│    │
├────────┼───────────────┼───────┼──────────┼─────────────────────────┼────────┼────────┼────┤
│1       │Иван Васильевич│default│true      │Супервизор главной группы│142354  │        │1   │
│2       │Алекс          │default│          │Оператор главной группы  │335123  │        │1   │
│3       │               │default│          │                         │        │        │1   │
│4       │               │default│          │                         │        │        │1   │
└────────┴───────────────┴───────┴──────────┴─────────────────────────┴────────┴────────┴────┘

[exec at: 29.06.2016 23:11:42, exec time: 15ms, nodes: ds1@ecss1]

Для завершения конфигурирования группы укажем дополнительную информацию об операторах:

admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/set 3 display_name Боб
ok

[exec at: 29.06.2016 23:13:35, exec time: 61ms, nodes: ds1@ecss1]
admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/set 3 password 114235 
ok

[exec at: 29.06.2016 23:13:49, exec time: 24ms, nodes: ds1@ecss1]
admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/set 4 display_name Цезарь
ok

[exec at: 29.06.2016 23:14:07, exec time: 30ms, nodes: ds1@ecss1]
admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/set 4 password 232456    
ok

[exec at: 29.06.2016 23:14:16, exec time: 29ms, nodes: ds1@ecss1]
admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/list                 
┌────────┬───────────────┬───────┬──────────┬─────────────────────────┬────────┬────────┬────┐
│Agent id│ Display name  │ Group │Supervisor│       Description       │Password│  Auto  │Load│
│        │               │       │          │                         │        │complete│    │
├────────┼───────────────┼───────┼──────────┼─────────────────────────┼────────┼────────┼────┤
│1       │Иван Васильевич│default│true      │Супервизор главной группы│142354  │        │1   │
│2       │Алекс          │default│          │Оператор главной группы  │335123  │        │1   │
│3       │Боб            │default│          │                         │114235  │        │1   │
│4       │Цезарь         │default│          │                         │232456  │        │1   │
└────────┴───────────────┴───────┴──────────┴─────────────────────────┴────────┴────────┴────┘

Установим описание операторам 3 и 4:

admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/set {3-4} description Оператор главной группы
ok

[exec at: 29.06.2016 23:15:44, exec time: 27ms, nodes: ds1@ecss1]
admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/agent/list                                         
┌────────┬───────────────┬───────┬──────────┬─────────────────────────┬────────┬────────┬────┐
│Agent id│ Display name  │ Group │Supervisor│       Description       │Password│  Auto  │Load│
│        │               │       │          │                         │        │complete│    │
├────────┼───────────────┼───────┼──────────┼─────────────────────────┼────────┼────────┼────┤
│1       │Иван Васильевич│default│true      │Супервизор главной группы│142354  │        │1   │
│2       │Алекс          │default│          │Оператор главной группы  │335123  │        │1   │
│3       │Боб            │default│          │Оператор главной группы  │114235  │        │1   │
│4       │Цезарь         │default│          │Оператор главной группы  │232456  │        │1   │
└────────┴───────────────┴───────┴──────────┴─────────────────────────┴────────┴────────┴────┘

Мы получили простейшую конфигурацию операторов Call-центра с группой по-умолчанию, тремя операторами и одним супервизором. Для создания группы не требуется предпринимать какие-либо дополнительные действия. Если при создании оператора указать имя группы, которое ранее не использовалось, будет создана новая группа.

В дальнейшем для изменения свойств созданных операторов мы можем использовать команду set. Стоит однако отметить, что свойства оператора применяются и будут видны в АРМ.
Для завершения конфигурирования, вновь созданных операторов осталось добавить в одну из очередей. Далее мы создадим расширенную очередь и добавим в неё наших операторов.

Создание расширенной очереди в CoCon CLI

Создать расширенную очередь и добавить в нее операторов и/или телефонные номера можно используя CoCon CLI (см. 3.14.4 Создание и настройка расширенной очереди в CoCon (CLI)).

Команды управления очередью расположены по пути:

/domain/<Domain>/cc/queue/

Новая очередь создается командой declare. Приведем здесь полный синтаксис команды declare:

admin@mycelium1@ecss1:/$ domain/biysk.local/cc/queue/declare -h
Declare new queue.
Usage: declare <QueueName> [<Parameters>]
<QueueName> - name of queue to declare.
<Parameters> (key1=value1, ..., keyN=valueN):
agents :: list of operators and/or aliases. Example: [agent:1,agent:2,alias:101, ...]
distribution_mode :: random | mia | loa | multicall
random - Random agent. The random available agent;
mia - Most Idle Agent. The available agent who has been idle the longest since their last call;
loa - Least Occupied Agent. The available agent with the lowest percentage of work time since login;
multicall - Call on all available agents simultaneously;
skill_based_distribution :: true | false - enables skill based distribution
max_wait_time :: Time in seconds
max_distribution_attempts :: Max distribution attemps performed before conversation leaves queue
max_distribution_duration :: Max time in seconds between operators selected and connection established
ringback_mode :: once | none. Once (default) - play ringback if distribution starts immediately after call enqueued. None - don't play ringback
max_active_waiting_callbacks :: Max active waiting callbacks count
window_duration :: Max time in seconds before window moved to the next available operators in serial-based distributions
groups :: Supervisor can observe queue only if it is in the same group
description :: string()
remember_choice :: none | strict | non-strict. Distribute conversation on previously selected operator
none - disabled;
strict - if operator busy wait until he become available;
non-strict - if operator busy use ordinary distribution strategy;
email :: Email address to send important notifications (call missing)
Rules below applied to call before accept it into queue:
rules\max_predicted_time :: Time in seconds. Max predicted wait time. If it exeeded call will be declined
rules\queue_length :: non_neg_integer(). Max enqueued calls number
rules\decline_if_no_operators :: boolean(). If true and if no queue operators is logged in call will be declined
time_prediction\statistics\lower_threshold :: Lower threshold of conversation duration in seconds. Values less then lower threshold ignored during prediction. Default is 10 seconds.
time_prediction\statistics\upper_threshold :: Upper threshold of conversation duration in seconds. Values greater then upper threshold ignored during prediction. Default is 30 minutes.
time_prediction\statistics\max_count :: Max values stored in the statistics count. Default is 100.
time_prediction\based_on :: average | most_freq | defined_value. What value to consider during prediction. Default is average.
average - processed conversation duration average.
most_freq - most frequently appeared interval of conversation processing duration.
defined_value - manually specified value of conversation processing duration.
time_prediction\defined_value :: Manually defined single conversation processing time in seconds. It used in prediction if it explicitly specified by time_prediction\based_on or if statistic values count less then time_prediction\min_values_in_statistics. Default is 60 seconds.
time_prediction\min_values_in_statistics :: Min values count in the statistics to make prediction. If values count less then time_prediction\min_values_in_statistics then queue will use time_prediction\defined_value as estimate value of the single conversation handling duration. Default is 10

3.14.4 /domain/<DOMAIN>/cc/queue/ - команды управления очередями

Таблица 1. Параметры очереди.

Параметр	Значение	Описание
Агенты (agents)	список вариантов:	список операторов, обслуживающих данную очередь
	Агент (agent):<AgentId>	созданный заранее оператор (см. Создание агентов)
	Номер (alias):<PhoneNumber>	телефонный номер абонента софтсвича или внешний номер
Описание (description)	строка	краткое описание очереди
Распределение (distribution_mode)	варианты:	одна из следующих стратегий распределения:
	ручное(manual)	распределение звонков из очереди осуществляется супервизором вручную
	зацикленное(cycle)	циклическое распределение
	распределение с последовательным включением новых агентов (progressive)	распределение с последовательным включением агентов в окно вызова
	Серийное распределение (serial)	устанавливает соединение с операторами в порядке, в котором они добавлены в очередь
	случайное (random)	случайный оператор
	наиболее свободный агент (mia)	наиболее свободный агент (Most Idle Agent) - оператор, который свободен от обслуживания нагрузки дольше других
	наименее занятый агент (loa)	наименее занятый агент (Least Occupied Agent) - оператор, который обслужил меньшую нагрузку за определенный промежуток времени
	массовый обзвон (multicall)	вызов на всех доступных операторов одновременно
Почта (email)	адрес почты	адрес почты, на который необходимо отправлять оповещения о пропущенных звонках
Расширенный режим распределения (extra_condition_mode)	none	очередь не будет анализировать поле extra_number на уровне ДВО cc_agent на номере агента КЦ
	non_strict	если в очереди у агента КЦ телефон с номером из extra_number сейчас занят вызовом, то на такого агента очередь распределить вызов только в том случае, если нет других свободных агентов КЦ
	strict	если в очереди у агента КЦ телефон с номером из extra_number сейчас занят вызовом, то на такого агента очередь распределить вызовы не будет
Максимальное время попыток распределения (max_distribution_duration)	число, секунды	Максимальное время для одной попытки распределения. Данный параметр используется для того, чтобы ограничить время попытки распределения вызова (актуально для cycled режима)
Максимальное время ожидания (max_wait_time)	число, секунды	максимальное время, которое вызов находится в очереди. По истечении этого времени вызов покидает очередь и IVR сценарий продолжает выполнение по ветви ERROR
Максимальное количество обратных вызовов (max_active_waiting_callbacks)	число, секунды	Максимальное количество активных ожидающих обратных вызовов
Обработка повторных обращений (remember_choice)	варианты:	отправлять вызов на того же оператора при повторном обращении клиента:
	не запоминать распределение (none)	не запоминать распределение
	запоминать распределение (strict)	распределять в любом случае
	распределять, если агент свободен (non_strict)	распределять, если агент свободен
Режим КПВ (ringback_mode)	варианты:	Режим проигрывания приветствия
	однократно (once)	Однократно (по умолчанию) - проигрывать КПВ, если распределение началось немедленно при помещении вызова в очередь
	Не проигрывать КПВ (none)	Не проигрывать КПВ, только приветствие
отклонить, если нет операторов (rules\decline_if_no_operators)	bool	при значении true и отсутствии операторов очереди вызов будет отклонен
Максимальное предсказываемое время ожидания в очереди (rules\max_predicted_time)	число, секунды	максимальное предсказываемое время ожидания. При превышении вызов не будет помещен в очередь и IVR сценарий продолжит выполнение по ветви FULL;
Длина очереди (rules\queue_length)	число	максимальное количество вызовов в очереди. При превышении вызов не будет помещен в очередь и IVR сценарий продолжит выполнение по ветви FULL;
Распределение согласно умений (skill_based_distribution)	bool	распределение вызовов согласно умениям операторов (тут нужно сослаться на статью, где описывается установка skill для операторов);
time_prediction\based_on	варианты:	параметр, определяющий, какое значение будет считаться базовым при расчете предсказываемого времени ожидания разговоров в очереди:
	average	среднее значение длительности обработки вызова. Используется как значение по умолчанию.
	most_freq	среднее значение длительности обработки вызова в 30 секундном интервале, в который попало наибольшее количество разговоров;
	defined_value	указанное вручную примерное значение продолжительности обработки вызова;
time_prediction\defined_value	число, секунды	указанное вручную значение продолжительности обработки вызова в секундах. Используется в предсказании, если параметр `based_on` имеет значение `defined_value` или количество собранных значений продолжительности обработки вызовов, попадающих в интервал `[lower_threshold, upper_threshold]`, меньше значения `min_values_in_statistics`.
time_prediction\min_values_in_statistics	число	минимальное количество собранных значений продолжительности обработки вызова, попадающих в интервал `[lower_threshold, upper_threshold]`. Является пороговым значением, при достижении которого, очередь начинает использовать алгоритмы основанные на средних значениях (average,most_freq). По умолчанию 10 значений.
time_prediction\statistics\lower_threshold	число, секунды	наименьшее значение продолжительности обработки вызова, определяет нижнюю границу при сборе статистических данных. Все вызовы, длительность обработки которых не превышает данное значение, не будут учитываться при расчёте времени ожидания. По умолчанию 10 секунд.
time_prediction\statistics\max_count	число	максимальное количество значений продолжительности обработки вызовов, хранимое в статистике. По умолчанию 100.
time_prediction\statistics\upper_threshold	число, секунды	наибольшее значение продолжительности обработки вызова, определяет верхнюю границу при сборе статистических данных. Все вызовы, длительность обработки которых превышает данное значение, не будут учитываться при расчёте времени ожидания . По умолчанию 1800 секунд.
Период сдвига "окна вызовов",с:(window_duration)	число, секунды	тайм-аут сдвига окна вызовов. Данный параметр указывается для режимов: `cycled`, `serial`, `progressive` и показывает через какое время занимать нового оператора.

Назначение и параметры очереди подробно описаны в разделе Расширенная очередь.

Пример 2:

Создадим расширенную очередь и добавим в неё операторов, созданных в примере 1:

admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/queue/declare queue1 agents = [agent:2,agent:3,agent:4], description = "Тестовая очередь", groups = default, max_wait_time = 300, distribution_mode = random         
ok
admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/queue/list 
┌────────┬───────┬───────┬────────────┬────────┬─────┬────────────────┐
│Queue id│Groups │Agents │Distribution│Max wait│Rules│  Description   │
│        │       │       │    mode    │  time  │     │                │
├────────┼───────┼───────┼────────────┼────────┼─────┼────────────────┤
│queue1  │default│agent:2│random      │300     │     │Тестовая очередь│
│        │       │agent:3│            │        │     │                │
│        │       │agent:4│            │        │     │                │
└────────┴───────┴───────┴────────────┴────────┴─────┴────────────────┘

Командой выше мы создали очередь, в которую добавили агентов с идентификаторами 2,3 и 4. Максимальное время ожидания в ней 300 сек (5 минут), ограничений на максимальную длину или предсказываемое время ожидания нет. Очередь имеет стратегию распределения random. Это значит, что каждый раз во время распределения оператор будет выбираться из списка свободных случайным образом.

Также мы можем добавить в эту очередь обычные телефонные номера:
```
admin@[restfs1@ecss1]:/$ domain/test.domain2/cc/queue/queue1/add-agent alias 100{1-3}
ok
```
Новые параметры очереди применяются сразу же после их изменения.