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

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

Настройки рассылок, 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.