# Каналы, боты и опросы

Настройки каналов общения, обработчиков событий диалога, ботов первой линии (сценарный бот, ЦРТ, BSS, внешний API), тайм-аутов диалогов с ботами, опросов и суфлёров.

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

## Каналы { #channels }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `WHATSAPP_GUPSHUP_ALLOWED_FILE_TYPES` | Список строк | См. [ниже](#default-whatsapp-gupshup-allowed-file-types) | Медиатипы файлов, которые разрешено отправлять в канал WhatsApp через Gupshup. |
| `SHOW_CHANNEL_IDS_IN_SETTINGS` | Логический | Выключено | Показывает идентификаторы каналов в настройках каналов. |
| `DISABLED_CHANNEL_TYPES` | Список строк | См. [ниже](#default-disabled-channel-types) | Типы каналов, скрытые в интерфейсе.<br>Коды типов: `apple_chat`, `avito`, `custom`, `email`, `email_imap`, `fb`, `fb_webim`, `instagram`, `instagram_webim`, `line`, `max`, `odnoklassniki`, `seventech`, `telegram`, `viber`, `vk`, `web`, `whatsapp_360dialog`, `whatsapp_gupshup`, `whatsapp_infobip`, `whatsapp_vonage`. |
| `TELEGRAM_BOT_API_URL` | Строка | Пусто | Адрес собственного сервера Telegram Bot API для каналов Telegram, в настройках которых не задан свой адрес. Пустое значение — используется адрес из одноимённого параметра файла `.env` (см. [Почта и внешние сервисы](https://webim.ru/kb/11.0/settings/env/integrations.html#telegram)), а если он не задан — `api.telegram.org`. |
| `TELEGRAM_BOT_API_SSL_VERIFY_SKIP` | Логический | Выключено | Отключает проверку SSL-сертификата при обращении к серверу Telegram Bot API для каналов, в настройках которых этот параметр не задан явно. Проверку также отключает одноимённый параметр файла `.env`. Используйте только для собственного сервера Bot API с самоподписанным сертификатом. |
| `TELEGRAM_RATING_DESCENDING` | Логический | Включено | Порядок кнопок оценки в Telegram: при включённой настройке — от 5 к 1, при выключенной — от 1 к 5. |
| `TELEGRAM_POLLING_INTERVAL` | Длительность | 10 секунд<br>`00:00:10` | Интервал опроса Telegram (метод `getUpdates`) для каналов, работающих в режиме опроса. |
| `LINE_QUICK_REPLY_POSTBACK` | Логический | Выключено | Отправляет кнопки в канале LINE (клавиатура бота, выбор отдела, опрос) как действия postback. При выключенной настройке нажатие кнопки приходит как сообщение посетителя с текстом кнопки. |
| `EMAIL_IMAP_POLLING_INTERVAL` | Длительность | 1 минута<br>`00:01:00` | Интервал опроса почтовых ящиков IMAP в каналах электронной почты. |
| `CHANNEL_PROBE_INTERVAL` | Длительность | 5 минут<br>`00:05:00` | Интервал фоновой проверки состояния каналов для страницы состояния системы. |
| `TELEGRAM_PENDING_UPDATES_ALERT_THRESHOLD` | Целое число | 100 | Количество необработанных обновлений в Telegram-канале, при превышении которого на странице состояния системы показывается предупреждение. |

## Обработчики событий (вебхуки) { #webhooks }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `CHAT_STARTED_HANDLER_URL` | Строка | Пусто | Адрес обработчика события начала диалога, например `https://crm.example.local/webim/chat-started`. Пустое значение — событие не отправляется. Задаётся на странице «Интеграции».<br>Зависит от тарифной возможности `api`: без неё действует пустое значение. |
| `CHAT_ASSIGNED_HANDLER_URL` | Строка | Пусто | Адрес обработчика события назначения диалога на оператора. Пустое значение — событие не отправляется.<br>Зависит от тарифной возможности `api`: без неё действует пустое значение. |
| `CHAT_CLOSED_HANDLER_URL` | Строка | Пусто | Адрес обработчика события закрытия диалога. Пустое значение — событие не отправляется.<br>Зависит от тарифной возможности `api`: без неё действует пустое значение. |
| `CHAT_EVENT_HANDLERS_VERSION` | Целое число | 1 | Версия формата данных, отправляемых обработчикам событий диалога. Допустимые значения — от `1` до `5`: версии 1–3 — данные формы с контрольной суммой, версия 4 — данные формы с подписью HMAC, версия 5 — JSON с подписью HMAC в заголовках. |
| `CHAT_EVENT_HANDLERS_ENSURE_ASCII` | Логический | Выключено | Экранирует символы Unicode в JSON, отправляемом обработчикам событий диалога. При выключенной настройке JSON передаётся в UTF-8. |
| `CHAT_EVENT_HANDLERS_SIGNATURE_KEY_EXPIRATION` | Длительность | 180 дней<br>`180 00:00:00` | Срок действия приватного ключа для подписи запросов к обработчикам событий. |

## Боты { #bots }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `ENABLE_EXTERNAL_BOT_SET_CATEGORY` | Логический | Выключено | Разрешает внешнему боту первой линии назначать категорию диалогу. |
| `DEMO_VISITOR_REQUEST_HANDLER_ENABLED` | Логический | Выключено | Включает служебный обработчик, который выдаёт данные тестовых посетителей для демонстрационной страницы виджета. |
| `SCENARIO_ROBOT_LINK_BUTTONS_FIRST` | Логический | Выключено | Показывает кнопки-ссылки сценарного бота выше остальных кнопок в диалоге. |
| `SEND_HIDDEN_PHRASE_TO_ROBOT` | Логический | Выключено | Отправляет боту (ЦРТ или внешний API) скрытую фразу из настроек размещения при назначении диалога на бота. |
| `REQUEST_CONTACTS_ON_ROBOT_ASSIGN_FOR_TELEGRAM` | Логический | Выключено | При назначении диалога на бота (ЦРТ или внешний API) запрашивает у посетителя Telegram номер телефона, если он не указан. |
| `ROBOT_AWAITING_ENABLED` | Логический | Выключено | Включает действия при тайм-ауте ответа бота (ЦРТ, внешний API, BSS). Действие задаётся настройкой `ROBOT_AWAITING_DEFAULT_EVENT`, время ожидания — `ROBOT_AWAIT_RESPONSE_TIMEOUT`.<br>В интерфейсе: «Настройки» → «Общие» → «Боты». |
| `ROBOT_AWAITING_DEFAULT_EVENT` | Выбор из списка | `send_keyboard` | Действие при тайм-ауте ответа бота. Допустимые значения: `no_redirect_to_agent` — закрыть диалог с задержкой `ROBOT_AWAIT_NO_REDIRECT_CLOSE_TIMEOUT`; `force_redirect_to_agent` — перевести диалог на оператора; `send_keyboard` — отправить посетителю клавиатуру с выбором действия.<br>В интерфейсе: «Настройки» → «Общие» → «Боты». |
| `STC_LOGIN_FROM_PHONE_ENABLED` | Логический | Выключено | Копирует телефон из данных, переданных сайтом при авторизации посетителя, в поле `login` блока `meta_data` запросов к боту ЦРТ, если поле `login` пустое. |
| `STC_META_EXTERNAL_DATA_FIELD_NAME` | Строка | `external_data` | Имя поля в блоке `meta_data` запросов к боту ЦРТ, в которое передаются дополнительные данные текущего сообщения. |
| `STC_SCENARIOS_UI_ENABLED` | Логический | Выключено | Показывает в интерфейсе оператора раздел сценариев ЦРТ и действие «Перевести на сценарий». |
| `ROBOT_EXTENDED_AWAITING_IN_QUEUE_ENABLED` | Логический | Выключено | Включает расширенное ожидание в очереди после перевода диалога от бота: кнопку «Вернуться к боту» и вопрос «Подключить к оператору?». Сроки задаются тайм-аутами `BEFORE_CONNECT_TO_OPERATOR_MESSAGE_TIMEOUT` и `CLOSE_CHAT_AFTER_CONNECT_TO_OPERATOR_MESSAGE_TIMEOUT`.<br>В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
| `ROBOT_EXTENDED_AWAITING_IN_QUEUE_TRANSFERRED_FROM` | Строка | Пусто | Значение поля `meta_data.transferred_from` в запросе к боту ЦРТ при нажатии посетителем кнопки «Вернуться к боту». Пустое значение — поле не передаётся.<br>В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
| `ROBOT_EXTENDED_AWAITING_IN_QUEUE_NEGATIVE_ANSWER_PHRASES` | Список строк | `[]` | Фразы, которые считаются отказом, если посетитель отвечает текстом на вопрос «Подключить к оператору?».<br>Пример: `["нет", "не надо"]`.<br>В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
| `TIMEOUT_FOR_ROBOT_WAKE_IDLE` | Длительность | `00:00:00` | Время бездействия посетителя в диалоге с ботом, после которого посетителю отправляется напоминание.<br>В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
| `TIMEOUT_FOR_CHAT_WITH_ROBOT_AUTO_CLOSE_IF_CHAT_IS_INACTIVE` | Длительность, не менее 1 с | 1 час<br>`01:00:00` | Время без активности, после которого закрывается диалог, начатый с ботом. Отключить тайм-аут нельзя.<br>В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
| `TIMEOUT_FOR_CHAT_REDIRECTED_TO_ROBOT_AUTO_CLOSE_IF_CHAT_IS_INACTIVE` | Длительность | `00:00:00` | Время без активности, после которого закрывается диалог, переведённый на бота. Значение `0` — применяется `TIMEOUT_FOR_CHAT_WITH_ROBOT_AUTO_CLOSE_IF_CHAT_IS_INACTIVE`.<br>В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
| `ROBOT_AWAIT_RESPONSE_TIMEOUT` | Длительность | 30 секунд<br>`00:00:30` | Время ожидания ответа бота (ЦРТ, внешний API, BSS).<br>В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
| `ROBOT_AWAIT_NO_REDIRECT_CLOSE_TIMEOUT` | Длительность | `00:00:00` | Задержка закрытия диалога при действии `no_redirect_to_agent` (см. `ROBOT_AWAITING_DEFAULT_EVENT`).<br>В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
| `BEFORE_CONNECT_TO_OPERATOR_MESSAGE_TIMEOUT` | Длительность | `00:00:00` | Время ожидания в очереди до вопроса «Подключить к оператору?» (см. `ROBOT_EXTENDED_AWAITING_IN_QUEUE_ENABLED`).<br>В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
| `CLOSE_CHAT_AFTER_CONNECT_TO_OPERATOR_MESSAGE_TIMEOUT` | Длительность | `00:00:00` | Время после вопроса «Подключить к оператору?», по истечении которого диалог закрывается, если посетитель не ответил.<br>В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
| `ADDITIONAL_INFO_TEXTS` | JSON-объект | См. [ниже](#default-additional-info-texts) | Тексты блока дополнительной информации от бота в истории диалога. Пустое значение поля — используется стандартный текст.<br>Поля: `without_bot_text` — диалог прошёл без бота; `nothing_to_show_text` — нет данных для показа; `error_text` — ошибка загрузки или отображения. |

## Опросы { #surveys }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `SURVEYS` | Логический | Включено | Включает отправку опросов посетителям по окончании диалога.<br>Зависит от тарифной возможности `surveys`: без неё действует значение «Выключено». |
| `DEFAULT_SURVEY_TIMEOUT` | Длительность | 1 час<br>`01:00:00` | Срок, в течение которого посетитель может пройти опрос, по умолчанию. |
| `DEFAULT_SURVEY_ID` | Целое число или пусто | Не задано | Идентификатор опроса, который используется по умолчанию. Пустое значение — опрос по умолчанию не задан. Обычно задаётся в интерфейсе при выборе опроса по умолчанию. |
| `DEFAULT_PROMPTER_ID` | Целое число или пусто | Не задано | Идентификатор суфлёра, который используется по умолчанию. Пустое значение — суфлёр по умолчанию не задан.<br>Зависит от тарифной возможности `prompters`: без неё ограничение не применяется. |
| `PROMPTER_REQUEST_TIMEOUT` | Длительность | 10 секунд<br>`00:00:10` | Тайм-аут запросов к внешним сервисам суфлёров. |
| `RATE_OPERATOR` | Логический | Включено | Разрешает посетителям оценивать операторов. |

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

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

### WHATSAPP_GUPSHUP_ALLOWED_FILE_TYPES { #default-whatsapp-gupshup-allowed-file-types }

```json
[
  "image/png", "image/jpeg", "video/mp4", "application/pdf"
]
```

### DISABLED_CHANNEL_TYPES { #default-disabled-channel-types }

```json
[
  "fb", "fb_webim", "instagram", "instagram_webim"
]
```

### ADDITIONAL_INFO_TEXTS { #default-additional-info-texts }

```json
{
  "without_bot_text": null,
  "nothing_to_show_text": null,
  "error_text": null
}
```

---

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