# Общие настройки

Настройки компании, языка и часового пояса, тайм-ауты HTTP-запросов к внешним сервисам, проверка доступности ботов и квота запросов к Stored Data API.

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

## Общие { #general }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `MULTILANG` | Логический | Включено | Включает многоязычность: язык виджета берётся из настроек размещения, а если там язык не задан — из `DEFAULT_LANG`. При выключенной настройке всегда используется `DEFAULT_LANG`.<br>В интерфейсе: «Настройки» → «Общие» → «Возможности». |
| `DEFAULT_LANG` | Строка | `ru` | Язык аккаунта по умолчанию: язык виджета и автоматических сообщений, если язык посетителя не определён или многоязычность выключена.<br>Допустимые значения — двухбуквенные коды поддерживаемых языков виджета, например `ru`, `en`, `ua`, `he`, `tr`, `de`, `es`, `fr`, `it`, `pl`, `pt`, `kz`, `uz`, `az`, `ar`.<br>В интерфейсе: «Настройки» → «Общие» → «Компания». |
| `COMPANY_NAME` | Строка | Пусто | Название компании. Используется в интерфейсе оператора, в письмах и в виджете.<br>В интерфейсе: «Настройки» → «Общие» → «Компания». |
| `HOSTURL` | Строка | Пусто | Адрес основного сайта компании (URL с протоколом), например `https://shop.example.local`. Передаётся в конфигурацию виджета и используется как ссылка на сайт.<br>В интерфейсе: «Настройки» → «Общие» → «Компания». |
| `COMPANY_EMAIL` | Строка | Пусто | Контактный адрес электронной почты компании для подстановки в тексты сообщений посетителю. |
| `COMPANY_TIMEZONE` | Строка | Пусто | Часовой пояс аккаунта в формате базы IANA, например `Europe/Moscow` или `Asia/Yekaterinburg`. Используется для отображения времени, расписаний и границ суток в статистике. Если значение пустое или некорректное, применяется часовой пояс, выбранный при регистрации аккаунта, а в hosted-режиме — значение параметра `ACCOUNT_TIME_ZONE` файла `.env` (см. [Основные параметры и безопасность](https://webim.ru/kb/11.0/settings/env/general.html#mode)).<br>В интерфейсе: «Настройки» → «Общие» → «Компания». |
| `COMPANY_LOGO_FILE_ID` | Целое число или пусто | Не задано | Идентификатор загруженного файла логотипа компании. Значение заполняется автоматически при загрузке логотипа в интерфейсе; вручную его не меняют.<br>В интерфейсе: «Настройки» → «Общие» → «Компания». |
| `RECAPTCHA3_SITE_KEY` | Строка | Пусто | Публичный ключ (site key) reCAPTCHA v3 для формы регистрации нового аккаунта. Используется только в облаке, где доступна самостоятельная регистрация. |
| `RECAPTCHA3_SECRET` | Строка | Пусто | Секретный ключ reCAPTCHA v3 для серверной проверки формы регистрации. Пустое значение отключает проверку. Используется только в облаке.<br>Значение скрыто в форме редактирования. |

## HTTP-таймауты { #http-timeouts }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `HTTP_CHANNEL_TIMEOUT` | Длительность | 3 секунды<br>`00:00:03` | Тайм-аут HTTP-запросов к API каналов (Telegram, Viber, ВКонтакте и других). |
| `HTTP_WEBHOOK_TIMEOUT` | Длительность | 5 секунд<br>`00:00:05` | Тайм-аут HTTP-запросов к внешним обработчикам: обработчикам событий диалога и обработчикам исходящих сообщений каналов. |
| `HTTP_FILE_DOWNLOAD_TIMEOUT` | Длительность | 15 секунд<br>`00:00:15` | Тайм-аут скачивания файлов из внешних источников, например вложений из каналов. |
| `HTTP_PUSH_SERVICE_TIMEOUT` | Длительность | 3 секунды<br>`00:00:03` | Тайм-аут HTTP-запросов к сервисам пуш-уведомлений (FCM, Huawei Push Kit, APNs). |
| `TIMEOUT_FOR_REQUEST_TO_EXTERNAL_BOT` | Длительность | 5 секунд<br>`00:00:05` | Тайм-аут запроса к API внешнего бота (версии 1 и 2). |
| `BSS_REQUEST_TIMEOUT` | Длительность | 10 секунд<br>`00:00:10` | Тайм-аут HTTP-запроса к API бота BSS. |
| `STC_REQUEST_AWAITING_TIMEOUT` | Длительность | 30 секунд<br>`00:00:30` | Тайм-аут запроса к боту ЦРТ. |
| `ROBOT_AVAILABILITY_CHECK_INTERVAL` | Длительность | 1 минута<br>`00:01:00` | Интервал между проверками доступности бота (ЦРТ, внешний API, BSS) в штатном режиме. |
| `ROBOT_AVAILABILITY_CHECK_INTERVAL_LONG` | Длительность | 5 минут<br>`00:05:00` | Интервал между проверками доступности бота после серии ошибок (см. `ROBOT_AVAILABILITY_CHECK_LIMIT_OF_REPEATED_ERRORS`). |
| `ROBOT_AVAILABILITY_CHECK_LIMIT_OF_REPEATED_ERRORS` | Целое число | 5 | Количество неудачных проверок доступности бота подряд, после которого проверки выполняются с интервалом `ROBOT_AVAILABILITY_CHECK_INTERVAL_LONG`. |
| `ROBOT_AVAILABILITY_CHECK_REQUEST_TIMEOUT` | Длительность | 10 секунд<br>`00:00:10` | Максимальное время ожидания ответа при проверке доступности бота. |
| `REQUEST_LOG_ENABLED` | Логический | Выключено | Диагностическая настройка. Сохраняет последние 10 исходящих HTTP-запросов к внешним ботам и суфлёрам на одни сутки. Тела запросов содержат персональные данные посетителей — включайте только для отладки. |
| `ENABLE_EXTERNAL_ID` | Логический | Выключено | Показывает в интерфейсе поле внешнего идентификатора канала и размещения. |

## API-квоты { #api-quotas }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `API_QUOTA` | JSON-объект | `{"period": "0:00:01", "max_requests": 5}` | Квота запросов к Stored Data API по умолчанию для одного сотрудника: не более `max_requests` запросов за период `period`.<br>Формат: `{"period": "0:00:01", "max_requests": 5}`. Период задаётся в формате длительности `ЧЧ:ММ:СС`, `max_requests` — целое число не меньше 1. |

---

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