Сотрудники и сессии
Настройки сессий, статусов, профилей и списка сотрудников, назначения диалогов операторам, возможностей оператора в диалоге и информационных полей посетителя.
Как читать таблицы и редактировать значения, описано в разделе Настройки в Constance.
Агенты и сессии
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
AGENT_SESSION_INACTIVITY_TIMEOUT |
Длительность | 00:00:00 |
Время бездействия сотрудника, после которого его сессия завершается и требуется повторный вход. Значение 0 отключает автоматическое завершение сессии.В интерфейсе: «Настройки» → «Общие» → «Безопасность». |
AGENT_SESSION_CHECK_PERIOD |
Длительность | 5 минут00:05:00 |
Интервал периодической проверки сессии сотрудника на сервере. Значение 0 отключает проверку. |
AGENT_ALIVE_TIMEOUT |
Длительность | 1 минута00:01:00 |
Время без сигналов от приложения сотрудника, после которого сотрудник считается отключившимся. |
AGENT_DEVICE_WATCHDOG_DB_WRITE_INTERVAL |
Длительность | 5 минут00:05:00 |
Служебная настройка производительности. Минимальный интервал между записями в базу данных о том, что устройство сотрудника на связи; в Redis отметка обновляется при каждом сигнале. |
AGENT_DEVICE_WATCHDOG_DB_TIMEOUT |
Длительность | 10 минут00:10:00 |
Служебная настройка производительности. Срок, через который устройство сотрудника без сигналов считается отключившимся по данным базы данных. Значение должно быть не меньше удвоенного AGENT_DEVICE_WATCHDOG_DB_WRITE_INTERVAL. |
AGENT_LIST_PER_PAGE_LIMIT |
Целое число | 100 | Количество сотрудников на одной странице списка сотрудников. |
AGENT_LIST_PAGING_LIMIT |
Целое число | 100 | Максимальное количество сотрудников в одном ответе API при постраничной выборке со смещением (offset). |
USE_SQL_AGENT_READ_FILTER |
Логический | Включено | Служебная настройка. Проверяет права на просмотр сотрудников запросом к базе данных, а не перебором в приложении. Выключайте только по рекомендации технической поддержки Webim. |
MAX_CHATS_PER_OPERATOR |
Целое число | 5 | Максимальное количество диалогов, которые автоматически назначаются одному оператору одновременно. Целое число больше 0. Личный лимит, заданный в профиле сотрудника, имеет приоритет над этой настройкой. В интерфейсе: «Настройки» → «Общие» → «Распределение чата». |
MULTIPLE_SET_MAX_CHATS |
Логический | Выключено | Разрешает массово задавать максимальное количество диалогов сотрудникам, отмеченным флажками в списке сотрудников. |
RESTRICTED_PROFILES |
Логический | Выключено | Запрещает сотрудникам с ролями «Супервизор» и «Оператор» редактировать собственный профиль. В интерфейсе настройка называется «Ограничить редактирование профиля». В интерфейсе: «Настройки» → «Общие» → «Возможности». |
OPERATOR_CHECK_STATUS_ONLINE |
Целое число | 300 | Период в секундах, с которым виджет посетителя проверяет, есть ли операторы онлайн. |
OPERATOR_FILE_UPLOAD_DISABLE |
Логический | Выключено | Запрещает операторам отправлять файлы посетителям. Зависит от тарифной возможности operator_file_upload: без неё действует значение «Включено». |
MANUAL_OPERATOR_ASSIGN |
Логический | Выключено | Разрешает при переводе диалога выбрать конкретного оператора, за которым диалог будет закреплён. |
OPERATOR_NOTE_MESSAGES |
Логический | Выключено | Разрешает операторам оставлять в диалоге заметки, которые не видны посетителю. |
OPERATOR_CLOSED_CHAT_MESSAGE_FOR_OPERATOR_ONLY |
Логический | Выключено | Показывает сообщение о закрытии диалога оператором только сотрудникам; посетитель его не видит. |
STATUS_FOR_BUSY_OPERATOR |
Строка | invisible |
Статус, в который переводится оператор, не ответивший в диалоге за отведённое время (при включённой настройке UNASSIGN_CHAT_IF_OPERATOR_BUSY). Допустимые значения — коды статусов оператора, например invisible или offline. |
UNASSIGN_CHAT_IF_OPERATOR_BUSY |
Логический | Включено | Снимает назначение диалога с оператора, который долго не отвечает, и пытается назначить диалог другому оператору. Неответившего оператора переводит в статус из STATUS_FOR_BUSY_OPERATOR. Сроки задаются тайм-аутами AGENT_CANT_PICK_TIMEOUT и AGENT_BUSY_TIMEOUT.В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». |
OPERATOR_STATUS_TIMER |
Логический | Выключено | Показывает рядом со статусом оператора продолжительность пребывания в текущем статусе. |
AGENT_STATUS_CONFIG |
JSON-объект | См. Формат AGENT_STATUS_CONFIG | Конфигурация статусов оператора: порядок, видимость, собственные статусы и автоматический переход в другой статус. Пустое значение — используется стандартный набор статусов. Формат описан в разделе Формат AGENT_STATUS_CONFIG. |
AVAILABLE_AGENT_STATUSES |
Список строк | См. ниже | Статусы оператора, доступные в тарифе. Статусы, которых нет в списке, не показываются в списке выбора статуса. Допустимые элементы: online, invisible, on_call, dinner, pre_dinner, private_break, coaching_break, technical_break, meeting_break, short_break, offline_processing, service, offline. |
SHOW_OPERATOR_SEND_CHAT_TO_EMAIL_BUTTON |
Логический | Включено | Показывает оператору кнопку отправки истории диалога на электронную почту. |
ADDITIONAL_AGENT_INFO |
Логический | Выключено | Включает редактирование дополнительной информации о сотруднике в карточке сотрудника и в настройках размещения. |
OPERATOR_WEBSOCKETS |
Логический | Выключено | Включает получение обновлений в приложении оператора через веб-сокеты. |
OPERATOR_CHAT |
Логический | Выключено | Устаревшая настройка. Доступность чата между сотрудниками определяется тарифной опцией. |
SHOW_REQUEST_CONTACTS_BUTTON |
Логический | Включено | Показывает в диалоге кнопку «Запросить контакты». |
VISITOR_ATTRIBUTES |
JSON-объект | См. ниже | Набор информационных полей посетителя, которые показываются оператору. Действует при включённой настройке VISITOR_ATTRIBUTES_ENABLED; поле, отсутствующее в наборе, в РМО не показывается.Формат: объект, где ключ — код поля, а значение — {"default": true, "is_visible": true} для стандартного поля или {"name": "Название", "is_visible": true} для собственного поля.В интерфейсе: «Настройки» → «Общие» → «Атрибуты посетителя». |
VISITOR_ATTRIBUTES_ENABLED |
Логический | Выключено | Включает настройку состава информационных полей посетителя в РМО по VISITOR_ATTRIBUTES.В интерфейсе: «Настройки» → «Общие» → «Атрибуты посетителя». |
Формат AGENT_STATUS_CONFIG
Настройка задаёт набор статусов оператора и их порядок. Если значение не задано или список statuses пуст, используется стандартный набор статусов. Собственные статусы, созданные на вкладке «Статусы», добавляются к набору автоматически. Стандартные статусы, не входящие в AVAILABLE_AGENT_STATUSES, операторам не показываются.
Пример:
{
"statuses": [
{"value": "online"},
{"value": "pre_dinner", "next_status": "dinner"},
{"value": "dinner"},
{"value": "training", "name": {"ru": "Обучение", "en": "Training"}, "color": "#4FCAFF"},
{"value": "offline"}
]
}
| Поле | Тип | Описание |
|---|---|---|
value |
Строка | Код статуса: стандартный или собственный (строчные латинские буквы и _). Обязательное поле. |
name |
Строка или объект | Название статуса: строка или объект с переводами, например {"ru": "Обучение", "en": "Training"}. Обязательно для собственного статуса. |
color |
Строка | Цвет статуса в формате #RRGGBB. Обязателен для собственного статуса. |
next_status |
Строка | Статус, в который оператор автоматически переходит, когда у него не остаётся активных диалогов. |
accept_chats |
Логический | Назначаются ли оператору диалоги в этом статусе. По умолчанию false. Для online всегда true, для offline всегда false; для этих статусов поле задавать нельзя. |
sort_order |
Целое число | Порядок статуса в списке выбора. |
Стандартные статусы:
| Код | Название | Особенности |
|---|---|---|
online |
Онлайн | Обязательный статус, диалоги назначаются. |
invisible |
Невидимка | |
on_call |
На телефоне | Устанавливается системой. |
dinner |
Обед | |
pre_dinner |
Перед обедом | Автоматически переходит в dinner. |
private_break |
Личный перерыв | |
coaching_break |
На проведении инструктажа | |
technical_break |
Технический перерыв | |
meeting_break |
На встрече | |
short_break |
Короткий перерыв | |
offline_processing |
Обработка офлайн-обращений | |
service |
Служебный | |
offline |
Офлайн | Обязательный статус. |
Правила проверки конфигурации:
-
коды статусов не повторяются;
-
статусы
onlineиofflineобязательны; -
next_statusссылается на статус из того же списка и не на сам статус; -
цепочки переходов запрещены: если у статуса A указан
next_statusB, у статуса B не должно бытьnext_status.
Если конфигурация нарушает правила, она не применяется целиком: используется стандартный набор статусов, а ошибка записывается в журнал сервера.
Значения по умолчанию
Значения по умолчанию, которые не поместились в таблицы.
AVAILABLE_AGENT_STATUSES
[
"online", "invisible", "dinner", "pre_dinner", "private_break",
"coaching_break", "technical_break", "meeting_break", "short_break",
"offline_processing", "offline"
]
VISITOR_ATTRIBUTES
{
"comment": {
"default": true,
"is_visible": true
},
"ip": {
"default": true,
"is_visible": true
},
"address": {
"default": true,
"is_visible": true
},
"site_url": {
"default": true,
"is_visible": true
},
"referer_marks": {
"default": true,
"is_visible": true
},
"id": {
"default": true,
"is_visible": true
},
"vk_profile_url": {
"default": true,
"is_visible": true
},
"accountname": {
"default": true,
"is_visible": true
},
"platform": {
"default": true,
"is_visible": true
},
"tin": {
"default": true,
"is_visible": true
},
"telegram_profile_url": {
"default": true,
"is_visible": true
},
"email": {
"default": true,
"is_visible": true
},
"location": {
"default": true,
"is_visible": true
},
"channel_user_id": {
"default": true,
"is_visible": true
},
"account_id": {
"default": true,
"is_visible": true
},
"company": {
"default": true,
"is_visible": true
},
"crm_url": {
"default": true,
"is_visible": true
},
"phone": {
"default": true,
"is_visible": true
},
"referer": {
"default": true,
"is_visible": true
},
"codeword": {
"default": true,
"is_visible": true
},
"profile_url": {
"default": true,
"is_visible": true
},
"info": {
"default": true,
"is_visible": true
},
"landing_page": {
"default": true,
"is_visible": true
},
"name": {
"default": true,
"is_visible": true
},
"login": {
"default": true,
"is_visible": true
},
"browser": {
"default": true,
"is_visible": true
},
"first_custom_field": {
"default": true,
"is_visible": true
},
"second_custom_field": {
"default": true,
"is_visible": true
},
"third_custom_field": {
"default": true,
"is_visible": true
},
"avito_ad_url": {
"default": true,
"is_visible": true
},
"max_chat_id": {
"default": true,
"is_visible": true
},
"language": {
"default": true,
"is_visible": true
},
"status_message": {
"default": true,
"is_visible": true
}
}