# Прочие настройки

Настройки рассылок, Apple Chat, горячих клавиш, прокси-серверов, CDN Ngenix, собственного HTTP-сервера отправки почты и группы «Разное»: скрытие возможностей интерфейса, приоритеты операторов в отделах, оценка времени ожидания, разрешённое время работы операторов, карты и служебные настройки.

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

## Рассылки { #broadcasts }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `BROADCAST_DELAY_BETWEEN_RECIPIENTS` | JSON-объект | `{"history-chats": 1}` | Пауза в секундах между отправками рассылки разным получателям в зависимости от типа рассылки. Ключи: `history-chats` — рассылка по истории диалогов, `whatsapp` — рассылка в WhatsApp.<br>Пример: `{"history-chats": 1, "whatsapp": 2}`. |

## Apple Chat { #apple-chat }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `APPLE_CHAT_PAYMENT_MERCHANT` | JSON-объект | `{}` | Параметры приёма платежей Apple Pay в канале Apple Messages for Business. Все поля обязательны.<br>Поля: `merchant_id` — идентификатор продавца; `merchant_name` — название продавца; `verified_domain` — подтверждённый домен; `payment_gateway_url` — адрес платёжного шлюза.<br>Пример: `{"merchant_id": "merchant.local.example", "merchant_name": "Example Shop", "verified_domain": "shop.example.local", "payment_gateway_url": "https://pay.example.local/paymentGateway"}`. |

## Мобильные приложения { #mobile-apps }

Настройки этой группы в **Webim** 11.0 не используются (см. [Неиспользуемые настройки](https://webim.ru/kb/11.0/settings/constance/#unused)).

## Горячие клавиши и UI { #hotkeys-ui }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `HOTKEYS` | JSON-объект | См. [Формат HOTKEYS](#hotkeys) | Горячие клавиши РМО. Формат и поля описаны в разделе [Формат HOTKEYS](#hotkeys). |
| `USE_EMOJI_ANNOTATIONS` | Логический | Включено | Включает в виджете поиск эмодзи по названиям на языке посетителя. Увеличивает объём загружаемого виджета. |

## Прокси и сеть { #proxy-network }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `BUTTON_CODE_FALLBACK_DOMAINS` | JSON-массив | `[]` | Резервные домены для кода кнопки: если основной домен недоступен, код кнопки загружает виджет с резервного домена. Некорректные значения игнорируются.<br>Пример: `["chat2.example.local"]`. |
| `PROXIES` | JSON-объект | См. [Формат PROXIES](#proxies) | Прокси-серверы для исходящих запросов к каналам и сервисам пуш-уведомлений. Формат и поля описаны в разделе [Формат PROXIES](#proxies).<br>Значение поля `password` скрыто в форме редактирования. |
| `HIDE_REFERRER` | Логический | Выключено | Не передаёт на сервер **Webim** адрес страницы, с которой посетитель пришёл на сайт. |
| `PROXY_SETTINGS_CACHE_TTL` | Длительность | 1 минута<br>`00:01:00` | Время кэширования настроек прокси для сервисов пуш-уведомлений. |

## Разное { #misc }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `HIDDEN_FEATURES` | Список строк | `[]` | Идентификаторы возможностей интерфейса, доступ к которым запрещён всем сотрудникам.<br>Пример: `["ui.dashboard", "ui.report_configs_management"]`. |
| `HIDDEN_CHANNEL_TYPES` | Список строк | `[]` | Типы каналов, доступ к которым запрещён: каналы этих типов не показываются сотрудникам. Коды типов приведены в описании `DISABLED_CHANNEL_TYPES` на странице [Каналы, боты и опросы](https://webim.ru/kb/11.0/settings/constance/channels-bots.html#channels).<br>Пример: `["vk", "email"]`. |
| `HIDDEN_BOT_TYPES` | Список строк | `[]` | Типы ботов, которые не предлагаются при создании нового бота. Уже созданные боты остаются доступными.<br>Допустимые значения: `scenario`, `stc`, `bss`, `external_api`. |
| `DEFAULT_PHONE_NUMBER` | Строка | Пусто | Номер телефона для кнопки звонка в виджете по умолчанию.<br>В интерфейсе: «Настройки» → «Общие» → «Компания». |
| `TELEPORT` | Логический | Выключено | Разрешает оператору перенаправлять посетителя на другую страницу сайта.<br>В интерфейсе: «Настройки» → «Общие» → «Возможности». Зависит от тарифной возможности `push_url`: без неё действует значение «Выключено». |
| `CLIENT_PHP_URL` | Строка | Пусто | Адрес страницы для открытия диалога в отдельном окне. |
| `TRACK_VISITOR_MESSAGE_READ_STATUS` | Логический | Включено | Отслеживает прочтение сообщений посетителя оператором и показывает посетителю статус прочтения. |
| `OPERATOR_DEPARTMENT_PRIORITIZATION` | Логический | Выключено | Включает приоритеты операторов в отделах: при назначении диалога учитывается приоритет оператора в отделе диалога.<br>В интерфейсе: «Настройки» → «Общие» → «Распределение чата». |
| `DEFAULT_OPERATOR_DEPARTMENT_PRIORITY` | Целое число | 5 | Приоритет оператора в отделе, если он не задан явно (см. `OPERATOR_DEPARTMENT_PRIORITIZATION`).<br>В интерфейсе: «Настройки» → «Общие» → «Распределение чата». |
| `AVAILABLE_REQUESTED_FORM_IDS` | Список целых чисел | `[]` | Идентификаторы форм Zendesk, которые оператор может запросить у посетителя кнопкой «Запросить форму». Учитываются первые 100 элементов.<br>Пример: `[360001, 360002]`. |
| `QUEUE_WAITING_TIME_NOTIFICATION` | Логический | Выключено | Отправляет посетителю сообщения с ожидаемым временем ожидания в очереди. |
| `WAITING_TIME_COEFFICIENT` | Дробное число | 1.0 | Коэффициент, на который умножается расчётное время ожидания в очереди. Например, `1.5` увеличивает показываемое время в полтора раза.<br>Можно переопределить в настройках отдела. |
| `QUEUE_WAITING_TIME_API` | Логический | Выключено | Включает API расчёта среднего времени ожидания в очереди. |
| `KEYS_FOR_OS` | Строка (JSON) | Пусто | Служебная настройка лицензирования. Заполняется автоматически при применении лицензионного ключа; не изменяйте её вручную.<br>Значение скрыто в форме редактирования. |
| `INVOICEBOX_ENABLED` | Логический | Выключено | Включает оплату услуг **Webim** банковской картой через InvoiceBox. Используется только в облаке. |
| `INVOICEBOX_PARTICIPANT_ID` | Строка | Пусто | Идентификатор магазина в InvoiceBox. Используется только в облаке. |
| `INVOICEBOX_PARTICIPANT_IDENT` | Строка | Пусто | Строковый идентификатор магазина в InvoiceBox. Используется только в облаке. |
| `INVOICEBOX_TEST_MODE` | Логический | Выключено | Включает тестовый режим InvoiceBox, в котором платежи не списываются. Используется только в облаке. |
| `PRIVACY_POLICY_URL` | Строка | `https://webim.ru/doc/privacy/` | Адрес страницы с политикой конфиденциальности, например `https://shop.example.local/privacy-policy`. |
| `ALLOWED_ONLINE_TIME` | JSON-массив | `[]` | Разрешённое время работы операторов в статусе «онлайн». Пустой список — без ограничений.<br>Элемент списка: `timeIntervals` — интервал времени `ЧЧ:ММ-ЧЧ:ММ`, `weekDays` — дни недели (1 — понедельник, 7 — воскресенье).<br>Пример: `[{"timeIntervals": "9:30-22:00", "weekDays": [1, 2, 3, 4, 5]}, {"timeIntervals": "11:00-17:00", "weekDays": [6]}]`. |
| `DEFAULT_PAGE_SIZE` | Целое число | 25 | Количество элементов на странице в списках по умолчанию. |
| `LANDING_PAGE_TO_STYLES` | JSON-объект | `{}` | Цвета текста и фона заголовка страницы входа в карточке сессии в зависимости от размещения или канала. Цвета задаются в формате `#RRGGBBAA`.<br>Формат: `{"locations": {"<id размещения>": {"color": "#FFFFFFFF", "backgroundColor": "#1E88E5FF"}}, "channels": {"<id канала>": {"color": "#000000FF", "backgroundColor": "#FFEB3BFF"}}}`.<br>В интерфейсе: «Настройки» → «Общие» → «Разное». |
| `GEO_MAPS_PROVIDER` | Выбор из списка | `yandex` | Картографический сервис для показа местоположения посетителя. Допустимые значения: `yandex`, `google`, `2gis`. |
| `GEO_MAPS_API_KEY` | Строка | Пусто | Ключ API картографического сервиса, выбранного в `GEO_MAPS_PROVIDER`.<br>Значение скрыто в форме редактирования. |

## CDN Ngenix { #cdn-ngenix }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `CDN_NGENIX_ENABLE` | Логический | Выключено | Включает очистку кэша CDN Ngenix для статических файлов виджета (код кнопки, конфигурация виджета, ресурсы интерфейса) после их изменения. Очистка работает, только если заполнены все параметры `CDN_NGENIX_*`. |
| `CDN_NGENIX_LOGIN` | Строка | Пусто | Логин (адрес электронной почты) для API Ngenix. |
| `CDN_NGENIX_API_KEY` | Строка | Пусто | Ключ API Ngenix для очистки кэша.<br>Значение скрыто в форме редактирования. |
| `CDN_NGENIX_CONF_ID` | Целое число | 0 | Идентификатор конфигурации в Ngenix. |
| `CDN_NGENIX_API_URL` | Строка | `https://api.ngenix.net/api/v3/purge-task` | Адрес метода API Ngenix для очистки кэша. |

## Custom Post Server { #custom-post-server }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `CUSTOM_POST_SERVER_URL` | Строка | Пусто | Адрес собственного HTTP-сервера отправки почты. Если адрес задан, исходящие письма аккаунта отправляются POST-запросом на этот адрес, а не через SMTP. |
| `CUSTOM_POST_SERVER_LOGIN` | Строка | Пусто | Логин для Basic-аутентификации на HTTP-сервере отправки почты. |
| `CUSTOM_POST_SERVER_PASSWORD` | Строка | Пусто | Пароль для Basic-аутентификации на HTTP-сервере отправки почты.<br>Значение скрыто в форме редактирования. |

## Формат HOTKEYS { #hotkeys }

Горячие клавиши РМО. Сочетание записывается как модификаторы и клавиша через `+`, по образцу значений по умолчанию.

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

```json
{
  "upper_dialog_hotkey": "ctrl+arrowup",
  "lower_dialog_hotkey": "ctrl+arrowdown",
  "redirect_dialog_hotkey": "ctrl+comma",
  "oldest_dialog_hotkey": "ctrl+period",
  "newest_own_queue_dialog_hotkey": "ctrl+KeyQ",
  "send_message_by_enter": true
}
```

| Поле | Тип | Описание |
|---|---|---|
| `upper_dialog_hotkey` | Строка | Переход к диалогу выше по списку в разделе «В диалоге». |
| `lower_dialog_hotkey` | Строка | Переход к диалогу ниже по списку в разделе «В диалоге». |
| `redirect_dialog_hotkey` | Строка | Перевод диалога, аналог кнопки перевода. |
| `oldest_dialog_hotkey` | Строка | Перевод дольше всех ожидающего диалога из раздела «Ожидают ответа» в раздел «В диалоге». Работает только при включённом автоматическом назначении. |
| `newest_own_queue_dialog_hotkey` | Строка | Переход к самому новому диалогу в разделе «Ожидают ответа», уже назначенному на текущего оператора. |
| `send_message_by_enter` | Логический | `true` — `Enter` отправляет сообщение, `Shift+Enter` переносит строку; `false` — наоборот. |

Сочетания `Ctrl+W`, `Ctrl+Shift+W`, `Ctrl+T`, `Ctrl+Shift+T`, `Ctrl+N` и `Ctrl+Shift+N` зарезервированы браузером, их нельзя назначить.

## Формат PROXIES { #proxies }

Прокси-серверы для исходящих запросов. Ключ верхнего уровня определяет назначение прокси:

  * `channels` — запросы к API каналов общения;

  * `fcm` — Firebase Cloud Messaging (пуш-уведомления Android);

  * `apns` — Apple Push Notification service (пуш-уведомления iOS);

  * `hpk` — Huawei Push Kit.

Пример:

```json
{
  "channels": {"scheme": "http", "host": "proxy.example.local", "port": "3128", "user": "webim", "password": "<пароль>"},
  "fcm": {"host": "proxy.example.local", "port": "3128"},
  "apns": {"host": "proxy.example.local", "port": "3128"}
}
```

| Поле | Описание |
|---|---|
| `host` | Адрес прокси-сервера. Обязательное поле. |
| `port` | Порт прокси-сервера. Для сервисов пуш-уведомлений по умолчанию `3128`. |
| `user` | Имя пользователя прокси-сервера. Для сервисов пуш-уведомлений учитывается только вместе с `password`. |
| `password` | Пароль пользователя прокси-сервера. Значение скрыто в форме редактирования. |
| `scheme` | Протокол подключения к прокси-серверу для `channels`: `http` (по умолчанию) или `https`. Для сервисов пуш-уведомлений всегда используется HTTP-прокси. |

Если прокси указан в настройках конкретного канала, для этого канала он имеет приоритет над `channels`.

---

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