/domain/<DOMAIN>/cc/agent - команды управления агентами в Call-центре
В данном разделе описаны команды управления агентами в Call-центре.
declare
Команда позволяет создать агентов виртуального Сall-центра.
Путь команды:
/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 | период неактивности оператора, после которого осуществляется выход из сессии |
| Статус после входа (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-регистрацию", если при проверке будет найден активный ТА, то оператор вновь сможет принимать вызовы |
| Запись вызова (call_recording) | boolean, по умолчанию false | включена или нет запись разговора для агента. С ключом separated включается режим двухканальной записи (separated режим) |
| Описание (description) | строка | краткое описание агента |
| Имя агента (display_name) | строка | отображаемое имя агента |
Время автоматического завершения (force_logout_time) | HH:MM[SS] | время автоматического выхода из сессии. Если оператор в состоянии разговора, то выход после истечения указанного времени и завершении разговора |
| Группа (group) | строка, по умолчанию default | группа, к которой относится агент |
lLDAP имя (ldap_username) | строка | имя для авторизации в LDAP |
Нагрузка (load) | положительное целое | количество одновременных вызовов оператору |
| Пароль (password) | строка | пароль для аутентификации, состоит из чисел и имеет длину не менее 4 символов |
| Перехват (pickup) | true/false, по умолчанию false | перехват прямого вызова в Сall-центре |
| Умение (skills) | [skill[/subskill]:quality, ...] | список умений, который определяет способности и уровень квалификации оператора <police | psychologie>(quality 0-100) |
| Супервизор (supervisor) | true/false, по умолчанию false | включение привилегий "супервизора", способность регистрироваться в АРМ супервизора и наблюдать за операторами в своей группы |
| Профиль (profile) | строка, по умолчанию default | выбор профиля с причинами технического перерыва |
| Таймаут смены (мин) (working_timeout) | 5-1440 мин. По умолчанию — 120 | интервал времени, в течении которого агент должен быть не подключен к системе (logout), после которого "смена" для статистики закрывается |
| Одна сессия (only one session) | true/false, по умолчанию false | завершать активную сессию агента при подключении с другого рабочего места |
| integration\confluence | string, по умолчанию не задано | ключ доступа (API key) пользователя Confluence |
| integration\redmine | <Login> <Password> | учетные данные пользователя Redmine: |
| integration\redmine\task\project | string, по умолчанию не задано | имя Redmine проекта по умолчанию. В рамках указанного проекта будут создаваться задачи при поступлении вызова в КЦ |
| integration\redmine\task\subject | string, по умолчанию не задано | шаблон темы создаваемой задачи в Redmine при поступлении вызова в КЦ. Поддерживает макро-переменные (макро-переменные указываются через процент, например %CGPN.digits%). Возможные макро-переменные:
|
| integration\redmine\task\body | string, по умолчанию не задано | шаблон тела создаваемой задачи в Redmine при поступлении вызова в КЦ. Поддерживает макро-переменные аналогичные тем, что используются для переменной integration\redmine\task\subject |
| integration\cis | <request_uri> | интеграция с корпоративной информационной системой (КИС). Подробнее в разделе "Интеграции Call-центра" |
| integration\ssvs | <request_uri> | интеграция с системой голосового самообслуживания (СГС). Подробнее в разделе "Интеграции Call-центра" |
Пример:
admin@[ds1@ecss1#ECSS 010070]:/$ domain/eltex/cc/agent/declare 204 password = 1111, supervisor = true, group = sales, display_name = Валерий Agents declared: 204
clean
Команда позволяет очистить свойства определенных агентов виртуального Сall-центра.
Путь команды:
/domain/<DOMAIN>/cc/agent/clean
Синтаксис:
clean <AgentRange> <Property>
Параметры:
<AgentRange> — идентификатор агента или шаблон. Шаблон ag{1-20} задает список из 20 агентов: ag1, ag2, ..., ag20;
<Property> — имя свойства. В системе существует набор стандартных свойств (group, load и другое) и свойства, состоящие из нескольких слов, разделенных символом "\", в общем виде выглядят: "general\specific\private".
Пример:
admin@[ds1@ecss1#ECSS 010070]:/$ domain/eltex/cc/agent/clean 204 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*" не будет являться корректным шаблоном.
Пример:
admin@[ds1@ecss1#ECSS 010070]:/$ domain/preysman/cc/agent/info 202 ┌─────┬─────────────────────────────────────────────────┐ │Agent│ Properties │ ├─────┼─────────────────────────────────────────────────┤ │202 │agent_id <<"202">> │ │ │auto_complete_timeout 140 sec. │ │ │call_recording separated │ │ │check_sip_reg_when_distribute true │ │ │check_sip_reg_when_login true │ │ │description │ │ │display_name Сергей │ │ │force_logout_time 20:00 │ │ │group 100 │ │ │load 1 │ │ │login_timestamp 2024/09/09 11:01:58│ │ │last_logout_timestamp 2024/09/09 11:02:31│ │ │password 1111 │ │ │pickup false │ │ │profile default │ │ │shift_start_timestamp 2024/09/09 11:01:58│ │ │skills fire:20 │ │ │supervisor true │ │ │working_timeout 120 min. │ └─────┴─────────────────────────────────────────────────┘
list
Команда предназначена для просмотра списка агентов виртуального Сall-центра.
Путь команды:
/domain/<DOMAIN>/cc/agent/list
Синтаксис:
list [ --password ]
Параметры:
--password — показывать колонку password в результате команды, или нет. По умолчанию колонка не показывается.
Если в профиле безопасности (/system/security/profile/) параметр show_password_at_cli = off, то в выводе пароль скрывается, и вместо него показываются ********.
Пример:
admin@[ds1@ecss1#ECSS 010070]:/$ domain/eltex/cc/agent/list --password ┌────────┬────────────┬─────┬──────────┬───────────┬────────┬────────┬────────┬───────┬────┬──────────────────┐ │Agent id│Display name│Group│Supervisor│Description│Password│ Auto │Working │ Auto │Load│ Skills │ │ │ │ │ │ │ │complete│timeout │logout │ │ │ │ │ │ │ │ │ │timeout │ │timeout│ │ │ ├────────┼────────────┼─────┼──────────┼───────────┼────────┼────────┼────────┼───────┼────┼──────────────────┤ │204 │Валерий │sales│true │ │1111 │0 │120 min.│inf │1 │language/english:5│ │205 │ │sales│ │ │1111 │0 │120 min.│inf │1 │ │ │206 │ │sales│ │ │1111 │0 │120 min.│inf │1 │ │ │207 │ │sales│ │ │1111 │0 │120 min.│inf │1 │ │ │208 │ │sales│ │ │1111 │0 │120 min.│inf │1 │ │ │209 │ │sales│ │ │1111 │0 │120 min.│inf │1 │ │ └────────┴────────────┴─────┴──────────┴───────────┴────────┴────────┴────────┴───────┴────┴──────────────────┘
remove
Команда предназначена для удаления агентов виртуального Сall-центра.
Путь команды:
/domain/<DOMAIN>/cc/agent/remove
Синтаксис:
remove <AgentRange>
Параметры:
<AgentRange> — идентификатор агента или шаблон. Шаблон ag{1-20} задает список из 20 агентов: ag1, ag2, ..., ag20.
Пример:
admin@[ds1@ecss1#ECSS 010070]:/$ domain/eltex/cc/agent/remove 209 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> — значение, которое будет установлено свойству.
Пример:
admin@ds1@ecss1:/$ domain/eltex/cc/agent/set 20{5-8} description "Операторы 1-й линии"
ok
Configuration changes will be applied after re-login
where
Команда предназначена для списка очередей, к которым подключен агент.
Путь команды:
/domain/<DOMAIN>/cc/agent/where
Синтаксис:
where <AgentId>
Параметры:
<AgentId> — идентификатор агента.
Пример:
admin@[ds1@ecss1#ECSS 010070]:/$ domain/eltex/cc/agent/where 205 eltex_queue.