Обновлено: октябрь 2026
Если коротко, PRD-промпт для Telegram-бота это структурированный документ из 7 блоков, который вы один раз вставляете в Windsurf или Cursor, а на выходе получаете рабочий проект с командами, FSM-логикой и подключенной базой. Ниже разбираем по полочкам: что в этих блоках писать, какой стек просить у нейросети и где она чаще всего портит код, если описание задачи плавает.
TL;DR. Промпт PRD для Telegram-бота включает 7 обязательных блоков: роль бота, список команд, состояния FSM, технологический стек, схема БД, внешние интеграции, способ деплоя. Готовый шаблон в статье занимает около 500 слов. Связка Windsurf + aiogram 3 + SQLite собирается за один прогон, если PRD написан правильно.
Что такое PRD-промпт и зачем он нужен боту для бизнеса
PRD-промпт это техническое задание для нейросети, упакованное в один абзац. Без него AI-редактор сам решает архитектуру и часто решает не в ту сторону.
Чат боты для бизнеса в 2026 году делаются за вечер, но только если AI-редактор понимает рамки. PRD задает 7 рамок: роль, команды, состояния, стек, данные, интеграции, деплой. По исследованию автора канала Build with AI (июнь 2026), пропуск PRD на сложных проектах добавляет минимум 3-4 итерации правок.
В прототипировании PRD не нужен. Когда вы пишете «сделай мне эхо-бота» в Cursor, нейросеть угадает правильно в 9 случаях из 10. Проблемы начинаются дальше -> когда нужна FSM для опроса клиента, отдельная таблица для платежей, интеграция со Stripe и крон-задача для напоминаний.
В этом месте AI без рамок начинает выдумывать. Где-то возьмет старую версию aiogram, где-то поставит лишние библиотеки типа framer-motion (реальный кейс из видео по vibe-кодингу), где-то развалит структуру папок так, что через неделю в коде разобраться сложнее, чем переписать. PRD ставит ограждения заранее.
Для коммерческого бота это критично. Бот для продажи курсов, ии для создания тг бота консультанта, бот для записи в салон — все они держатся на FSM. Если состояния перепутаны, клиент вываливается из воронки на третьем сообщении.
Какие 7 блоков должны быть в PRD-промпте для Telegram-бота
Структура PRD по 7 блокам: роль бота, команды, FSM-сценарии, стек, схема БД, внешние API, деплой. Каждый блок занимает 3-5 предложений в промпте.
Минимальный рабочий PRD укладывается в 450-550 слов. Меньше -> нейросеть будет додумывать. Больше -> токены съедаются впустую, и AI хуже фокусируется. Все 7 блоков должны идти строго по порядку, потому что Claude Sonnet 4.6 и GPT-5.4 читают промпт сверху вниз и расставляют приоритеты по позиции.
Разберем каждый блок отдельно.
Блок 1. Роль бота
Одно предложение, кто такой бот и для кого. Не «универсальный помощник», а конкретно: «бот для записи на консультацию к косметологу, целевой пользователь — женщины 25-45, говорящие по-русски». От этого Windsurf будет выбирать tone of voice автоответов.
Блок 2. Команды и реплики
Список команд /start, /help, /cancel, /orders плюс ответ на каждую. Если ответ зависит от состояния пользователя — упомянуть это здесь. Не нужно писать готовые тексты сообщений, нужно описать смысл.
Блок 3. FSM-сценарии
Самый важный блок. Перечисляем состояния и переходы. Пример: «состояние ChoosingService -> пользователь видит inline-кнопки с услугами -> переход в EnteringDate -> ввод даты текстом -> EnteringPhone -> подтверждение -> запись в БД -> состояние сбрасывается». Это та логика, которую нейросеть никогда не угадает сама.
Блок 4. Технологический стек
Прямо называем: Python 3.12, aiogram 3.x, SQLAlchemy 2.x, SQLite для MVP или PostgreSQL для прода. Без этого AI выберет старую версию aiogram 2, которая в 2026 году уже архаична.
Блок 5. Схема БД
Перечисляем таблицы и ключевые поля. Не нужны типы данных в SQL-формате — достаточно: «таблица users (id, telegram_id, phone, registered_at), таблица orders (id, user_id, service, datetime, status)».
Блок 6. Внешние интеграции
API, которые бот должен дергать. CRM, платежи, рассылки, AI-модели. Если бот пишет ответы через DeepSeek или GPT — указываем модель и где брать ключ.
Блок 7. Деплой
Где будет жить бот. Railway, Render, VPS, локальный запуск. Это влияет на структуру .env, наличие Dockerfile и формат логов.
Где взять готовый шаблон PRD-промпта на 500 слов
Шаблон ниже копируется целиком и вставляется в чат Windsurf или Cursor. После вставки бот собирается за один-два прогона без ручного допиливания структуры.
Шаблон проверен на трех ботах из практики команды VibeCoderz — записи, опроса лидов и продажи курса. На двух из трех бот собрался с первого раза, на третьем понадобилась одна итерация по миграциям БД. Шаблон работает с Claude Sonnet 4.6 и Gemini 3.1 Pro одинаково хорошо.
Дальше — текст промпта. Меняйте только блоки в квадратных скобках, остальное оставляйте как есть.
Создай Telegram-бот по следующему ТЗ.
РОЛЬ. Бот для [тип бизнеса] помогает клиенту [главное действие].
Аудитория: [описание]. Tone: дружелюбный, на «вы», без эмодзи.
КОМАНДЫ. /start приветствует и показывает главное меню inline-кнопками.
/help выводит список возможностей. /cancel сбрасывает текущий FSM-сценарий.
/orders показывает историю заказов текущего пользователя.
FSM-СЦЕНАРИИ. Сценарий 1 «Заказ услуги»:
ChoosingService -> SelectingDate -> SelectingTime -> EnteringPhone
-> ConfirmingOrder -> Done. На каждом шаге есть кнопка «Назад»
и кнопка «Отмена». Сценарий 2 «Просмотр истории»:
ShowingOrders -> SelectingOrder -> ShowingDetails.
Состояние хранится в памяти aiogram (MemoryStorage для MVP,
Redis для прода).
СТЕК. Python 3.12, aiogram 3.13+, SQLAlchemy 2.0 в асинхронном режиме,
SQLite для разработки. Структура: bot/handlers, bot/keyboards,
bot/states, bot/db, main.py в корне. Роутеры разделены по сценариям.
БАЗА ДАННЫХ. Таблица users (id, telegram_id, name, phone, created_at).
Таблица orders (id, user_id, service_id, datetime, status, created_at).
Таблица services (id, name, price, duration).
Миграции через Alembic.
ИНТЕГРАЦИИ. Внешних API на старте нет.
Заложить точку расширения для подключения [CRM/платежей/AI].
Все ключи и токены через .env, никаких хардкодов.
ДЕПЛОЙ. Railway, запуск через polling.
Сгенерируй railway.toml и Dockerfile.
README с инструкцией: создать бота через @BotFather,
вставить токен в .env, запустить локально, потом задеплоить.
ТРЕБОВАНИЯ. Без сторонних UI-библиотек.
Логирование через стандартный logging в stdout.
Обработка ошибок в каждом хэндлере. Комментарии на русском.Подставьте свои данные в квадратные скобки и отправьте в чат. На выходе будет рабочий бот, который запускается одной командой python main.py.
Какой стек выбрать и почему aiogram 3 победил версию 2
Aiogram 3 в 2026 году дефолтный выбор. У него модульные роутеры, магические фильтры и контекстный bot instance. Aiogram 2 устарел и почти не обновляется.
Aiogram 3 принес три ключевых сдвига: роутеры вместо монолитного диспетчера, магические фильтры с типизацией, контекстный bot instance, который не нужно протаскивать руками через все функции. Старая версия 2 работала через lambda-фильтры и одинокий Dispatcher, в проектах больше 5-7 хэндлеров это превращалось в кашу.
Архитектурно aiogram 3 ведет себя как FastAPI или Django -> у него есть один центральный Dispatcher, который принимает апдейты от Telegram API, и роутеры-сателлиты, разносящие логику по фичам. Один роутер на регистрацию пользователя, другой на заказ услуги, третий на админ-команды. AI-редакторы это понимают и собирают папки правильно, если стек указан явно.
| Параметр | aiogram 2 | aiogram 3 |
|---|---|---|
| Структура | Монолитный диспетчер | Роутеры + диспетчер |
| Фильтры | Lambda-функции | Магические фильтры с типами |
| Bot instance | Передается вручную | Контекстный, инжектится |
| Версия Python | 3.7+ | 3.10+ |
| Совместимость с aiosqlite/SQLAlchemy 2 | Через костыли | Нативная |
| Поддержка в 2026 | Только багфиксы | Активная разработка |
В промпте писать просто «aiogram» опасно. AI может взять любую версию, и часто берет ту, на которой обучен корпус -> то есть aiogram 2. Поэтому в блоке СТЕК всегда явно указывайте «aiogram 3.13+».
Как FSM-логика держит клиента в воронке продаж
FSM (конечный автомат) фиксирует, на каком шаге сценария находится пользователь. Без FSM клиент путается, бот теряет контекст, продажа срывается на втором-третьем сообщении.
FSM хранит состояние пользователя между сообщениями. Когда клиент выбирает услугу, бот переходит в SelectingDate. Если в этот момент клиент пишет «как у вас с парковкой», бот не отвечает «выберите дату из меню» как тупой автоответчик, а отрабатывает вопрос отдельным хэндлером и возвращает обратно в нужное состояние. Без FSM это нереально.
Для бота продаж FSM это позвоночник воронки. Без нее каждый второй клиент сваливается на полпути. Если PRD-промпт описывает FSM-сценарии словесно, Windsurf сразу собирает класс состояний через StatesGroup и расставляет переходы по хэндлерам.
Пример простого сценария лидогенерации:
class LeadFlow(StatesGroup):
waiting_for_name = State()
waiting_for_phone = State()
waiting_for_problem = State()
confirming = State()Эти четыре состояния покрывают типовой опросник. В промпте достаточно описать их словами, а класс нейросеть напишет сама. Главное — не пропустить блок FSM-СЦЕНАРИИ в PRD, иначе AI напишет все хэндлеры на одном уровне без состояний, и бот будет реагировать на любое сообщение последним зарегистрированным обработчиком.
Сколько времени экономит готовый PRD на реальном проекте
Веб-версия NanaBanana собралась за 3 часа после выхода новой модели. Сам бот в Telegram, который дал 12 миллионов выручки, делался такими же короткими промптами с четкой структурой задачи.
Максим: «Когда мы делали GoBanana, веб-версию собрал за 3 часа после выхода модели. Суммарно на продукт ушло 6-8 часов работы. Telegram-бот NanaBanana — это 80 000+ подписчиков, 12 миллионов руб. выручки и ноль рублей на рекламу. Если бы я не описывал каждый сценарий в PRD-формате перед промптом, не было бы такой скорости. Сделал — получил цифру.»
Это работает в обе стороны. Уберите PRD -> и тот же бот соберется за два дня вместо одного вечера, потому что нейросеть будет три раза переписывать архитектуру под ваши уточнения. Грубо говоря, 30 минут на написание PRD экономят 4-6 часов отладки.
Кейс из практики ученика Александра Юркевича: MVP собран за месяц, за 2 недели получил 7 оплат по 3 000 руб = 21 000 руб, 430 посетителей, 1 600 просмотров, ноль рублей на рекламу. PRD-промпт там был такой же — про роль бота для продажи, FSM-сценарии, стек и БД.
Какие модели лучше работают с генерацией Telegram-бота
Claude Sonnet 4.6 универсальный выбор для большинства ботов. Gemini 3.1 Pro лучше для крупных проектов и сложных БД. DeepSeek V3.2 подходит, если нужно сделать дешево и не страшно за стиль кода.
На SWE-bench Claude Sonnet 4.6 дает 79.6%, Gemini 3.1 Pro — 80.6%, DeepSeek V3.2 — 72-74%. Цифры близкие, но на Telegram-ботах разница чувствуется. Sonnet точнее собирает FSM, Gemini лучше держит большие БД, DeepSeek работает за копейки, но иногда смешивает aiogram 2 и 3 в одном проекте.
| Модель | Цена за 1М токенов (in/out) | SWE-bench | Когда выбирать |
|---|---|---|---|
| Claude Sonnet 4.6 | $3 / $15 | 79.6% | Универсал, лучший FSM |
| Claude Opus 4.7 | $5 / $25 | 88.8% | Сложная архитектура, миграции |
| Gemini 3.1 Pro | $2 / $12 | 80.6% | Большой контекст, схема БД |
| GPT-5.4 | $2.5 / $15 | ~80% | Тесты, CI/CD, скрипты |
| DeepSeek V3.2 | $0.28 / $0.42 | 72-74% | Экономия, простые боты |
Для PRD-промпта на 500 слов размер модели почти не критичен. Все упирается в качество промпта. Бесплатный ии для создания телеграмм бота это миф -> либо вы платите за токены, либо за время на исправление кривого кода. Минимум на разовый запуск Sonnet уйдет 5-10 центов, что не сравнимо с часами отладки.
В Windsurf и Cursor модель переключается в настройках чата. Если бот сложный и в нем больше двух FSM-сценариев — переключайтесь на Opus 4.7 на финальный прогон. Это дороже, но архитектуру вывезет за один заход.
Какие ошибки убивают результат после первого промпта
Пять типовых провалов: пропуск FSM-блока, размытая роль бота, отсутствие версии библиотек, забытый деплой, попытка засунуть все в один файл.
Из аудита 30 проектов команды VibeCoderz за последние полгода: в 21 случае первая итерация валилась по одной из 5 причин. Все они связаны с тем, что в PRD не хватало конкретики. Чем расплывчатее блок, тем больше нейросеть додумывает -> и тем дальше уезжает от вашей задачи.
Первая ошибка -> пропуск FSM-сценариев. Человек пишет «бот для записи на услуги» и ждет, что AI догадается. AI догадается, но криво: запишет все хэндлеры на верхнем уровне без состояний, и бот будет реагировать на любое сообщение последним зарегистрированным обработчиком.
Вторая -> размытая роль. «Бот-помощник» -> это ничего. «Бот для записи в маникюрный салон, клиентки 20-40, дружелюбный тон» -> это работает. Tone of voice влияет на тексты автоответов, без него получается канцелярит.
Третья -> отсутствие версии библиотек. «aiogram» без 3.13+ -> риск получить версию 2. «SQLAlchemy» без 2.0 -> риск получить синхронную старую обертку, которая не дружит с асинхронным aiogram.
Четвертая -> забытый деплой. Если не сказать «Railway, polling», AI выберет webhook, попросит SSL-сертификат и nginx-конфиг, и MVP вы будете запускать неделю.
Пятая -> попытка засунуть все в main.py. AI без структуры папок в PRD так и сделает -> и через 3 фичи в одном файле будет 800 строк, в которые лезть не хочется. В PRD всегда явно прописывайте: «структура: bot/handlers, bot/keyboards, bot/states, bot/db».
Лиза: «У меня есть домашний бот „Напомни мне“. Голосом: „напомни послезавтра в 13:00 запись к врачу“ -> бот шлет напоминание за час. Создавала 30 минут, потому что в промпте сразу написала: aiogram 3, состояния, парсинг даты через dateparser, хранение в sqlite. Не написала бы — собирала бы вечер.»
FAQ
Можно ли сделать Telegram-бот для бизнеса вообще без программирования? Можно, если у вас есть PRD-промпт и доступ к Cursor, Windsurf или Claude Code. Знать Python не обязательно, но читать чужой код и запускать команды в терминале придется. На простой бот для записи уходит 2-4 часа без опыта программирования.
Какой ии для создания тг бота лучше в 2026 году? Связка Windsurf с Claude Sonnet 4.6 в большинстве случаев. Cursor подходит, если уже работаете в нем. Claude Code в терминале — для тех, кому привычнее CLI. Все три отрабатывают PRD-промпт одинаково, разница в интерфейсе и скорости автодополнения.
Что такое FSM простыми словами? Это память бота о том, на каком шаге диалога находится клиент. Без FSM бот отвечает на каждое сообщение с чистого листа. С FSM бот понимает: «этот клиент уже выбрал услугу, сейчас ждет от него дату».
Сколько стоит создать бота для продажи через AI-редактор? Подписка Windsurf или Cursor от 10 до 20 долларов в месяц. Хостинг на Railway бесплатный для маленьких ботов, от 5 долларов для нагруженных. Итого 15-25 долларов в месяц. Реклама, токены платежных систем и домены — отдельная история.
Можно ли подключить ChatGPT или DeepSeek внутрь самого Telegram-бота? Да, и часто нужно. В блоке ИНТЕГРАЦИИ PRD-промпта пишите: «подключить DeepSeek через API, ключ в .env, отправлять туда последние 5 сообщений диалога». AI-редактор сам напишет обертку. Стоимость запросов считается отдельно.
Откуда брать токен для бота? В Telegram у бота @BotFather. Команда /newbot, придумываете имя и юзернейм, получаете токен в формате 123456:ABCDEF.... Этот токен вставляете в файл .env в проекте. Никогда не коммитьте токен в git, иначе через несколько часов его украдут боты-краулеры.
Что делать, если первый прогон промпта дал кривой код? Не правьте код, а переписывайте PRD. В 9 случаях из 10 причина в нем. Откатитесь к предыдущему коммиту, добавьте в PRD недостающие детали и запустите снова. Это быстрее, чем дописывать поверх ошибок.
PRD-промпт это не магия и не очередная мода. Это способ дать Windsurf, Cursor или Claude Code рамку, в которой нейросеть не может промахнуться. Все 7 блоков (роль, команды, FSM, стек, БД, интеграции, деплой) убирают 90% типовых ошибок первого прогона.
Если хотите посмотреть, какими еще AI-редакторами собирают чат боты для бизнеса в 2026 году, заходите в каталог инструментов VibeCoderz. Там 70+ карточек с обзорами, ценами и подборками видео. А если задача нестандартная (платежи, мультиязычные сценарии, интеграции с CRM) и хочется не угадывать, а сделать сразу правильно -> запишитесь на консультацию к Максиму. Разберем ваш конкретный кейс и соберем PRD под него.
Обновлено: октябрь 2026. Цены моделей и версии библиотек актуализируем по мере выхода новых релизов.
