Документация › Проект и бот › Продвинутые настройки
Продвинутые настройки бота
Помимо промпта, поведение бота тонко настраивается, как он разбивает ответы, ждёт ли, пока клиент допишет, в какие часы работает, как реагирует на оператора, что делает со спамом. Эта статья: карта всех рычагов.
⏱ 11 мин · 👤 для владельца · 🟢 live
За 30 секунд:
- Бот «печатает по частям», ждёт, пока клиент допишет, может работать по расписанию, уступать оператору, защищаться от спама.
- Всё это, настройки проекта (
agent_config), у каждой есть разумное значение по умолчанию.- Трогай по необходимости: дефолты подобраны так, чтобы работало «из коробки».
📍 Где найти. Все эти настройки: в проекте → «Настройки бота» → раскрывающийся блок «Расширенные настройки» внизу страницы (там же лимиты истории диалогов). Выбор модели ИИ переехал наверх, в основные настройки: это решение про качество ответов и про цену каждого сообщения, прятать его за раскрывашкой неправильно.
Ответы: разбивка и темп
| Настройка | По умолчанию | Что делает |
|---|---|---|
split_messages | вкл | разбивать длинный ответ на несколько коротких сообщений |
split_delay_seconds | 4 сек | пауза между частями (эффект печатания) |
split_threshold | 300 симв. | с какой длины начинать разбивать |
split_max_length | 500 симв. | макс. длина одной части |
split_max_parts | 3 | макс. число частей |
quote_client_message | вкл | первый пузырь ответа привязан к сообщению клиента, как «Ответить» в WhatsApp: у пачки цитируется последнее, у голосового или фото само голосовое или фото |
💡 Разбивка делает бота «живее»: клиент видит несколько коротких реплик вместо стены текста. Подробнее про механику: JSON-ответ бота.
Буферизация: дождаться, пока клиент допишет
Клиенты часто пишут мысль несколькими сообщениями подряд («Здравствуйте» / «хочу записаться» / «на завтра»). Чтобы бот не отвечал на каждое по отдельности, есть буфер:
| Настройка | По умолчанию | Что делает |
|---|---|---|
buffer_delay_seconds | 1 сек (у нового проекта 7 сек) | сколько ждать тишины, когда клиент пишет очередью; одиночное сообщение отвечается быстрее |
buffer_delay_media_seconds | 5 сек (у нового проекта 7 сек) | ожидание для медиа (фото/голос) |
Бот ждёт паузы в наборе и отвечает на всё разом, как живой человек.
Кому отвечает бот
Одна настройка (engage_mode) с тремя взаимоисключающими вариантами. Живёт на вкладке «Настройки бота», карточка «Кому отвечает бот» сразу под статусом бота (до 8 сентября 2026 пряталась в «Расширенных настройках», и её там не находили).
| Вариант | Кому бот отвечает |
|---|---|
| Только новым обращениям | Тем, кто написал впервые после подключения номера. Контакты, которые были в телефоне раньше, остаются за вами: их сообщения видны в «Диалогах», но бот в них не пишет |
| Всем, кто напишет (у нового проекта) | Плюс клиентам, которые были в телефоне до подключения. Переключение сразу возвращает бота в диалоги, которые он раньше пропустил как «старый контакт» (кроме тех, где вы писали сами в последние полчаса), и дальше он отвечает в них, когда клиент пишет снова |
| Только лидам с рекламы | Только тем, кто пришёл с рекламы «Написать в WhatsApp» (Click-to-WhatsApp). Для номера, где параллельно работают живые менеджеры: обычные и личные чаты бот не трогает, показывает их вам без ответа |
С 14 сентября 2026 новый проект стартует в режиме «Всем, кто напишет»: человек, подключивший номер, ждёт, что бот ответит всем, и молчание в половине чатов читается как поломка. Проекты, созданные раньше, остаются в режиме «Только новым обращениям», пока владелец его не сменит. Если рабочий номер это ещё и личная переписка, переключи на «Только новым обращениям»: в мягком режиме бот ответит и знакомым, и подрядчикам. В строгом режиме в диалоге со старым контактом кабинет показывает, что включён строгий режим, и кнопку включить бота здесь.
Что важно знать про режим «Всем, кто напишет»:
- переключение ничего не рассылает: оно только снимает паузу с пропущенных диалогов, а пишет бот лишь в ответ на следующее сообщение клиента;
- бот не отличает давнего клиента от личного контакта. Если номер рабочий и личный одновременно, он ответит и знакомым;
- чаты, где вы отвечаете сами, бот по-прежнему уступает вам (пауза при ответе оператора), а диалоги, из которых бота убрали руками или которые закрыты передачей менеджеру, режим не будит;
- расход баланса вырастет: старая база это дополнительные диалоги.
На сообщения, отправленные до подключения номера, бот не отвечает ни в одном режиме. Иначе после каждого сканирования QR он разослал бы ответы на старую переписку, а WhatsApp блокирует номера именно за такой всплеск.
Настройки рекламного фильтра
| Настройка | По умолчанию | Что делает |
|---|---|---|
engage_mode | all (только новым обращениям); у нового проекта existing_too | existing_too = всем, кто напишет; ad_gated = только рекламные лиды |
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 | выкл | не паузить на первом сообщении оператора |
pause_ai_after_answered_call | вкл | состоявшийся входящий звонок выключает бота в этом чате (звонок, который сделали вы сами, WhatsApp платформе не показывает, см. ниже) |
exception_phrases | - | фразы-исключения, после которых пауза не ставится |
auto_resume_enabled + auto_resume_* | выкл | бот сам вернётся в перехваченный диалог: когда вы столько не пишете в этот чат, а клиент напишет снова, бот ответит ему. Первым бот не пишет |
resume_message | «Добрый день!» | текст для редких служебных пауз (спам-защита, обрыв канала), которые снимает крон. После паузы оператора приветствие в тишину не уходит |
Позвонили клиенту сами: как выключить бота
Если клиент позвонил вам и вы взяли трубку, бот в этом чате замолкает сам.
Если звонили вы, бот продолжит отвечать, и это не сбой настройки. WhatsApp сообщает нам только про входящие звонки: исходящий вызов с вашего телефона до платформы не доходит вовсе, поэтому узнать о таком разговоре ей физически неоткуда.
Рабочий способ занимает секунду: после разговора напишите что-нибудь в этот же чат («созвонились», «всё обсудили», что угодно). Бот увидит, что в диалог пришёл живой человек, и замолчит по обычному правилу перехвата. Это то же самое, что происходит, когда вы отвечаете клиенту руками.
Второй способ, если писать не хочется: откройте диалог в кабинете и нажмите кнопку AI ON в шапке переписки, она переключится в AI OFF.
Три функции про остановки («Остановить диалог», «Отложить дожимы», «Отключить дожимы») стоят у каждого проекта с рождения и живут в разделе «Функции»: там же их можно выключить, поправить описание «когда вызывать» или удалить.
Подробно про перехват, Диалоги; про три функции, Функции, разделы 7.8-7.10.
Расписание работы (рабочие часы)
| Настройка | По умолчанию | Что делает |
|---|---|---|
schedule_enabled | выкл | включить рабочие часы |
schedule | Пн-Пт 09:00-20:00, Сб 09:00-18:00, Вс выкл | график по дням |
timezone | пояс браузера при создании (иначе Asia/Almaty) | часовой пояс проекта: задаётся во вкладке «Общие», по нему живут расписание, дожимы и весь кабинет (время сообщений, фильтры, графики) |
offline_message | дежурный текст | автоответ вне рабочих часов |
Вне рабочих часов бот не тратит токены: сохраняет сообщение клиента (оператор увидит его в CRM) и один раз на диалог шлёт автоответ «сейчас нерабочее время».
Память диалога
| Настройка | По умолчанию | Что делает |
|---|---|---|
history_message_limit | 30 | сколько последних сообщений бот «помнит». В диалоге, где писал оператор, бот видит до 200 сообщений: после включения он понимает разговор, который вёл человек |
history_time_limit | 2 недели (у нового проекта без ограничения) | за какой период берётся история |
Защита от спама
| Настройка | По умолчанию | Что делает |
|---|---|---|
spam_protection_enabled | выкл (у нового проекта вкл) | включить лимиты |
spam_message_limit / spam_duration_seconds | 5 / 60 сек (у нового проекта 30 / 60 сек) | сколько сообщений за окно допустимо |
spam_daily_limit | 100 (у нового проекта 300) | макс. сообщений в день от одного |
spam_response_message | «Пожалуйста, подождите…» | ответ при срабатывании |
spam_repeat_threshold | 3 (у нового проекта 5) | сколько одинаковых сообщений подряд считать спамом |
spam_auto_block | вкл (у нового проекта выкл) | при срабатывании выключить бота на диалоге и пометить лида проигранным |
⚠️ Автоблок срабатывает и на живом человеке: при пороге 3 три «ок» подряд за разговор уже считаются спамом, и бот на этом диалоге выключается, пока его не включат вручную. Поэтому новому проекту защита включена с порогами под флуд и без автоблока: сработав, бот пропускает ответ, а не теряет клиента.
Распознавание медиа
| Настройка | По умолчанию | Что делает |
|---|---|---|
recognize_audio | вкл | расшифровывать голосовые |
recognize_images | вкл | «видеть» картинки |
recognize_pdf | вкл | читать PDF |
recognize_documents | вкл | читать документы (DOCX и т.п.) |
⚠️ Распознавание голоса и картинок тратит баланс (это отдельная обработка). Если не нужно, выключи. См. Сколько стоит сообщение.
Запись на приём (календарь)
Настройки записи живут не здесь, а внутри самой функции записи: открой Функции → функцию записи → её конфиг. Там задаются длительность приёма (по умолчанию 60 мин), горизонт показа свободных окошек (7 дней), рабочие часы и дни записи, перерыв между приёмами и минимальное предупреждение (60 мин).
⚠️ Раньше эти же параметры дублировались настройками проектаcalendar_*. Их убрали 2026-06-13, потому что редактор писал в одно место, а бот читал другое, и половина настроек молча не работала. Сейчас источник один, конфиг функции. Если встретишьcalendar_*в старых заметках, это уже мёртвые ключи.
Подробно: Запись на приём и Google Календарь.
Простыми словами
Думай об этих настройках как о «характере» бота помимо промпта. Можно сделать так, чтобы он отвечал короткими репликами, как в живом чате, а не стеной текста. Можно научить его не торопиться с ответом, пока клиент дописывает мысль в несколько сообщений. Можно задать рабочие часы, и ночью он будет вежливо отвечать «мы на связи с утра», не тратя при этом деньги. Можно настроить, чтобы он уступал, как только в чат заходишь ты, и сам возвращался к работе через заданное время.
Хорошая новость: всё это уже настроено по уму «из коробки». Лезть туда стоит, только когда хочешь что-то конкретное, например, включить рабочие часы или защиту от спама. Остальное спокойно оставляй как есть.
Дальше: → Обзор каналов
Связано: Системный промпт · Выбор модели · Дожимы · Диалоги
Не получилось? → Бот не отвечает