Перейти к содержанию

Сотрудники и сессии

Настройки сессий, статусов, профилей и списка сотрудников, назначения диалогов операторам, возможностей оператора в диалоге и информационных полей посетителя.

Как читать таблицы и редактировать значения, описано в разделе Настройки в 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_status B, у статуса 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
  }
}