Документация › Проект и бот › JSON-ответ бота
JSON-ответ бота (статусы, стадии, флаги)
Обновлено 3 октября 2026 г.
[для продвинутых]Бот отвечает структурированным JSON, а не голым текстом: текст ответа + что он понял про клиента (имя, телефон, стадия, статус лида). Эта статья, что внутри и зачем.
⏱ 8 мин · 👤 для разработчика и любопытного владельца · 🟢 live
За 30 секунд:
- Бот возвращает JSON, не «голый текст»: поле
answer(ответ) + метаданные диалога.- Из JSON платформа достаёт: имя/телефон/email клиента, стадию воронки, статус лида, нужно ли продолжать диалог.
- Никакого стриминга: ответ приходит целиком; «эффект печатания» делается разбивкой на части на стороне клиента.
- Удалённые поля (
selected_service,services) бот иногда всё ещё шлёт, платформа их молча выкидывает.
Зачем боту JSON, а не текст
Если бы бот возвращал просто текст, платформа не знала бы, что произошло в разговоре, как зовут клиента, на каком он этапе, стоит ли заводить лида. Поэтому модель отвечает структурой: текст для клиента плюс «понятое» про диалог. Это и позволяет автоматически заполнять карточку лида, двигать стадию воронки, решать про дожимы.
Поля ответа
Ответ проверяется по схеме (ai-response-schema.ts). Основные поля:
| Поле | Тип | Что значит |
|---|---|---|
answer | строка (обязательно) | основной текст ответа клиенту |
message_parts | массив строк | ответ, разбитый на части (эффект печатания) |
client_name | строка | имя клиента, если бот его узнал |
phone | строка | телефон, если назвали |
email | строка | email, если назвали |
stage | строка | стадия воронки (greeting…done) |
lead_status | строка | статус лида |
summary | строка | краткое резюме разговора для карточки лида |
full_data | объект | произвольные собранные поля (кастомные данные) |
deal_value | число или строка | сумма сделки, названную клиентом в разговоре («полтора миллиона» тоже понимается). Пишется в карточку лида, только вверх: случайно занизить сумму бот не может |
deal_currency | kzt / usd | валюта суммы. Если бот её не назвал, определяется по маркеру в самом значении ($, usd, «долл»), иначе тенге |
triggered_events | массив строк | служебная запись «какие функции реально вызвались в этом ответе и чем закончились» (до 50). Заполняет платформа, а не бот: она подставляет туда факт вызова с исходом, а на следующем ходу бот читает эту запись как правду. Раньше список писал сам бот, и он ошибался в обе стороны: то забывал записать вызов и звал функцию второй раз, то записывал вызов, которого не было, и уверял клиента, что заявка уже у менеджера |
buttons | массив | кнопки под ответом (только Telegram, до 8 после обрезки; в WhatsApp деградируют в текст) |
📌stageиlead_status, обычные строки, а не жёсткий список, потому что проект может задать свой набор стадий/статусов. Платформа проверяет значение по разрешённому набору проекта; если значение «чужое», пишет предупреждение и оставляет старое, а не ломает диалог. Если воронка у проекта выключена,stage/lead_statusиз ответа игнорируются.
🛑 Бот НЕ останавливает диалог сам. Раньше бот мог сам решить «разговор окончен» и уйти на паузу (поляcontinue_to_talk/stage=done): это убрали, потому что модель делала это преждевременно (замолкала прямо после записи, игнорируя следующий вопрос клиента). Теперь диалог завершается только явной функцией: «Остановить диалог» или любой функцией с галочкой «Завершать диалог после выполнения». Так бот всегда дообщается, пока вы сами (или функция) его не остановите.
Разбивка на части (эффект печатания)
Бот может прислать message_parts, несколько коротких сообщений вместо одного длинного. Платформа отправляет их по очереди с паузой между ними (4 секунды у всех проектов), создавая ощущение «человек печатает».
⚠️ Это НЕ стриминг. Ответ модели приходит целиком и сразу; «постепенность» это клиентская пауза (setTimeout) между уже готовыми частями. Стриминг в платформе не используется (он ломал бы подсчёт токенов и возвраты). Управление разбивкой: в продвинутых настройках (split_*).
Игнорируемые поля
Модель по привычке иногда возвращает selected_service / services: это поля удалённой фичи «Услуги» (убрана 2026-04-22). Схема их принимает и молча отбрасывает, чтобы старый «мусор» от модели не ломал разбор ответа. Это не ошибка.
Простыми словами
Когда бот отвечает, он отдаёт не фразу, а небольшую «анкету»: вот мой ответ клиенту, а вот что я про него понял, как зовут, какой телефон, на каком мы этапе разговора, считать ли его горячим лидом. Платформа читает эту анкету и сама заполняет карточку клиента, двигает его по воронке, решает, нужно ли потом напомнить о себе.
Тебе как владельцу в это лезть не нужно, всё работает само. Знать про это полезно в одном случае, если хочешь, чтобы бот точнее определял стадии и статусы под твой бизнес, опиши правила в промпте, и он будет аккуратнее заполнять эту «анкету».
Дальше: → Выбор AI-модели
Связано: Системный промпт · Стадии воронки · Лиды · Продвинутые настройки
Не получилось? → Бот не отвечает