Документация › Проект и бот › Продвинутые настройки
Продвинутые настройки бота
Помимо промпта, поведение бота тонко настраивается, как он разбивает ответы, ждёт ли, пока клиент допишет, в какие часы работает, как реагирует на оператора, что делает со спамом. Эта статья: карта всех рычагов.
⏱ 11 мин · 👤 для владельца · 🟢 live
За 30 секунд:
- Бот «печатает по частям», ждёт, пока клиент допишет, может работать по расписанию, уступать оператору, защищаться от спама.
- Всё это, настройки проекта (
agent_config), у каждой есть разумное значение по умолчанию.- Трогай по необходимости: дефолты подобраны так, чтобы работало «из коробки».
📍 Где найти. Все эти настройки: в проекте → вкладка «Бот» → раскрывающийся блок «Расширенные настройки» (вместе с выбором модели ИИ и лимитами истории). Отдельной вкладки «Продвинутое» больше нет.
Ответы: разбивка и темп
| Настройка | По умолчанию | Что делает |
|---|---|---|
split_messages | вкл | разбивать длинный ответ на несколько коротких сообщений |
split_delay_seconds | 2 сек | пауза между частями (эффект печатания) |
split_threshold | 300 симв. | с какой длины начинать разбивать |
split_max_length | 500 симв. | макс. длина одной части |
split_max_parts | 5 | макс. число частей |
💡 Разбивка делает бота «живее»: клиент видит несколько коротких реплик вместо стены текста. Подробнее про механику: JSON-ответ бота.
Буферизация: дождаться, пока клиент допишет
Клиенты часто пишут мысль несколькими сообщениями подряд («Здравствуйте» / «хочу записаться» / «на завтра»). Чтобы бот не отвечал на каждое по отдельности, есть буфер:
| Настройка | По умолчанию | Что делает |
|---|---|---|
buffer_delay_seconds | 1 сек | сколько ждать новых сообщений перед ответом |
buffer_delay_media_seconds | 5 сек | доп. ожидание для медиа (фото/голос) |
Бот ждёт паузы в наборе и отвечает на всё разом, как живой человек.
Только выбранная реклама (рекламный фильтр)
Для номера, где параллельно работают живые менеджеры, есть режим «Отвечать только на лидов с рекламы» (engage_mode): бот включается ТОЛЬКО в диалогах, пришедших с рекламы «Написать в WhatsApp» (Click-to-WhatsApp). Обычные и личные чаты бот не трогает, показывает их вам без ответа.
| Настройка | По умолчанию | Что делает |
|---|---|---|
engage_mode | все диалоги | «только реклама»: бот включается только на рекламных лидов |
engage_ad_ids | пусто | пусто = ЛЮБАЯ реклама; список = ТОЛЬКО перечисленные объявления |
В список можно вставлять (по одному в строке):
- ID объявления из Ads Manager (числа вида
1202…), самый надёжный способ: передаётся со 100% рекламных лидов и виден ещё до запуска рекламы; - ссылку на рекламный пост (
https://www.instagram.com/p/…/), тоже работает заранее, но у части лидов ссылка не передаётся (короткие fb.me-переходы).
Как настроить фильтр ДО запуска рекламы (передайте таргетологу):
- Создайте кампанию и объявления как обычно, запускать не обязательно, достаточно, чтобы объявления были созданы.
- В Ads Manager откройте вкладку «Объявления» → «Столбцы: настроить столбцы» → включите столбец «ID объявления» (Ad ID).
- Скопируйте ID нужных объявлений и вставьте их в поле настроек, по одному в строке.
- ⚠️ При дублировании объявления или перезапуске креатива у копии появляется новый ID: добавьте и его. Один и тот же креатив, запущенный дважды: это два разных объявления с разными ID и разными ссылками на пост.
ID уже пришедшего лида виден в его диалоге: карточка справа → блок «Источник, реклама». Лид, отсечённый фильтром, не пропадает, он сохраняется в CRM с пометкой для оператора, просто бот на него не отвечает.
Перехват оператором
| Настройка | По умолчанию | Что делает |
|---|---|---|
pause_on_operator | вкл | ставить ИИ на паузу, когда оператор пишет в чат |
ignore_first_operator_message | выкл | не паузить на первом сообщении оператора |
exception_phrases | - | фразы-исключения, после которых пауза не ставится |
auto_resume_enabled + auto_resume_* | выкл | авто-возврат ИИ через N дней/часов/минут оператора |
resume_message | «Добрый день!» | что бот пишет при авто-возврате |
Подробно про перехват, Диалоги.
Расписание работы (рабочие часы)
| Настройка | По умолчанию | Что делает |
|---|---|---|
schedule_enabled | выкл | включить рабочие часы |
schedule | Пн-Пт 09:00-20:00, Сб 09:00-18:00, Вс выкл | график по дням |
timezone | Asia/Almaty | пояс для расписания |
offline_message | дежурный текст | автоответ вне рабочих часов |
Вне рабочих часов бот не тратит токены: сохраняет сообщение клиента (оператор увидит его в CRM) и один раз на диалог шлёт автоответ «сейчас нерабочее время».
Память диалога
| Настройка | По умолчанию | Что делает |
|---|---|---|
history_message_limit | 30 | сколько последних сообщений бот «помнит» |
history_time_limit | 2 недели | за какой период берётся история |
Защита от спама
| Настройка | По умолчанию | Что делает |
|---|---|---|
spam_protection_enabled | выкл | включить лимиты |
spam_message_limit / spam_duration_seconds | 5 / 60 сек | сколько сообщений за окно допустимо |
spam_daily_limit | 100 | макс. сообщений в день от одного |
spam_response_message | «Пожалуйста, подождите…» | ответ при срабатывании |
Распознавание медиа
| Настройка | По умолчанию | Что делает |
|---|---|---|
recognize_audio | вкл | расшифровывать голосовые |
recognize_images | вкл | «видеть» картинки |
recognize_pdf | вкл | читать PDF |
recognize_documents | вкл | читать документы (DOCX и т.п.) |
⚠️ Распознавание голоса и картинок тратит баланс (это отдельная обработка). Если не нужно, выключи. См. Сколько стоит сообщение.
Запись на приём (календарь)
Если используешь Google Календарь, бот учитывает: calendar_slot_duration (длительность приёма, 60 мин), calendar_days_ahead (на сколько дней вперёд показывать, 7), рабочие часы и дни записи, calendar_min_notice_minutes (за сколько минимум записывать, 60).
Простыми словами
Думай об этих настройках как о «характере» бота помимо промпта. Можно сделать так, чтобы он отвечал короткими репликами, как в живом чате, а не стеной текста. Можно научить его не торопиться с ответом, пока клиент дописывает мысль в несколько сообщений. Можно задать рабочие часы, и ночью он будет вежливо отвечать «мы на связи с утра», не тратя при этом деньги. Можно настроить, чтобы он уступал, как только в чат заходишь ты, и сам возвращался к работе через заданное время.
Хорошая новость: всё это уже настроено по уму «из коробки». Лезть туда стоит, только когда хочешь что-то конкретное, например, включить рабочие часы или защиту от спама. Остальное спокойно оставляй как есть.
Дальше: → Обзор каналов
Связано: Системный промпт · Выбор модели · Дожимы · Диалоги
Не получилось? → Бот не отвечает