# Диалоги

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

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

## Диалоги { #chats }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `AUTO_ASSIGN` | Логический | Включено | Включает автоматическое назначение диалогов из очереди на операторов. |
| `AUTO_ASSIGN_PRIORITY_BY_OPERATOR_ORDER` | Логический | Выключено | При равной загрузке операторов выбирает оператора по порядку сортировки сотрудников, а не случайно.<br>В интерфейсе: «Настройки» → «Общие» → «Распределение чата». |
| `AUTO_ASSIGN_PRIORITY_BY_LAST_CHAT_ASSIGNED_TS` | Логический | Выключено | При автоматическом назначении выбирает оператора, которому диалог назначался раньше остальных.<br>В интерфейсе: «Настройки» → «Общие» → «Распределение чата». |
| `AUTO_ASSIGN_TO_LAST_CHAT_OPERATOR` | Логический | Включено | Назначает диалог на оператора, с которым у посетителя был предыдущий диалог, если этот оператор доступен.<br>В интерфейсе: «Настройки» → «Общие» → «Распределение чата». |
| `AUTO_ASSIGN_TO_LAST_CHAT_OPERATOR_IF_BUSY` | Логический | Выключено | Назначает диалог на оператора, с которым у посетителя был предыдущий диалог, даже если оператор занят.<br>В интерфейсе: «Настройки» → «Общие» → «Распределение чата». |
| `ROUTE_INTERACTIONS_INTERVAL` | Длительность | 1 минута<br>`00:01:00` | Интервал периодической маршрутизации неназначенных диалогов из очереди. |
| `ROUTE_INTERACTIONS_BATCH_LIMIT` | Целое число | 2000 | Служебная настройка производительности. Максимальное количество диалогов очереди, обрабатываемых за один проход маршрутизации. |
| `CHAT_INTERCEPT` | Логический | Включено | Разрешает операторам перехватывать диалоги у других операторов. |
| `OPERATOR_CLOSES_CHAT_FINALLY` | Логический | Выключено | Закрывает диалог окончательно сразу после закрытия оператором, не дожидаясь закрытия посетителем.<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». |
| `CATEGORY_MANDATORY` | Логический | Выключено | Требует указать категорию диалога перед его закрытием.<br>В интерфейсе: «Настройки» → «Общие» → «Категории». Зависит от тарифной возможности `categories`: без неё действует значение «Выключено». Можно переопределить в настройках отдела. |
| `CATEGORIES_COUNT_LIMIT` | Целое число | 1 | Максимальное количество категорий, которые можно назначить одному диалогу. Значение `0` снимает ограничение.<br>В интерфейсе: «Настройки» → «Общие» → «Категории». Зависит от тарифной возможности `categories`: без неё действует значение `1`. |
| `CATEGORY_SELECTION_WITH_ONE_CLICK` | Логический | Включено | Позволяет выбрать единственную категорию одним щелчком.<br>В интерфейсе: «Настройки» → «Общие» → «Категории». Зависит от тарифной возможности `categories`: без неё действует значение «Включено». |
| `CATEGORIES_DEFAULT_VISIBLE` | Логический | Включено | Показывает в РМО категории, для которых в отделе не настроена видимость.<br>В интерфейсе: «Настройки» → «Общие» → «Категории». Можно переопределить в настройках отдела. |
| `WRITE_CATEGORIES_IN_ONE_LINE_IN_INFO_MESSAGE` | Логический | Выключено | Выводит установленные в диалоге категории одной строкой в информационном сообщении. |
| `CHANGE_DEPARTMENT_ON_FORWARD_TO_AGENT` | Логический | Включено | При переводе диалога на оператора проверяет, состоит ли оператор в отделе диалога. Если нет — переводит диалог в первый по порядку сортировки отдел нового оператора, а если оператор не состоит ни в одном отделе — в «Без отдела». |
| `ALLOW_AGENT_REDIRECT_CHAT_TO_OFFLINE_DEPARTMENTS` | Логический | Выключено | Разрешает переводить диалоги в отделы, в которых нет операторов онлайн. |
| `HISTORY_COLUMNS` | Строка (JSON-массив) | `[]` | Набор системных колонок страницы истории диалогов в виде JSON-массива ключей колонок. Значение `[]` — стандартный набор. Заполняется при настройке колонок на странице истории. |
| `SHOWN_ENTITY_LIST_LIMITS` | JSON-объект | `{"agents_limit": 10, "departments_limit": 10}` | Количество операторов и отделов, показываемых в списке при переводе диалога и отправке диалога на почту.<br>Формат: `{"agents_limit": 10, "departments_limit": 10}`, значения — целые числа не меньше 1. |
| `FORCE_START_CHAT_ON_VISITOR_MESSAGE` | Логический | Включено | Начинает диалог, если от посетителя пришло сообщение, а диалога нет. Полезно для мобильных приложений: диалог начинается независимо от статуса «офлайн», первого вопроса или выбора отдела. |
| `ACTIVE_INTERACTION_CACHE_ENABLED` | Логический | Включено | Служебная настройка производительности. Кэширует в Redis идентификатор активного диалога посетителя при обработке входящих сообщений. Выключайте только по рекомендации технической поддержки **Webim**. |
| `OFFLINE_CHAT_PROCESSING` | Логический | Включено | Включает обработку операторами сообщений, оставленных посетителями в офлайн-режиме.<br>Зависит от тарифной возможности `offline_message`: без неё действует значение «Выключено». |
| `ENABLE_OFFLINE_QUEUE` | Логический | Выключено | Включает отдельную очередь офлайн-обращений: отдельный раздел в РМО, статус оператора «Обработка офлайн-обращений» и учёт офлайн-обращений в статистике. Офлайн-обращения назначаются, когда в онлайн-очереди нечего назначать. При выключенной настройке все обращения находятся в общей очереди. |
| `ENABLE_OFFLINE_CHATS_FOR_CHANNELS` | Логический | Выключено | Разрешает создавать офлайн-обращения в каналах общения. При выключенной настройке все новые обращения из каналов создаются как онлайн-диалоги. |
| `ENABLE_OFFLINE_CHATS_FOR_MOBILE` | Логический | Выключено | Разрешает создавать офлайн-обращения из мобильных приложений. При выключенной настройке посетитель мобильного приложения считается онлайн, пока у устройства есть действующий токен пуш-уведомлений. |
| `QUEUE_LIMIT` | Целое число или пусто | Не задано | Максимальная длина очереди диалогов. Пустое значение — без ограничения. При включённой настройке `ENABLE_OFFLINE_QUEUE` ограничение применяется отдельно к онлайн- и офлайн-очереди.<br>В интерфейсе: «Настройки» → «Общие» → «Распределение чата». Зависит от тарифной возможности `visitor_queue_limit`: без неё ограничение не применяется. |
| `FORCE_ONLINE` | Логический | Выключено | Показывает аккаунт в статусе «онлайн» независимо от статусов операторов, заполненности очередей и других условий. |
| `OFFLINE_INSTEAD_OF_BUSY_ONLINE` | Логический | Выключено | Переводит кнопку виджета в режим «офлайн», если онлайн-очередь заполнена. |
| `CHATTING_TIMER` | Логический | Выключено | Включает таймер продолжительности разговора в РМО. |
| `SHOW_CHATTING_TIMER_IN_SETTINGS` | Логический | Выключено | Показывает в настройках аккаунта переключатель таймера продолжительности разговора (`CHATTING_TIMER`). |
| `MASS_CLOSE_CHATS_ENABLED` | Логический | Включено | Включает массовое закрытие диалогов. |
| `MAX_DEPARTMENT_IDS` | Целое число | 100 | Максимальное количество отделов в фильтре массового закрытия диалогов. |
| `MAX_CLOSE_CHATS_IDS` | Целое число | 10 000 | Максимальное количество идентификаторов диалогов в фильтре массового закрытия. |
| `MAX_CLOSE_CHATS_TOTAL` | Целое число | 0 | Максимальное количество диалогов, закрываемых за один запуск массового закрытия. Значение `0` снимает ограничение. |
| `CLOSE_CHATS_BATCH_SIZE` | Целое число | 500 | Служебная настройка производительности. Количество диалогов в одном пакете обработки при массовом закрытии. |
| `DISCONNECT_AGENTS_BATCH_SIZE` | Целое число | 100 | Служебная настройка производительности. Количество операторов в одном пакете обработки при массовом отключении. |
| `BATCH_CHAT_CLOSING_NOTIFICATION_TEXT` | Строка | Пусто | Текст системного сообщения посетителю при массовом закрытии диалога с уведомлением. Если значение пустое, отправляется стандартный текст о закрытии диалога оператором. |
| `ROUTING_PROFILE_ENABLED` | Логический | Выключено | Диагностическая настройка. Записывает в журнал длительность этапов автоматического назначения диалогов. Включайте временно для поиска узких мест под нагрузкой. |
| `LAST_MESSAGE_SEND_KEYBOARD_LIMIT` | Целое число | 1 | Максимальное количество отправок кнопок «Продолжить» и «Завершить чат» в одном диалоге. Значение `0` отключает кнопки.<br>Можно переопределить в настройках отдела. |
| `LAST_MESSAGE_MAIN_SETTING` | Логический | Выключено | Разрешает оператору отправлять из РМО «последнее сообщение» — клавиатуру с кнопками «Продолжить» и «Завершить чат». |

## Таймауты диалогов { #chat-timeouts }

Тайм-ауты назначения, ожидания и закрытия диалогов, а также связанные с ними индикаторы в РМО. Тайм-ауты ботов описаны в разделе [Боты](https://webim.ru/kb/11.0/settings/constance/channels-bots.html#bots).

Значение `00:00:00` отключает тайм-аут. Исключения:

  * тайм-ауты с типом «Длительность, не менее 1 с» обязательны, отключить их нельзя;

  * при нулевом значении `CHAT_SWITCH_TO_OFFLINE_TIMEOUT` посетитель считается офлайн сразу после ухода с сайта.

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `AGENT_CANT_PICK_TIMEOUT` | Длительность | `00:00:00` | Время, за которое назначенный оператор должен принять диалог. Если оператор не принял диалог, назначение снимается (при включённой настройке `UNASSIGN_CHAT_IF_OPERATOR_BUSY`).<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела. |
| `AGENT_CANT_PICK_HOLDING_MESSAGE_TIMEOUT` | Длительность | `00:00:00` | Время после назначения непринятого диалога, через которое посетителю отправляется сообщение с просьбой подождать.<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела. |
| `AGENT_BUSY_TIMEOUT` | Длительность | `00:00:00` | Время, за которое оператор должен ответить на непрочитанное сообщение посетителя. Если оператор не ответил, назначение снимается (при включённой настройке `UNASSIGN_CHAT_IF_OPERATOR_BUSY`).<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела. |
| `AGENT_BUSY_HOLDING_MESSAGE_TIMEOUT` | Длительность | `00:00:00` | Время с момента непрочитанного оператором сообщения, через которое посетителю отправляется сообщение с просьбой подождать.<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела. |
| `TIMEOUT_RETURN_TO_QUEUE_AFTER_NOT_ANSWERED_VISITOR_MESSAGE` | Длительность | `00:00:00` | Время, через которое диалог возвращается в очередь, если оператор прочитал последнее сообщение посетителя, но не ответил.<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела. |
| `CONTACT_REQUEST_FOR_QUEUE_TIMEOUT` | Длительность | 5 минут<br>`00:05:00` | Время ожидания в очереди или после назначения, через которое у посетителя запрашиваются контактные данные (при включённой настройке `AUTO_CONTACT_REQUEST_FOR_WAITING_TOO_LONG`).<br>Можно переопределить в настройках отдела. |
| `TIMEOUT_FOR_CHAT_AUTO_CLOSE_IF_CLOSED_BY_OPERATOR` | Длительность, не менее 1 с | 1 час<br>`01:00:00` | Время, через которое диалог, закрытый оператором, закрывается окончательно. Отключить тайм-аут нельзя.<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела. |
| `TIMEOUT_FOR_CHAT_AUTO_CLOSE_IF_CHAT_IS_INACTIVE` | Длительность, не менее 1 с | 1 час<br>`01:00:00` | Время без активности в диалоге, по истечении которого посетителю отправляется предупреждение и диалог закрывается. Отключить тайм-аут нельзя.<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела. |
| `AUTO_CLOSE_INACTIVE_TO_CLOSED_BY_OPERATOR` | Логический | Выключено | По тайм-ауту неактивности переводит диалог в состояние «закрыт оператором», а не закрывает его окончательно. Окончательное закрытие затем выполняется по тайм-ауту `TIMEOUT_FOR_CHAT_CLOSE_FINALLY_AFTER_CLOSE_BY_INACTIVE_TIMEOUT`, а если он равен `0` — по `TIMEOUT_FOR_CHAT_AUTO_CLOSE_IF_CLOSED_BY_OPERATOR`.<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела. |
| `TIMEOUT_FOR_CHAT_CLOSE_FINALLY_AFTER_CLOSE_BY_INACTIVE_TIMEOUT` | Длительность | `00:00:00` | Время окончательного закрытия диалога, переведённого в состояние «закрыт оператором» по тайм-ауту неактивности (см. `AUTO_CLOSE_INACTIVE_TO_CLOSED_BY_OPERATOR`).<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела. |
| `CHAT_UNASSIGN_FROM_OFFLINE_OPERATORS_TIMEOUT` | Длительность | 10 минут<br>`00:10:00` | Время, через которое с оператора, находящегося офлайн, снимается назначение диалога.<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела. |
| `FIRST_WAITING_QUEUE_TIME_NOTIFY_TIMEOUT` | Длительность | `00:00:00` | Время ожидания в очереди, через которое посетителю отправляется первое сообщение о времени ожидания.<br>Можно переопределить в настройках отдела. |
| `SECOND_WAITING_QUEUE_TIME_NOTIFY_TIMEOUT` | Длительность | `00:00:00` | Время ожидания в очереди, через которое посетителю отправляется второе сообщение о времени ожидания.<br>Можно переопределить в настройках отдела. |
| `TIMEOUT_CENTER_WATCHDOG_USE_DATABASE` | Логический | Выключено | Служебная настройка. Сохраняет задания отслеживания тайм-аутов не только в Redis, но и в базе данных. При выключенной настройке и потере данных Redis короткие тайм-ауты могут срабатывать с опозданием до 5 минут. Включите, если точность тайм-аутов критична. |
| `SHOW_AUTO_CLOSE_CHAT_INFO_MESSAGES` | Логический | Включено | Включает служебные сообщения при закрытии диалога по неактивности. |
| `SHOW_CHAT_COUNTDOWN_TIMER` | Логический | Выключено | Показывает в РМО обратный отсчёт до автоматического закрытия диалога после сообщения оператора и время, прошедшее после сообщения посетителя. |
| `WAITING_TIMER_ONLY_UNTIL_ACCEPT` | Логический | Выключено | Скрывает таймер ожидания на карточке диалога в РМО после того, как оператор принял диалог. |
| `UNREAD_CHAT_TURN_RED_ENABLED` | Логический | Выключено | Включает подсветку диалогов без ответа: карточка в списке РМО мигает красным, если посетитель написал, а оператор не ответил за время `UNREAD_CHAT_TURN_RED`. После изменения настройки операторам нужно обновить страницу РМО. |
| `UNREAD_CHAT_TURN_RED` | Целое число | 300 | Время в секундах до начала мигания карточки диалога (см. `UNREAD_CHAT_TURN_RED_ENABLED`). Отсчёт идёт с последнего сообщения посетителя в диалоге, который уже в работе у оператора; подсветка появляется с задержкой до 30 секунд. Значение `0` отключает подсветку. |
| `DOES_VISITOR_TYPING_UPDATE_TIMEOUTS` | Логический | Включено | Сбрасывает отсчёт тайм-аутов неактивности, пока посетитель набирает сообщение. |
| `DOES_OPERATOR_TYPING_UPDATE_TIMEOUTS` | Логический | Включено | Сбрасывает отсчёт тайм-аутов неактивности, пока оператор набирает сообщение. |
| `CHAT_SWITCH_TO_OFFLINE_TIMEOUT` | Длительность | 1 минута<br>`00:01:00` | Время с момента ухода посетителя с сайта, по истечении которого посетитель считается офлайн. |
| `SECONDS_BEFORE_VISITOR_MISSED` | Длительность | `00:00:00` | Если посетитель закрывает диалог раньше этого времени, обращение учитывается как отказ, а не как пропущенное.<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». |

## Удержание чатов { #chat-retention }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `CHATS_ON_HOLD` | Логический | Включено | Разрешает операторам ставить диалоги на удержание.<br>Зависит от тарифной возможности `chats_on_hold`: без неё действует значение «Выключено». |
| `CHATS_ON_HOLD_LIMIT` | Целое число | 5 | Максимальное количество диалогов, которые оператор может одновременно держать на удержании.<br>В интерфейсе: «Настройки» → «Общие» → «Возможности». |
| `CHATS_ON_HOLD_RELEASE_TIMEOUT` | Длительность, не менее 1 с | 10 минут<br>`00:10:00` | Время, через которое диалог на удержании автоматически возвращается в работу. Отключить тайм-аут нельзя.<br>В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела. |

## Скрытие чатов { #chat-hiding }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `CHAT_HIDING_ENABLED` | Логический | Выключено | Разрешает операторам скрывать диалоги из РМО. |
| `CHAT_HIDING_INACTIVITY_TIMEOUT` | Длительность | 10 минут<br>`00:10:00` | Время бездействия в скрытом диалоге, после которого посетителю отправляется сообщение проверки активности.<br>Можно переопределить в настройках отдела. |
| `CHAT_HIDING_CLOSURE_TIMEOUT` | Длительность | 10 минут<br>`00:10:00` | Время после сообщения проверки активности, по истечении которого неактивный скрытый диалог закрывается.<br>Можно переопределить в настройках отдела. |
| `CHAT_HIDING_AUTO_CLOSING_VISITOR_PHRASES` | Список строк | `[]` | Фразы посетителя, после которых скрытый диалог закрывается автоматически.<br>Пример: `["Спасибо", "Вопрос решён"]`. |

## Закрытие диалогов сообщениями посетителей { #close-by-visitor-messages }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `AUTO_CLOSE_ON_VISITOR_PHRASE_ENABLED` | Логический | Выключено | Закрывает диалог после сообщения посетителя, совпадающего с одной из фраз `AUTO_CLOSE_ON_VISITOR_PHRASES`. |
| `AUTO_CLOSE_ON_VISITOR_PHRASES` | Список строк | `[]` | Фразы посетителя, после которых диалог закрывается автоматически.<br>Пример: `["Спасибо, вопросов больше нет"]`. |
| `AUTO_CLOSE_ON_VISITOR_PHRASE_DELAY` | Длительность | 2 секунды<br>`00:00:02` | Задержка закрытия диалога после получения от посетителя одной из фраз `AUTO_CLOSE_ON_VISITOR_PHRASES`. |

## Тексты и сообщения { #texts-messages }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `AVOID_STANDARD_WELCOME_MESSAGE` | Логический | Выключено | Отключает стандартное приветственное сообщение «Пожалуйста, подождите немного, к Вам присоединится оператор…». |
| `AVOID_OPERATOR_JOINED_CHAT_MESSAGE` | Логический | Выключено | Отключает сообщения о том, что оператор включился в разговор, и о передаче диалога другому оператору. |
| `SHOW_CHAT_DEPARTMENT_INFO_MESSAGES` | Логический | Выключено | Включает служебные сообщения при переводе диалога в другой отдел и получении диалога. |
| `SHOW_AUTO_CLOSE_CHAT_INFO_MESSAGES` | Логический | Включено | Включает служебные сообщения при закрытии диалога по неактивности. |
| `MESSAGE_RESOURCES_TO_HIDE` | Список строк | `[]` | Коды системных сообщений, которые не показываются в диалоге.<br>Пример: `["chat.message.visitor_closed_chat", "chat.message.visitor_reopened_chat", "chat.message.visited_page"]`.<br>В интерфейсе: «Настройки» → «Общие» → «Автосообщения». Можно переопределить в настройках отдела. |
| `VISITOR_MESSAGES_NOT_REQUIRING_RESPONSE` | Список строк | `[]` | Сообщения посетителя, которые не переоткрывают диалог, закрытый оператором.<br>Пример: `["Спасибо", "Ок"]`.<br>В интерфейсе: «Настройки» → «Общие» → «Разное». |

---

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