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

Диалоги

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

Как читать таблицы и редактировать значения, описано в разделе Настройки в Constance.

Диалоги

Параметр Тип По умолчанию Описание
AUTO_ASSIGN Логический Включено Включает автоматическое назначение диалогов из очереди на операторов.
AUTO_ASSIGN_PRIORITY_BY_OPERATOR_ORDER Логический Выключено При равной загрузке операторов выбирает оператора по порядку сортировки сотрудников, а не случайно.
В интерфейсе: «Настройки» → «Общие» → «Распределение чата».
AUTO_ASSIGN_PRIORITY_BY_LAST_CHAT_ASSIGNED_TS Логический Выключено При автоматическом назначении выбирает оператора, которому диалог назначался раньше остальных.
В интерфейсе: «Настройки» → «Общие» → «Распределение чата».
AUTO_ASSIGN_TO_LAST_CHAT_OPERATOR Логический Включено Назначает диалог на оператора, с которым у посетителя был предыдущий диалог, если этот оператор доступен.
В интерфейсе: «Настройки» → «Общие» → «Распределение чата».
AUTO_ASSIGN_TO_LAST_CHAT_OPERATOR_IF_BUSY Логический Выключено Назначает диалог на оператора, с которым у посетителя был предыдущий диалог, даже если оператор занят.
В интерфейсе: «Настройки» → «Общие» → «Распределение чата».
ROUTE_INTERACTIONS_INTERVAL Длительность 1 минута
00:01:00
Интервал периодической маршрутизации неназначенных диалогов из очереди.
ROUTE_INTERACTIONS_BATCH_LIMIT Целое число 2000 Служебная настройка производительности. Максимальное количество диалогов очереди, обрабатываемых за один проход маршрутизации.
CHAT_INTERCEPT Логический Включено Разрешает операторам перехватывать диалоги у других операторов.
OPERATOR_CLOSES_CHAT_FINALLY Логический Выключено Закрывает диалог окончательно сразу после закрытия оператором, не дожидаясь закрытия посетителем.
В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты».
CATEGORY_MANDATORY Логический Выключено Требует указать категорию диалога перед его закрытием.
В интерфейсе: «Настройки» → «Общие» → «Категории». Зависит от тарифной возможности categories: без неё действует значение «Выключено». Можно переопределить в настройках отдела.
CATEGORIES_COUNT_LIMIT Целое число 1 Максимальное количество категорий, которые можно назначить одному диалогу. Значение 0 снимает ограничение.
В интерфейсе: «Настройки» → «Общие» → «Категории». Зависит от тарифной возможности categories: без неё действует значение 1.
CATEGORY_SELECTION_WITH_ONE_CLICK Логический Включено Позволяет выбрать единственную категорию одним щелчком.
В интерфейсе: «Настройки» → «Общие» → «Категории». Зависит от тарифной возможности categories: без неё действует значение «Включено».
CATEGORIES_DEFAULT_VISIBLE Логический Включено Показывает в РМО категории, для которых в отделе не настроена видимость.
В интерфейсе: «Настройки» → «Общие» → «Категории». Можно переопределить в настройках отдела.
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} Количество операторов и отделов, показываемых в списке при переводе диалога и отправке диалога на почту.
Формат: {"agents_limit": 10, "departments_limit": 10}, значения — целые числа не меньше 1.
FORCE_START_CHAT_ON_VISITOR_MESSAGE Логический Включено Начинает диалог, если от посетителя пришло сообщение, а диалога нет. Полезно для мобильных приложений: диалог начинается независимо от статуса «офлайн», первого вопроса или выбора отдела.
ACTIVE_INTERACTION_CACHE_ENABLED Логический Включено Служебная настройка производительности. Кэширует в Redis идентификатор активного диалога посетителя при обработке входящих сообщений. Выключайте только по рекомендации технической поддержки Webim.
OFFLINE_CHAT_PROCESSING Логический Включено Включает обработку операторами сообщений, оставленных посетителями в офлайн-режиме.
Зависит от тарифной возможности offline_message: без неё действует значение «Выключено».
ENABLE_OFFLINE_QUEUE Логический Выключено Включает отдельную очередь офлайн-обращений: отдельный раздел в РМО, статус оператора «Обработка офлайн-обращений» и учёт офлайн-обращений в статистике. Офлайн-обращения назначаются, когда в онлайн-очереди нечего назначать. При выключенной настройке все обращения находятся в общей очереди.
ENABLE_OFFLINE_CHATS_FOR_CHANNELS Логический Выключено Разрешает создавать офлайн-обращения в каналах общения. При выключенной настройке все новые обращения из каналов создаются как онлайн-диалоги.
ENABLE_OFFLINE_CHATS_FOR_MOBILE Логический Выключено Разрешает создавать офлайн-обращения из мобильных приложений. При выключенной настройке посетитель мобильного приложения считается онлайн, пока у устройства есть действующий токен пуш-уведомлений.
QUEUE_LIMIT Целое число или пусто Не задано Максимальная длина очереди диалогов. Пустое значение — без ограничения. При включённой настройке ENABLE_OFFLINE_QUEUE ограничение применяется отдельно к онлайн- и офлайн-очереди.
В интерфейсе: «Настройки» → «Общие» → «Распределение чата». Зависит от тарифной возможности 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 отключает кнопки.
Можно переопределить в настройках отдела.
LAST_MESSAGE_MAIN_SETTING Логический Выключено Разрешает оператору отправлять из РМО «последнее сообщение» — клавиатуру с кнопками «Продолжить» и «Завершить чат».

Таймауты диалогов

Тайм-ауты назначения, ожидания и закрытия диалогов, а также связанные с ними индикаторы в РМО. Тайм-ауты ботов описаны в разделе Боты.

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

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

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

Параметр Тип По умолчанию Описание
AGENT_CANT_PICK_TIMEOUT Длительность 00:00:00 Время, за которое назначенный оператор должен принять диалог. Если оператор не принял диалог, назначение снимается (при включённой настройке UNASSIGN_CHAT_IF_OPERATOR_BUSY).
В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела.
AGENT_CANT_PICK_HOLDING_MESSAGE_TIMEOUT Длительность 00:00:00 Время после назначения непринятого диалога, через которое посетителю отправляется сообщение с просьбой подождать.
В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела.
AGENT_BUSY_TIMEOUT Длительность 00:00:00 Время, за которое оператор должен ответить на непрочитанное сообщение посетителя. Если оператор не ответил, назначение снимается (при включённой настройке UNASSIGN_CHAT_IF_OPERATOR_BUSY).
В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела.
AGENT_BUSY_HOLDING_MESSAGE_TIMEOUT Длительность 00:00:00 Время с момента непрочитанного оператором сообщения, через которое посетителю отправляется сообщение с просьбой подождать.
В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела.
TIMEOUT_RETURN_TO_QUEUE_AFTER_NOT_ANSWERED_VISITOR_MESSAGE Длительность 00:00:00 Время, через которое диалог возвращается в очередь, если оператор прочитал последнее сообщение посетителя, но не ответил.
В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела.
CONTACT_REQUEST_FOR_QUEUE_TIMEOUT Длительность 5 минут
00:05:00
Время ожидания в очереди или после назначения, через которое у посетителя запрашиваются контактные данные (при включённой настройке AUTO_CONTACT_REQUEST_FOR_WAITING_TOO_LONG).
Можно переопределить в настройках отдела.
TIMEOUT_FOR_CHAT_AUTO_CLOSE_IF_CLOSED_BY_OPERATOR Длительность, не менее 1 с 1 час
01:00:00
Время, через которое диалог, закрытый оператором, закрывается окончательно. Отключить тайм-аут нельзя.
В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела.
TIMEOUT_FOR_CHAT_AUTO_CLOSE_IF_CHAT_IS_INACTIVE Длительность, не менее 1 с 1 час
01:00:00
Время без активности в диалоге, по истечении которого посетителю отправляется предупреждение и диалог закрывается. Отключить тайм-аут нельзя.
В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела.
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.
В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела.
TIMEOUT_FOR_CHAT_CLOSE_FINALLY_AFTER_CLOSE_BY_INACTIVE_TIMEOUT Длительность 00:00:00 Время окончательного закрытия диалога, переведённого в состояние «закрыт оператором» по тайм-ауту неактивности (см. AUTO_CLOSE_INACTIVE_TO_CLOSED_BY_OPERATOR).
В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела.
CHAT_UNASSIGN_FROM_OFFLINE_OPERATORS_TIMEOUT Длительность 10 минут
00:10:00
Время, через которое с оператора, находящегося офлайн, снимается назначение диалога.
В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты». Можно переопределить в настройках отдела.
FIRST_WAITING_QUEUE_TIME_NOTIFY_TIMEOUT Длительность 00:00:00 Время ожидания в очереди, через которое посетителю отправляется первое сообщение о времени ожидания.
Можно переопределить в настройках отдела.
SECOND_WAITING_QUEUE_TIME_NOTIFY_TIMEOUT Длительность 00:00:00 Время ожидания в очереди, через которое посетителю отправляется второе сообщение о времени ожидания.
Можно переопределить в настройках отдела.
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 минута
00:01:00
Время с момента ухода посетителя с сайта, по истечении которого посетитель считается офлайн.
SECONDS_BEFORE_VISITOR_MISSED Длительность 00:00:00 Если посетитель закрывает диалог раньше этого времени, обращение учитывается как отказ, а не как пропущенное.
В интерфейсе: «Настройки» → «Общие» → «Тайм-ауты».

Удержание чатов

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

Скрытие чатов

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

Закрытие диалогов сообщениями посетителей

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

Тексты и сообщения

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