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

Посетители и виджет

Настройки поведения виджета на сайте, возможностей посетителя, авторизации посетителей и блокировок.

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

Посетители

Параметр Тип По умолчанию Описание
VISITOR_TRACKING Логический Включено Отслеживает всех посетителей сайта, а не только тех, кто начал диалог.
Зависит от тарифной возможности visitor_tracking: без неё действует значение «Выключено».
VISITOR_CAN_CLOSE_CHAT Логический Включено Разрешает посетителю закрывать диалог кнопкой в виджете.
VISITOR_CAN_CLOSE_CHAT_IN_STATES Список строк ["queue", "assigned"] Состояния диалога, в которых посетитель может его закрыть. Пустой список запрещает посетителю закрывать диалог.
Допустимые значения: queue — в очереди, assigned — назначен оператору, chatting — идёт разговор с оператором, chatting_with_robot — разговор с ботом, hold — на удержании, hidden — скрыт, invitation — приглашение.
CLOSE_CHAT_ON_PAGE_CHANGE Логический Выключено Автоматически закрывает диалог, когда посетитель переходит на другую страницу сайта.
VISITOR_UPLOAD_FILE Логический Включено Разрешает посетителям отправлять файлы.
Зависит от тарифной возможности operator_file_upload: без неё действует значение «Выключено».
VISITOR_WEBSOCKETS Логический Выключено Включает получение обновлений в виджете через веб-сокеты.
VISITOR_FONTS_ENABLED Логический Включено Подключает в виджете собственные шрифты Webim.
FORCE_VISITOR_DISABLE Логический Выключено Отключает виджет на сайте. Проверяется при обновлении страницы посетителем. Можно использовать для быстрого снижения нагрузки на сервер.
FORCE_VISITOR_HTTPS Логический Выключено Требует, чтобы виджет у посетителя работал только по HTTPS.
VISITOR_ENABLING_PROBABILITY Целое число 100 Вероятность в процентах, с которой виджет включается для посетителя сайта. Проверяется один раз при входе посетителя на сайт. Допустимые значения — от 0 до 100.
В интерфейсе: «Настройки» → «Общие» → «Разное». Зависит от тарифной возможности visitor_enabling_probability: без неё действует значение 100.
SHOW_VISITOR_CHANGE_INFO Логический Включено Показывает посетителю кнопку изменения контактных данных.
SHOW_VISITOR_SEND_CHAT_TO_EMAIL_BUTTON Логический Включено Показывает посетителю кнопку отправки истории диалога на электронную почту.
В интерфейсе: «Настройки» → «Общие» → «Возможности».
SHOW_VISITOR_SEND_GEOLOCATION Логический Выключено Показывает посетителю кнопку отправки местоположения.
SHOW_VISITOR_RATE_OPERATOR_BUTTON Логический Включено Показывает посетителю кнопку оценки оператора в диалоге.
RATE_OPERATOR_BY_CLICK_ON_AVATAR Логический Включено Открывает форму оценки оператора по щелчку на аватаре оператора.
SHOW_AGENT_INFO_FOR_VISITOR Логический Выключено Показывает посетителю кнопку информации об операторе.
VISITOR_SEARCH_MESSAGE Логический Выключено Показывает посетителю кнопку поиска по сообщениям диалога.
PERSONAL_DATA_AGREEMENT_CONFIRMATION_MANDATORY Логический Выключено Требует от посетителя подтвердить согласие на обработку персональных данных: флажком в форме или во всплывающем окне.
В интерфейсе: «Настройки» → «Общие» → «Разное».
PROCESSING_PERSONAL_DATA_URL Строка https://webim.ru/doc/agreement/ Адрес страницы с условиями обработки персональных данных, на которую ведёт ссылка в виджете, например https://shop.example.local/privacy.
В интерфейсе: «Настройки» → «Общие» → «Разное».
SHOW_PROCESSING_PERSONAL_DATA_CHECKBOX Логический Включено Показывает в виджете флажок «Согласие на обработку персональных данных».
В интерфейсе: «Настройки» → «Общие» → «Разное».
VISITOR_DEP_ANSWERS Логический Выключено Показывает оператору только шаблоны ответов отдела, в который обратился посетитель.
Зависит от тарифной возможности departments: без неё действует значение «Выключено».
LOAD_PREV_CHAT_FOR_VISITOR Логический Включено Разрешает посетителю подгружать историю предыдущих диалогов в виджете.
LOAD_PREV_CHATS_ON_BUTTON_ONLY_AND_IN_BATCHES Логический Выключено Подгружает предыдущие диалоги в виджете только по кнопке, по три диалога за раз, без автоматической подгрузки при прокрутке.
В интерфейсе: «Настройки» → «Общие» → «Возможности».
VISITOR_CLEAR_HISTORY Логический Выключено Разрешает посетителю очищать историю диалога в виджете.
VISITOR_KEYBOARD_ADAPTIVE_LAYOUT Логический Выключено Включает адаптивную раскладку кнопок клавиатуры в виджете: ширина кнопки зависит от текста, кнопки переносятся на несколько рядов по ширине виджета.
VISITOR_KEYBOARD_BUTTONS_ALIGN Выбор из списка right Выравнивание кнопок клавиатуры при адаптивной раскладке. Допустимые значения: right — по правому краю, left — по левому краю, center — по центру. Для языков с письмом справа налево выравнивание зеркалится.
PREVIOUS_CHATS_LABEL_TIME_INTERVAL Целое число или пусто Не задано Интервал в секундах, в пределах которого проверяется наличие предыдущих диалогов у посетителя. Пустое значение — без ограничения.
COLLAPSE_PREVIOUS_CHATS Логический Выключено Сворачивает в РМО предыдущие диалоги с посетителем; кнопка «История» разворачивает их.
OPEN_CHAT_IN_NEW_TAB_FOR_MOBILE Логический Включено Открывает диалог на мобильном устройстве в новом окне.
DONT_AUTO_EXPAND_WIDGET Логический Выключено Не разворачивает виджет автоматически при непрочитанном сообщении оператора.
BUTTON_IFRAME_OPEN_IN_CURRENT_WINDOW Логический Выключено Открывает виджет на мобильных устройствах на странице сайта во фрейме, а не в отдельном окне. При включении в код кнопки добавляется параметр webim.openInCurrentWindow: true; на сайте этот режим также можно включить вызовом webim.api.init(true).
VISITOR_FIELDS_PRIORITY_ORDER Список строк ["providedFields", "fields", "opFields"] Порядок приоритета источников данных посетителя: значения из источника, указанного раньше, заменяют значения из следующих.
Допустимые значения: providedFields — данные, переданные сайтом при авторизации посетителя; fields — данные, введённые посетителем; opFields — данные, введённые оператором.
CHECK_VISITOR_AUTH Логический Включено Проверяет токен авторизации в запросах виджета к серверу.
PROVIDED_VISITOR_HASH_ALGORITHM Строка hmac-sha256 Алгоритм подписи данных посетителя, передаваемых сайтом при авторизации посетителя. Допустимые значения: hmac-sha256, hmac-sha512, sha256, sha512, md5. Значение md5 оставлено для совместимости со старыми интеграциями; для новых интеграций используйте hmac-sha256 или hmac-sha512.
PROVIDED_VISITOR_HASH_LEGACY_ENABLED Логический Включено Принимает подпись данных посетителя версии 1, при которой значения полей склеиваются без разделителей. После перевода сайта на подпись версии 2 (visitor-ext.version = 2) выключите настройку: подпись версии 1 позволяет выдать данные одного посетителя за данные другого.
PROVIDED_VISITOR_HASH_KEY_EXPIRATION Длительность 180 дней
180 00:00:00
Срок действия приватного ключа для авторизации посетителей.
CHATS_COUNT_PER_IP_LIMIT Целое число 10 Максимальное количество новых диалогов и офлайн-обращений с одного IP-адреса за час. Значение 0 снимает ограничение.
VISITOR_SEND_CHAT_HISTORY_PER_CHAT_LIMIT Целое число 3 Сколько раз посетитель может отправить историю одного диалога на электронную почту.
OPERATOR_SEND_CHAT_HISTORY_PER_CHAT_LIMIT Целое число 3 Сколько раз оператор может отправить историю одного диалога на электронную почту.
AUTO_CONTACT_REQUEST_FOR_WAITING_TOO_LONG Логический Включено Запрашивает у посетителя контактные данные, если ответа приходится ждать слишком долго (см. CONTACT_REQUEST_FOR_QUEUE_TIMEOUT).
PASSTHROUGH_LAST_VISITOR_ACTIVITY_FROM_IFRAME Логический Выключено Учитывает действия посетителя внутри фреймов на странице как активность посетителя.
CAN_VISITOR_REACT Логический Выключено Разрешает посетителям ставить реакции на сообщения.
В интерфейсе: «Настройки» → «Общие» → «Реакции». Можно переопределить в настройках отдела.
CAN_VISITOR_CHANGE_REACTION Логический Выключено Разрешает посетителям изменять поставленные реакции.
В интерфейсе: «Настройки» → «Общие» → «Реакции». Можно переопределить в настройках отдела.

Баны

Параметр Тип По умолчанию Описание
DEFAULT_BAN_DURATION Длительность 7 дней
7 00:00:00
Срок блокировки посетителя по умолчанию.
BAN_CONDITIONS JSON-объект См. ниже Признаки посетителя, по которым выполняется блокировка.
Поля: by_address — по IP-адресу, by_email — по адресу электронной почты, by_phone — по номеру телефона, by_channel_user_id — по идентификатору пользователя в канале, by_push_tokens — по токенам пуш-уведомлений. Значения — true или false.

Значения по умолчанию

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

BAN_CONDITIONS

{
  "by_address": true,
  "by_email": true,
  "by_phone": true,
  "by_channel_user_id": true,
  "by_push_tokens": true
}