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

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

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

## Посетители { #visitors }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `VISITOR_TRACKING` | Логический | Включено | Отслеживает всех посетителей сайта, а не только тех, кто начал диалог.<br>Зависит от тарифной возможности `visitor_tracking`: без неё действует значение «Выключено». |
| `VISITOR_CAN_CLOSE_CHAT` | Логический | Включено | Разрешает посетителю закрывать диалог кнопкой в виджете. |
| `VISITOR_CAN_CLOSE_CHAT_IN_STATES` | Список строк | `["queue", "assigned"]` | Состояния диалога, в которых посетитель может его закрыть. Пустой список запрещает посетителю закрывать диалог.<br>Допустимые значения: `queue` — в очереди, `assigned` — назначен оператору, `chatting` — идёт разговор с оператором, `chatting_with_robot` — разговор с ботом, `hold` — на удержании, `hidden` — скрыт, `invitation` — приглашение. |
| `CLOSE_CHAT_ON_PAGE_CHANGE` | Логический | Выключено | Автоматически закрывает диалог, когда посетитель переходит на другую страницу сайта. |
| `VISITOR_UPLOAD_FILE` | Логический | Включено | Разрешает посетителям отправлять файлы.<br>Зависит от тарифной возможности `operator_file_upload`: без неё действует значение «Выключено». |
| `VISITOR_WEBSOCKETS` | Логический | Выключено | Включает получение обновлений в виджете через веб-сокеты. |
| `VISITOR_FONTS_ENABLED` | Логический | Включено | Подключает в виджете собственные шрифты **Webim**. |
| `FORCE_VISITOR_DISABLE` | Логический | Выключено | Отключает виджет на сайте. Проверяется при обновлении страницы посетителем. Можно использовать для быстрого снижения нагрузки на сервер. |
| `FORCE_VISITOR_HTTPS` | Логический | Выключено | Требует, чтобы виджет у посетителя работал только по HTTPS. |
| `VISITOR_ENABLING_PROBABILITY` | Целое число | 100 | Вероятность в процентах, с которой виджет включается для посетителя сайта. Проверяется один раз при входе посетителя на сайт. Допустимые значения — от `0` до `100`.<br>В интерфейсе: «Настройки» → «Общие» → «Разное». Зависит от тарифной возможности `visitor_enabling_probability`: без неё действует значение `100`. |
| `SHOW_VISITOR_CHANGE_INFO` | Логический | Включено | Показывает посетителю кнопку изменения контактных данных. |
| `SHOW_VISITOR_SEND_CHAT_TO_EMAIL_BUTTON` | Логический | Включено | Показывает посетителю кнопку отправки истории диалога на электронную почту.<br>В интерфейсе: «Настройки» → «Общие» → «Возможности». |
| `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` | Логический | Выключено | Требует от посетителя подтвердить согласие на обработку персональных данных: флажком в форме или во всплывающем окне.<br>В интерфейсе: «Настройки» → «Общие» → «Разное». |
| `PROCESSING_PERSONAL_DATA_URL` | Строка | `https://webim.ru/doc/agreement/` | Адрес страницы с условиями обработки персональных данных, на которую ведёт ссылка в виджете, например `https://shop.example.local/privacy`.<br>В интерфейсе: «Настройки» → «Общие» → «Разное». |
| `SHOW_PROCESSING_PERSONAL_DATA_CHECKBOX` | Логический | Включено | Показывает в виджете флажок «Согласие на обработку персональных данных».<br>В интерфейсе: «Настройки» → «Общие» → «Разное». |
| `VISITOR_DEP_ANSWERS` | Логический | Выключено | Показывает оператору только шаблоны ответов отдела, в который обратился посетитель.<br>Зависит от тарифной возможности `departments`: без неё действует значение «Выключено». |
| `LOAD_PREV_CHAT_FOR_VISITOR` | Логический | Включено | Разрешает посетителю подгружать историю предыдущих диалогов в виджете. |
| `LOAD_PREV_CHATS_ON_BUTTON_ONLY_AND_IN_BATCHES` | Логический | Выключено | Подгружает предыдущие диалоги в виджете только по кнопке, по три диалога за раз, без автоматической подгрузки при прокрутке.<br>В интерфейсе: «Настройки» → «Общие» → «Возможности». |
| `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"]` | Порядок приоритета источников данных посетителя: значения из источника, указанного раньше, заменяют значения из следующих.<br>Допустимые значения: `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 дней<br>`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` | Логический | Выключено | Разрешает посетителям ставить реакции на сообщения.<br>В интерфейсе: «Настройки» → «Общие» → «Реакции». Можно переопределить в настройках отдела. |
| `CAN_VISITOR_CHANGE_REACTION` | Логический | Выключено | Разрешает посетителям изменять поставленные реакции.<br>В интерфейсе: «Настройки» → «Общие» → «Реакции». Можно переопределить в настройках отдела. |

## Баны { #bans }

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

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

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

### BAN_CONDITIONS { #default-ban-conditions }

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

---

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