Каналы, боты и опросы
Настройки каналов общения, обработчиков событий диалога, ботов первой линии (сценарный бот, ЦРТ, BSS, внешний API), тайм-аутов диалогов с ботами, опросов и суфлёров.
Как читать таблицы и редактировать значения, описано в разделе Настройки в Constance.
Каналы
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
WHATSAPP_GUPSHUP_ALLOWED_FILE_TYPES |
Список строк | См. ниже | Медиатипы файлов, которые разрешено отправлять в канал WhatsApp через Gupshup. |
SHOW_CHANNEL_IDS_IN_SETTINGS |
Логический | Выключено | Показывает идентификаторы каналов в настройках каналов. |
DISABLED_CHANNEL_TYPES |
Список строк | См. ниже | Типы каналов, скрытые в интерфейсе. Коды типов: 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 (см. Почта и внешние сервисы), а если он не задан — 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 секунд00:00:10 |
Интервал опроса Telegram (метод getUpdates) для каналов, работающих в режиме опроса. |
LINE_QUICK_REPLY_POSTBACK |
Логический | Выключено | Отправляет кнопки в канале LINE (клавиатура бота, выбор отдела, опрос) как действия postback. При выключенной настройке нажатие кнопки приходит как сообщение посетителя с текстом кнопки. |
EMAIL_IMAP_POLLING_INTERVAL |
Длительность | 1 минута00:01:00 |
Интервал опроса почтовых ящиков IMAP в каналах электронной почты. |
CHANNEL_PROBE_INTERVAL |
Длительность | 5 минут00:05:00 |
Интервал фоновой проверки состояния каналов для страницы состояния системы. |
TELEGRAM_PENDING_UPDATES_ALERT_THRESHOLD |
Целое число | 100 | Количество необработанных обновлений в Telegram-канале, при превышении которого на странице состояния системы показывается предупреждение. |
Обработчики событий (вебхуки)
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
CHAT_STARTED_HANDLER_URL |
Строка | Пусто | Адрес обработчика события начала диалога, например https://crm.example.local/webim/chat-started. Пустое значение — событие не отправляется. Задаётся на странице «Интеграции».Зависит от тарифной возможности api: без неё действует пустое значение. |
CHAT_ASSIGNED_HANDLER_URL |
Строка | Пусто | Адрес обработчика события назначения диалога на оператора. Пустое значение — событие не отправляется. Зависит от тарифной возможности api: без неё действует пустое значение. |
CHAT_CLOSED_HANDLER_URL |
Строка | Пусто | Адрес обработчика события закрытия диалога. Пустое значение — событие не отправляется. Зависит от тарифной возможности 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 дней180 00:00:00 |
Срок действия приватного ключа для подписи запросов к обработчикам событий. |
Боты
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
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.В интерфейсе: «Настройки» → «Общие» → «Боты». |
ROBOT_AWAITING_DEFAULT_EVENT |
Выбор из списка | send_keyboard |
Действие при тайм-ауте ответа бота. Допустимые значения: no_redirect_to_agent — закрыть диалог с задержкой ROBOT_AWAIT_NO_REDIRECT_CLOSE_TIMEOUT; force_redirect_to_agent — перевести диалог на оператора; send_keyboard — отправить посетителю клавиатуру с выбором действия.В интерфейсе: «Настройки» → «Общие» → «Боты». |
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.В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
ROBOT_EXTENDED_AWAITING_IN_QUEUE_TRANSFERRED_FROM |
Строка | Пусто | Значение поля meta_data.transferred_from в запросе к боту ЦРТ при нажатии посетителем кнопки «Вернуться к боту». Пустое значение — поле не передаётся.В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
ROBOT_EXTENDED_AWAITING_IN_QUEUE_NEGATIVE_ANSWER_PHRASES |
Список строк | [] |
Фразы, которые считаются отказом, если посетитель отвечает текстом на вопрос «Подключить к оператору?». Пример: ["нет", "не надо"].В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
TIMEOUT_FOR_ROBOT_WAKE_IDLE |
Длительность | 00:00:00 |
Время бездействия посетителя в диалоге с ботом, после которого посетителю отправляется напоминание. В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
TIMEOUT_FOR_CHAT_WITH_ROBOT_AUTO_CLOSE_IF_CHAT_IS_INACTIVE |
Длительность, не менее 1 с | 1 час01:00:00 |
Время без активности, после которого закрывается диалог, начатый с ботом. Отключить тайм-аут нельзя. В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
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.В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
ROBOT_AWAIT_RESPONSE_TIMEOUT |
Длительность | 30 секунд00:00:30 |
Время ожидания ответа бота (ЦРТ, внешний API, BSS). В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
ROBOT_AWAIT_NO_REDIRECT_CLOSE_TIMEOUT |
Длительность | 00:00:00 |
Задержка закрытия диалога при действии no_redirect_to_agent (см. ROBOT_AWAITING_DEFAULT_EVENT).В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
BEFORE_CONNECT_TO_OPERATOR_MESSAGE_TIMEOUT |
Длительность | 00:00:00 |
Время ожидания в очереди до вопроса «Подключить к оператору?» (см. ROBOT_EXTENDED_AWAITING_IN_QUEUE_ENABLED).В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
CLOSE_CHAT_AFTER_CONNECT_TO_OPERATOR_MESSAGE_TIMEOUT |
Длительность | 00:00:00 |
Время после вопроса «Подключить к оператору?», по истечении которого диалог закрывается, если посетитель не ответил. В интерфейсе: «Настройки» → «Общие» → «Боты». Можно переопределить в настройках отдела. |
ADDITIONAL_INFO_TEXTS |
JSON-объект | См. ниже | Тексты блока дополнительной информации от бота в истории диалога. Пустое значение поля — используется стандартный текст. Поля: without_bot_text — диалог прошёл без бота; nothing_to_show_text — нет данных для показа; error_text — ошибка загрузки или отображения. |
Опросы
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
SURVEYS |
Логический | Включено | Включает отправку опросов посетителям по окончании диалога. Зависит от тарифной возможности surveys: без неё действует значение «Выключено». |
DEFAULT_SURVEY_TIMEOUT |
Длительность | 1 час01:00:00 |
Срок, в течение которого посетитель может пройти опрос, по умолчанию. |
DEFAULT_SURVEY_ID |
Целое число или пусто | Не задано | Идентификатор опроса, который используется по умолчанию. Пустое значение — опрос по умолчанию не задан. Обычно задаётся в интерфейсе при выборе опроса по умолчанию. |
DEFAULT_PROMPTER_ID |
Целое число или пусто | Не задано | Идентификатор суфлёра, который используется по умолчанию. Пустое значение — суфлёр по умолчанию не задан. Зависит от тарифной возможности prompters: без неё ограничение не применяется. |
PROMPTER_REQUEST_TIMEOUT |
Длительность | 10 секунд00:00:10 |
Тайм-аут запросов к внешним сервисам суфлёров. |
RATE_OPERATOR |
Логический | Включено | Разрешает посетителям оценивать операторов. |
Значения по умолчанию
Значения по умолчанию, которые не поместились в таблицы.
WHATSAPP_GUPSHUP_ALLOWED_FILE_TYPES
[
"image/png", "image/jpeg", "video/mp4", "application/pdf"
]
DISABLED_CHANNEL_TYPES
[
"fb", "fb_webim", "instagram", "instagram_webim"
]
ADDITIONAL_INFO_TEXTS
{
"without_bot_text": null,
"nothing_to_show_text": null,
"error_text": null
}