Прочие настройки
Настройки рассылок, Apple Chat, горячих клавиш, прокси-серверов, CDN Ngenix, собственного HTTP-сервера отправки почты и группы «Разное»: скрытие возможностей интерфейса, приоритеты операторов в отделах, оценка времени ожидания, разрешённое время работы операторов, карты и служебные настройки.
Как читать таблицы и редактировать значения, описано в разделе Настройки в Constance.
Рассылки
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
BROADCAST_DELAY_BETWEEN_RECIPIENTS |
JSON-объект | {"history-chats": 1} |
Пауза в секундах между отправками рассылки разным получателям в зависимости от типа рассылки. Ключи: history-chats — рассылка по истории диалогов, whatsapp — рассылка в WhatsApp.Пример: {"history-chats": 1, "whatsapp": 2}. |
Apple Chat
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
APPLE_CHAT_PAYMENT_MERCHANT |
JSON-объект | {} |
Параметры приёма платежей Apple Pay в канале Apple Messages for Business. Все поля обязательны. Поля: merchant_id — идентификатор продавца; merchant_name — название продавца; verified_domain — подтверждённый домен; payment_gateway_url — адрес платёжного шлюза.Пример: {"merchant_id": "merchant.local.example", "merchant_name": "Example Shop", "verified_domain": "shop.example.local", "payment_gateway_url": "https://pay.example.local/paymentGateway"}. |
Мобильные приложения
Настройки этой группы в Webim 11.0 не используются (см. Неиспользуемые настройки).
Горячие клавиши и UI
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
HOTKEYS |
JSON-объект | См. Формат HOTKEYS | Горячие клавиши РМО. Формат и поля описаны в разделе Формат HOTKEYS. |
USE_EMOJI_ANNOTATIONS |
Логический | Включено | Включает в виджете поиск эмодзи по названиям на языке посетителя. Увеличивает объём загружаемого виджета. |
Прокси и сеть
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
BUTTON_CODE_FALLBACK_DOMAINS |
JSON-массив | [] |
Резервные домены для кода кнопки: если основной домен недоступен, код кнопки загружает виджет с резервного домена. Некорректные значения игнорируются. Пример: ["chat2.example.local"]. |
PROXIES |
JSON-объект | См. Формат PROXIES | Прокси-серверы для исходящих запросов к каналам и сервисам пуш-уведомлений. Формат и поля описаны в разделе Формат PROXIES. Значение поля password скрыто в форме редактирования. |
HIDE_REFERRER |
Логический | Выключено | Не передаёт на сервер Webim адрес страницы, с которой посетитель пришёл на сайт. |
PROXY_SETTINGS_CACHE_TTL |
Длительность | 1 минута00:01:00 |
Время кэширования настроек прокси для сервисов пуш-уведомлений. |
Разное
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
HIDDEN_FEATURES |
Список строк | [] |
Идентификаторы возможностей интерфейса, доступ к которым запрещён всем сотрудникам. Пример: ["ui.dashboard", "ui.report_configs_management"]. |
HIDDEN_CHANNEL_TYPES |
Список строк | [] |
Типы каналов, доступ к которым запрещён: каналы этих типов не показываются сотрудникам. Коды типов приведены в описании DISABLED_CHANNEL_TYPES на странице Каналы, боты и опросы.Пример: ["vk", "email"]. |
HIDDEN_BOT_TYPES |
Список строк | [] |
Типы ботов, которые не предлагаются при создании нового бота. Уже созданные боты остаются доступными. Допустимые значения: scenario, stc, bss, external_api. |
DEFAULT_PHONE_NUMBER |
Строка | Пусто | Номер телефона для кнопки звонка в виджете по умолчанию. В интерфейсе: «Настройки» → «Общие» → «Компания». |
TELEPORT |
Логический | Выключено | Разрешает оператору перенаправлять посетителя на другую страницу сайта. В интерфейсе: «Настройки» → «Общие» → «Возможности». Зависит от тарифной возможности push_url: без неё действует значение «Выключено». |
CLIENT_PHP_URL |
Строка | Пусто | Адрес страницы для открытия диалога в отдельном окне. |
TRACK_VISITOR_MESSAGE_READ_STATUS |
Логический | Включено | Отслеживает прочтение сообщений посетителя оператором и показывает посетителю статус прочтения. |
OPERATOR_DEPARTMENT_PRIORITIZATION |
Логический | Выключено | Включает приоритеты операторов в отделах: при назначении диалога учитывается приоритет оператора в отделе диалога. В интерфейсе: «Настройки» → «Общие» → «Распределение чата». |
DEFAULT_OPERATOR_DEPARTMENT_PRIORITY |
Целое число | 5 | Приоритет оператора в отделе, если он не задан явно (см. OPERATOR_DEPARTMENT_PRIORITIZATION).В интерфейсе: «Настройки» → «Общие» → «Распределение чата». |
AVAILABLE_REQUESTED_FORM_IDS |
Список целых чисел | [] |
Идентификаторы форм Zendesk, которые оператор может запросить у посетителя кнопкой «Запросить форму». Учитываются первые 100 элементов. Пример: [360001, 360002]. |
QUEUE_WAITING_TIME_NOTIFICATION |
Логический | Выключено | Отправляет посетителю сообщения с ожидаемым временем ожидания в очереди. |
WAITING_TIME_COEFFICIENT |
Дробное число | 1.0 | Коэффициент, на который умножается расчётное время ожидания в очереди. Например, 1.5 увеличивает показываемое время в полтора раза.Можно переопределить в настройках отдела. |
QUEUE_WAITING_TIME_API |
Логический | Выключено | Включает API расчёта среднего времени ожидания в очереди. |
KEYS_FOR_OS |
Строка (JSON) | Пусто | Служебная настройка лицензирования. Заполняется автоматически при применении лицензионного ключа; не изменяйте её вручную. Значение скрыто в форме редактирования. |
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-массив | [] |
Разрешённое время работы операторов в статусе «онлайн». Пустой список — без ограничений. Элемент списка: timeIntervals — интервал времени ЧЧ:ММ-ЧЧ:ММ, weekDays — дни недели (1 — понедельник, 7 — воскресенье).Пример: [{"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.Формат: {"locations": {"<id размещения>": {"color": "#FFFFFFFF", "backgroundColor": "#1E88E5FF"}}, "channels": {"<id канала>": {"color": "#000000FF", "backgroundColor": "#FFEB3BFF"}}}.В интерфейсе: «Настройки» → «Общие» → «Разное». |
GEO_MAPS_PROVIDER |
Выбор из списка | yandex |
Картографический сервис для показа местоположения посетителя. Допустимые значения: yandex, google, 2gis. |
GEO_MAPS_API_KEY |
Строка | Пусто | Ключ API картографического сервиса, выбранного в GEO_MAPS_PROVIDER.Значение скрыто в форме редактирования. |
CDN Ngenix
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
CDN_NGENIX_ENABLE |
Логический | Выключено | Включает очистку кэша CDN Ngenix для статических файлов виджета (код кнопки, конфигурация виджета, ресурсы интерфейса) после их изменения. Очистка работает, только если заполнены все параметры CDN_NGENIX_*. |
CDN_NGENIX_LOGIN |
Строка | Пусто | Логин (адрес электронной почты) для API Ngenix. |
CDN_NGENIX_API_KEY |
Строка | Пусто | Ключ API Ngenix для очистки кэша. Значение скрыто в форме редактирования. |
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_URL |
Строка | Пусто | Адрес собственного HTTP-сервера отправки почты. Если адрес задан, исходящие письма аккаунта отправляются POST-запросом на этот адрес, а не через SMTP. |
CUSTOM_POST_SERVER_LOGIN |
Строка | Пусто | Логин для Basic-аутентификации на HTTP-сервере отправки почты. |
CUSTOM_POST_SERVER_PASSWORD |
Строка | Пусто | Пароль для Basic-аутентификации на HTTP-сервере отправки почты. Значение скрыто в форме редактирования. |
Формат HOTKEYS
Горячие клавиши РМО. Сочетание записывается как модификаторы и клавиша через +, по образцу значений по умолчанию.
Значение по умолчанию:
{
"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
Прокси-серверы для исходящих запросов. Ключ верхнего уровня определяет назначение прокси:
-
channels— запросы к API каналов общения; -
fcm— Firebase Cloud Messaging (пуш-уведомления Android); -
apns— Apple Push Notification service (пуш-уведомления iOS); -
hpk— Huawei Push Kit.
Пример:
{
"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.