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

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

Настройки каналов общения, обработчиков событий диалога, ботов первой линии (сценарный бот, ЦРТ, 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
}