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

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

Как читать таблицы и редактировать значения, описано в разделе [Настройки в Constance](https://webim.ru/kb/11.0/settings/constance/).

## Агенты и сессии { #agents-sessions }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `AGENT_SESSION_INACTIVITY_TIMEOUT` | Длительность | `00:00:00` | Время бездействия сотрудника, после которого его сессия завершается и требуется повторный вход. Значение `0` отключает автоматическое завершение сессии.<br>В интерфейсе: «Настройки» → «Общие» → «Безопасность». |
| `AGENT_SESSION_CHECK_PERIOD` | Длительность | 5 минут<br>`00:05:00` | Интервал периодической проверки сессии сотрудника на сервере. Значение `0` отключает проверку. |
| `AGENT_ALIVE_TIMEOUT` | Длительность | 1 минута<br>`00:01:00` | Время без сигналов от приложения сотрудника, после которого сотрудник считается отключившимся. |
| `AGENT_DEVICE_WATCHDOG_DB_WRITE_INTERVAL` | Длительность | 5 минут<br>`00:05:00` | Служебная настройка производительности. Минимальный интервал между записями в базу данных о том, что устройство сотрудника на связи; в Redis отметка обновляется при каждом сигнале. |
| `AGENT_DEVICE_WATCHDOG_DB_TIMEOUT` | Длительность | 10 минут<br>`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. Личный лимит, заданный в профиле сотрудника, имеет приоритет над этой настройкой.<br>В интерфейсе: «Настройки» → «Общие» → «Распределение чата». |
| `MULTIPLE_SET_MAX_CHATS` | Логический | Выключено | Разрешает массово задавать максимальное количество диалогов сотрудникам, отмеченным флажками в списке сотрудников. |
| `RESTRICTED_PROFILES` | Логический | Выключено | Запрещает сотрудникам с ролями «Супервизор» и «Оператор» редактировать собственный профиль. В интерфейсе настройка называется «Ограничить редактирование профиля».<br>В интерфейсе: «Настройки» → «Общие» → «Возможности». |
| `OPERATOR_CHECK_STATUS_ONLINE` | Целое число | 300 | Период в секундах, с которым виджет посетителя проверяет, есть ли операторы онлайн. |
| `OPERATOR_FILE_UPLOAD_DISABLE` | Логический | Выключено | Запрещает операторам отправлять файлы посетителям.<br>Зависит от тарифной возможности `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`.<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». |
| `OPERATOR_STATUS_TIMER` | Логический | Выключено | Показывает рядом со статусом оператора продолжительность пребывания в текущем статусе. |
| `AGENT_STATUS_CONFIG` | JSON-объект | См. [Формат AGENT_STATUS_CONFIG](#agent-status-config) | Конфигурация статусов оператора: порядок, видимость, собственные статусы и автоматический переход в другой статус. Пустое значение — используется стандартный набор статусов. Формат описан в разделе [Формат AGENT_STATUS_CONFIG](#agent-status-config). |
| `AVAILABLE_AGENT_STATUSES` | Список строк | См. [ниже](#default-available-agent-statuses) | Статусы оператора, доступные в тарифе. Статусы, которых нет в списке, не показываются в списке выбора статуса.<br>Допустимые элементы: `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-объект | См. [ниже](#default-visitor-attributes) | Набор информационных полей посетителя, которые показываются оператору. Действует при включённой настройке `VISITOR_ATTRIBUTES_ENABLED`; поле, отсутствующее в наборе, в РМО не показывается.<br>Формат: объект, где ключ — код поля, а значение — `{"default": true, "is_visible": true}` для стандартного поля или `{"name": "Название", "is_visible": true}` для собственного поля.<br>В интерфейсе: «Настройки» → «Общие» → «Атрибуты посетителя». |
| `VISITOR_ATTRIBUTES_ENABLED` | Логический | Выключено | Включает настройку состава информационных полей посетителя в РМО по `VISITOR_ATTRIBUTES`.<br>В интерфейсе: «Настройки» → «Общие» → «Атрибуты посетителя». |

## Формат AGENT_STATUS_CONFIG { #agent-status-config }

Настройка задаёт набор статусов оператора и их порядок. Если значение не задано или список `statuses` пуст, используется стандартный набор статусов. Собственные статусы, созданные на вкладке «Статусы», добавляются к набору автоматически. Стандартные статусы, не входящие в `AVAILABLE_AGENT_STATUSES`, операторам не показываются.

Пример:

```json
{
  "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`.

Если конфигурация нарушает правила, она не применяется целиком: используется стандартный набор статусов, а ошибка записывается в журнал сервера.

## Значения по умолчанию { #defaults }

Значения по умолчанию, которые не поместились в таблицы.

### AVAILABLE_AGENT_STATUSES { #default-available-agent-statuses }

```json
[
  "online", "invisible", "dinner", "pre_dinner", "private_break",
  "coaching_break", "technical_break", "meeting_break", "short_break",
  "offline_processing", "offline"
]
```

### VISITOR_ATTRIBUTES { #default-visitor-attributes }

```json
{
  "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
  }
}
```

---

Источник: https://webim.ru/kb/11.0/settings/constance/agents.html
