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

declare

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

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

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

Синтаксис:

declare {<AgentRange> | auto} <Parameters>

Параметры:

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

Таблица 1 — Параметры агента

Свойство	Значение	Описание
Автоматическое завершение постобработки (auto_complete_timeout)	0..3600 (сек) или infinity, по умолчанию 0	таймер автоматического завершения постобработки в секундах. 0 означает, что этап постобработки отключен. infinity - постобработка не будет завершена автоматически, пока оператор не введет фичекод заверешния постобработки или не закроет окно постобработки в автоматизированном рабочем месте (АРМ) оператора на обзорной панели
Таймаут автоматического завершения сессии (auto_logout_timeout)	5-720 мин., по умолчанию — 120	период неактивности оператора, после которого осуществляется выход из сессии в АРМ
Статус после входа (auxwork after login)	одна из причин технического перерыва. По умолчанию — агент доступен сразу после входа	логин агента с состоянием "Недоступен" с одной из причин технического перерыва
Проверка sip регистрации при распределении (check_sip_reg_when_distribute)	boolean, по умолчанию false	если true, то при распределении вызова на оператора происходит проверка на наличие ТА у оператора, в случае если у оператора нет ТА, которым он мог бы принять звонок, то вызовы на него не распределяются, а на обзорной панели (dashboard) отображается надпись "Статус SIP-линии: не зарегистрирован" и появляется возможность "Проверить SIP-регистрацию". Если при проверке будет найден активный ТА, то оператор вновь сможет принимать вызовы
Проверка sip регистрации при входе (check_sip_reg_when_login)	boolean, по умолчанию false	если true, то при входе оператора в АРМ происходит проверка на наличие ТА у оператора, в случае если у оператора нет ТА, которым он мог бы принять звонок, то вызовы на него не распределяются, а на обзорной панели (dashboard) отображается надпись "Статус SIP-линии: не зарегистрирован" и появляется возможность "Проверить SIP-регистрацию". Если при проверке будет найден активный ТА, то оператор вновь сможет принимать вызовы
Описание (description)	строка	краткое описание агента
Имя агента (display_name)	строка	отображаемое имя агента
Время автоматического завершения сессии (force_logout_time)	HH:MM[SS]	время автоматического принудительного выхода из сессии. Если оператор в состоянии разговора, то выход произойдет после истечения указанного времени и завершения разговора
Группа (group)	строка, по умолчанию default	группа, к которой относится агент
integration\cis	<request_uri>	интеграция с корпоративной информационной системой (КИС). Подробнее в разделе "Интеграции Call-центра"
integration\confluence	string, по умолчанию не задано	ключ доступа (API key) пользователя Confluence
integration\redmine	<Login> <Password>	учетные данные пользователя Redmine: <Login> — имя учетной записи; <Password> — пароль учетной записи
integration\redmine\task\body	string, по умолчанию не задано	шаблон тела создаваемой задачи в Redmine при поступлении вызова в Сall-центр. Поддерживает макро-переменные аналогичные тем, что используются для переменной integration\redmine\task\subject
integration\redmine\task\project	string, по умолчанию не задано	имя Redmine проекта по умолчанию. В рамках указанного проекта будут создаваться задачи при поступлении вызова в Сall-центр
integration\redmine\task\subject	string, по умолчанию не задано	шаблон темы создаваемой задачи в Redmine при поступлении вызова в Сall-центр. Поддерживает макро-переменные (макро-переменные указываются через процент, например %CGPN.digits%). Возможные макро-переменные: CGPN.digits - номер вызывающего (А) абонента; CDPN.digits - номер вызываемого (Б) абонента; CGPN.display_name - имя вызывающего абонента; CDPN.display_name - имя вызываемого абонента; DATE - текущая дата; TIME - текущее время; AGENT_ID - идентификатор оператора, на которого распределился вызов; QUEUE_ID - имя очереди, через которую вызов распределился на агента Сall-центра (если вызов пришел напрямую на оператора, то данное поле будет пустым); WORKITEM_ID - внутренний идентификатор заявки в Сall-центре
integration\ssvs	<request_uri>	интеграция с системой голосового самообслуживания (СГС). Подробнее в разделе "Интеграции Call-центра"
LDAP имя (ldap_username)	строка	имя для авторизации в LDAP
Нагрузка (load)	положительное целое, по умолчанию 1	количество одновременных вызовов оператору
Одна сессия (only one session)	true/false, по умолчанию false	завершать активную сессию агента при подключении с другого рабочего места
Пароль (password)	строка, по умолчанию 1111	пароль для аутентификации, состоит из чисел и имеет длину не менее 4 и не более 12 символов
Перехват (pickup)	true/false, по умолчанию false	перехват прямого вызова в Сall-центре между операторами одной группы с активной опцией перехвата
Профиль (profile)	строка, по умолчанию default	выбор профиля с причинами технического перерыва
Умение (skills)	[skill[/subskill]:quality, ...]	список умений, который определяет способности и уровень квалификации оператора <police \| psychologie>(quality 0-100)
Супервизор (supervisor)	true/false, по умолчанию false	включение привилегий "супервизора", способность регистрироваться в АРМ супервизора и наблюдать за операторами в своей группы
Освобождение линии при несопровождаемом трансфере (transferor_line_force_termination)	true/false, по умолчанию false	позволяет агенту не дожидаться завершения перевода вызова, а сразу принимать новые звонки. При не успешном переводе, вызов не вернется агенту или в очередь.
Таймаут смены (мин) (working_timeout)	5-1440 мин. По умолчанию — 120	интервал времени, в течении которого агент не должен быть подключен к системе (logout), по истечению которого "смена" для статистики закрывается

Пример:

domain/test_domain/cc/agent/declare 503 group = default, skills = [fire:5], supervisor = true 
Agents declared:
503

clean

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

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

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

Синтаксис:

clean <AgentRange> <Property>

Параметры:

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

Пример:

/domain/test_domain/cc/agent/clean 502 skills 
ok
Configuration changes will be applied after re-login

info

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

Если в профиле безопасности (/system/security/profile/) параметр show_password_at_cli = off, то в выводе пароль скрывается, и вместо него показываются ********.

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

/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*" не будет являться корректным шаблоном.

Пример:

/domain/test_domain/cc/agent/info 500
┌─────┬──────────────────────────────────────────────────────────┐
│Agent│                        Properties                        │
├─────┼──────────────────────────────────────────────────────────┤
│500  │agent_id                          <<"500">>               │
│     │auto_complete                     true                    │
│     │auto_logout_timeout               5 min.                  │
│     │call_recording                    false                   │
│     │check_sip_reg_when_distribute     false                   │
│     │check_sip_reg_when_login          false                   │
│     │description                                               │
│     │display_name                                              │
│     │force_logout_time                 23:59                   │
│     │group                             default                 │
│     │load                              1                       │
│     │password                          1111                    │
│     │pickup                            false                   │
│     │profile                           default                 │
│     │skills                            medicine:5,psychologie:4│
│     │supervisor                        true                    │
│     │transferor_line_force_termination true                    │
│     │working_timeout                   120 min.                │
└─────┴──────────────────────────────────────────────────────────┘

list

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

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

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

Синтаксис:

list [ --password ]

Параметры:

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

Если в профиле безопасности (/system/security/profile/) параметр show_password_at_cli = off, то в выводе пароль скрывается, и вместо него показываются ********.

Пример:

/domain/test_domain/cc/agent/list --password                              
┌────────┬────────────┬───────┬──────────┬───────────────────┬────────┬────────┬────────┬───────┬────┬────────────────────────┐
│Agent id│Display name│ Group │Supervisor│    Description    │Password│  Auto  │Working │ Auto  │Load│         Skills         │
│        │            │       │          │                   │        │complete│timeout │logout │    │                        │
│        │            │       │          │                   │        │timeout │        │timeout│    │                        │
├────────┼────────────┼───────┼──────────┼───────────────────┼────────┼────────┼────────┼───────┼────┼────────────────────────┤
│500     │            │default│true      │Операторы 1-й линии│1111    │0       │120 min.│5 min. │1   │medicine:5,psychologie:4│
│501     │            │default│          │Операторы 1-й линии│1111    │0       │120 min.│inf    │1   │                        │
│502     │            │default│          │Операторы 1-й линии│1111    │0       │120 min.│inf    │1   │                        │
│504     │            │default│          │                   │1111    │0       │120 min.│inf    │1   │                        │
└────────┴────────────┴───────┴──────────┴───────────────────┴────────┴────────┴────────┴───────┴────┴────────────────────────┘

remove

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

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

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

Синтаксис:

remove <AgentRange>

Параметры:

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

Пример:

/domain/test_domain/cc/agent/remove 503
ok

set

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

Пароли проверяются на соответствие требованиям, установленным в профиле безопасности (/system/security/profile/), параметр restrictions.

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

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

Синтаксис:

set <AgentRange> <Property> <Value>

Параметры:

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

Пример:

/domain/test_domain/cc/agent/set 50{0-2} description "Операторы 1-й линии"
ok
Configuration changes will be applied after re-login

where

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

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

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

Синтаксис:

where <AgentId>

Параметры:

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

Пример:

/domain/test_domain/cc/agent/where 501
Queue1.