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