Чеклист запуска — по порядку
0. Подготовка
- Telegram Premium + Business на аккаунте, куда пишут клиенты
- Готовый скрипт: что можно обещать, что запрещено, тексты «дословно»
- Решено: только ИИ-агент или Гибрид (сценарии + ИИ)
1. Режим
- Режим работы → ИИ-агент → Сохранить режим
2. Telegram
- Telegram → подключить Business
- Старые чаты не импортировать, если не хотите автоответы в архиве
- Папки создать в приложении Telegram (для вкладки «Папки TG»)
3. Поля агента
- Минимум: Роль, Цель, Логика, База знаний
- Первое сообщение — если нужно фиксированное приветствие
- Ссылки — если ведёте на оформление / оплату
4. Сохранить и протестировать
- Сохранить настройки агента
- Тест → режим «ИИ-агент» → пройти воронку как клиент
- Собрать prompt — проверить, что в промпте ваши правила
5. Бой
- Написать себе с другого номера в Business-чат
- Убедиться: один ответ на несколько сообщений подряд, ссылки уходят после этапа
Быстрый старт за 15 минут
Если нужно запустить «с нуля» без JSON — заполните только это:
- Роль: «Ты — консультант сервиса X. Отвечаешь коротко, по-русски, без смайликов.»
- Цель: «Довести до регистрации / заявки / оплаты по ссылке.»
- Логика: «Сначала узнай запрос → уточни 2–3 поля → объясни условия → спроси согласие → передай ссылку или специалисту.»
- Этапы воронки: четыре строки с номерами 1–4.
- База знаний: цены, сроки, что нельзя обещать, 2–3 готовых ответа на FAQ.
- Задержки: пауза сбора 4–6 сек.
Первое сообщение (пример):
Здравствуйте! Вы написали по поводу [продукт]. Подскажите, что именно вас интересует — условия, сроки или как оформить заявку?
Как работает ИИ-агент
Источник правды Только то, что вы заполнили в полях (и импортировали из JSON). Пустые поля в промпт не попадают — модель их «не видит».
Первое сообщение Текст из поля «Первое сообщение» уходит клиенту без ИИ, дословно, один раз в начале диалога.
Дальше Каждый ответ — решение модели по вашему промпту. Модель возвращает JSON, система выполняет действие.
Склейка Клиент прислал 3 сообщения за 2 секунды → ждём паузу (вкладка «Задержки») → в ИИ уходит один блок → клиент получает один ответ.
Ссылки ИИ не вставляет URL в текст сам. Ссылки из каталога отправляет система, когда этап воронки отмечен завершённым.
Папки Перемещение чатов по папкам Telegram — тоже автоматически по правилам, не текстом в ответе.
Формат ответа ИИ (JSON)
Модель должна вернуть JSON. Основные поля:
action — что сделать: reply (ответить), handoff (передать вам), close (закрыть диалог)
text — текст клиенту (при close часто пустой)
save — что запомнить: переменные, _ai_stage_done, archive_chat
handoff — true/false, дублирует смысл action
Обычный ответ:
{ "action": "reply", "text": "Понял. Подскажите город?", "save": { "step": "ask_city" }, "handoff": false }
Этап завершён — ссылка уйдёт сама:
{ "action": "reply", "text": "Отлично, сейчас пришлю ссылку на оформление.", "save": { "_ai_stage_done": "3" }, "handoff": false }
Передать менеджеру (клиенту часто ничего не пишем):
{ "action": "handoff", "text": "", "save": { "reason": "просит человека" }, "handoff": true }
Тихое закрытие (не подошёл по фильтру):
{ "action": "close", "text": "", "save": { "archive_chat": "true" }, "handoff": false }
Пропишите в Правилах решений (вкладка «Поведение»), когда какой action использовать.
Все поля — что куда писать
Вкладка «Промпт и логика»
- Описание — 2–4 предложения: кто вы, продукт, для кого.
- Роль — имя/роль бота, тон, границы («не юрист», «не обещай доход»).
- Стиль — длина, смайлики, канцелярит.
- Цель — финальное действие клиента.
- Логика — порядок шагов, что делать при отклонении.
- Этапы воронки — нумерованный список; номера нужны для ссылок и папок.
- Первое сообщение — фиксированный старт без ИИ.
Стоп-факторы / Примеры / Профиль / Этапы / Возражения — уточняют поведение; см. соответствующие вкладки в настройках.
Этапы (пример — онлайн-курс):
1. Уточнить цель обучения
2. Собрать имя и email
3. Рассказать программу и цену
4. Согласие на оплату / ссылка
База знаний — главный блок
Сюда — только факты и скрипты: цены, сроки, условия, запреты, тексты «скопировать дословно», FAQ, фильтры. Если пусто — модель будет додумывать.
Как структурировать: заголовки блоками === НАЗВАНИЕ ===, внутри — короткие пункты. Один блок — одна тема.
=== УСЛОВИЯ ПРОДУКТА ===
• Стоимость: от 4 990 ₽ / месяц
• Пробный период: 7 дней
• Возврат: по правилам оферты на сайте
• Не обещать гарантированный доход
=== FAQ ===
В: Можно оплатить картой?
О: Да, на странице оплаты.
=== ФИЛЬТР (тихий отказ) ===
Если клиент из другой страны и услуга только РФ → action close, text пустой, archive_chat true.
Дословные тексты помечайте: «ТЕКСТ ДОСЛОВНО» — модель должна копировать без перефразирования.
Каталог ссылок
ИИ не придумывает URL. После завершения этапа N система сама отправит строку из каталога с после_этапа:N.
Формат (одна ссылка на строку):
код | название для клиента | https://... | после_этапа:N
pay_main | Оплата курса | https://pay.example.com/course | после_этапа:4
partner_card | Партнёрская карта | https://bank.example/ref | после_этапа:3
- код — для логов, латиница без пробелов.
- название — подпись к сообщению со ссылкой.
- после_этапа — номер из «Этапов воронки» (с 1).
В логике и decision_rules: когда этап закрыт — ставить save._ai_stage_done равным номеру этапа, без URL в text.
Папки Telegram
- В приложении Telegram создайте папки: «Новые», «В работе», «Оплата», «Передано».
- В CRM: вкладка Папки TG → Обновить список папок — скопируйте ID.
- Правила: одна строка =
событие | id_папки.
new | 1
этап:2 | 3
этап:4 | 5
handoff | 6
new — новый чат. 1 или этап:1 — завершён этап 1. handoff — передан менеджеру. Чат добавляется в папку (не удаляется из других).
Задержки — зачем и какие значения
- Пауза для сбора сообщений (4–6 сек) — главная защита от тройных ответов. Клиент дописывает мысль → один запрос к ИИ.
- Первый ответ от/до — пауза перед самым первым ответом бота (0 = сразу после сбора).
- Следующие ответы 5–15 сек — «печатает…» между репликами.
- Доп. задержка на длинное сообщение — если клиент прислал простыню текста.
- Ночной режим — «молчать» или ответить через 20+ минут вне рабочего времени.
Рекомендация для живого тона:
сбор 5 сек · первый ответ 0–3 сек · следующие 8–12 сек
Тестирование перед запуском
1. Быстрый тест — вкладка «Тестировать» в настройках агента: одно сообщение → ответ.
2. Полный чат — меню Тест слева → переключатель ИИ-агент. Пройдите воронку как клиент.
Жёлтые блоки «Система» — служебные события (handoff, архив, папка, ссылка). Это не текст для клиента в Telegram.
Чек теста:
- Три «Привет» подряд → один ответ бота
- На вопрос из FAQ — ответ по базе знаний, без выдумок
- После согласия на этап — приходит ссылка (если настроен каталог)
- «Позовите менеджера» → handoff, клиенту может ничего не уйти
После любых правок: Сохранить настройки → сбросить тест (кнопка сброса в разделе «Тест»).
Импорт и экспорт JSON
Импорт — загрузить готовый набор полей одним файлом (от разработчика или свой бэкап).
- Вкладка Экспорт → Импорт → вставить или выбрать
.json
- Проверить поля в форме
- Сохранить настройки агента
- Прогнать Тест
Экспорт — скачать текущие настройки для бэкапа или переноса на другой аккаунт.
Собрать prompt — посмотреть итоговый текст для модели (отладка, не для редактирования каждый день).
Гибридный режим
Если в Режим работы выбран Гибрид:
- Сценарии — жёсткие шаги (сообщение, пауза, папка, развилка).
- ИИ — свободные ответы, когда клиент пишет не по скрипту.
Ниже настроек агента появится блок Настройки гибридного режима — когда подключать сценарий, когда ИИ, когда вернуться к ветке, когда handoff.
Сценарии настраиваются в разделе Сценарии (см. инструкцию там).
Пример мини-воронки (финансовый оффер)
Упрощённый пример для реферального продукта — скопируйте и замените на свои данные.
Цель: довести до перехода по партнёрской ссылке на оформление.
Этапы:
1. Уточнить продукт (карта / вклад / займ)
2. Собрать возраст и регион
3. Кратко условия из базы знаний
4. Согласие перейти к оформлению
Логика: не давать ссылку до этапа 4; на возражение «подумаю» — один уточняющий вопрос; на агрессию — handoff.
Пример диалога:
Клиент: Здравствуйте, интересует карта
Агент: Понял. Вам удобнее кэшбэк на покупки или бесплатное обслуживание?
Клиент: Кэшбэк
Агент: Ок. Сколько вам полных лет и в каком регионе оформляете?
…
Плохой пример (не делайте так): обещать «100% одобрение», давать ссылку в первом сообщении, задавать 5 вопросов сразу.
Частые проблемы
Инструкция пустая / не скроллится? Обновите страницу Ctrl+F5. Должны быть карточки с текстом. Если пусто — напишите в поддержку.
Три одинаковых ответа? Увеличьте «Пауза для сбора» до 5–6 сек; в тесте не жмите Enter пять раз подряд; сохраните настройки.
Выдумывает цены и условия? Добавьте факты в Базу знаний и запрет в Что нельзя говорить.
Ссылка не пришла? Проверьте каталог, номер этапа, что в ответе ИИ есть _ai_stage_done с нужным номером.
Чат не в папке? ID папки, правило события, тот же Telegram-аккаунт, что в разделе «Telegram».
Бот молчит в Telegram? Режим «ИИ-агент» сохранён? Business подключён? Это новый диалог? Есть подписка CRM?
После импорта JSON странно отвечает? Снова Сохранить → Собрать prompt → сбросить тест.