Hardcoding PRO: Telegram-бот уровня 30–150 тыс. ₽ через ИИ

Начни отсюда: два готовых промпта

Не устанавливай ничего руками и не разбирайся в коде. Выбери, какой бот тебе нужен, скопируй один промпт целиком и вставь в Codex / Claude Code.

Дальше ИИ сделает всё сам: возьмёт правильный GitHub-шаблон, создаст отдельный репозиторий под твой проект, задаст тебе ровно 5 простых вопросов, адаптирует бота, запустит проверки, сохранит результат в GitHub и доведёт проект до рабочего состояния.

ОБЫЧНЫЙ БОТ

Telegram Bot Starter

Выбирай, если нужен бот с кнопками, заявками, квизом, CRM, оплатой, файлами, уведомлениями, каналом или другой бизнес-логикой без обязательного ИИ внутри.

Шаблон: PavelDumbrao/hardcoding-telegram-bot-starter

Вставь в Codex / Claude Code.

Ты мой ИИ-программист. Я не программист и не должен вручную устанавливать, настраивать или редактировать проект.

ИСПОЛЬЗУЙ ГОТОВЫЙ ШАБЛОН:
GitHub: https://github.com/PavelDumbrao/hardcoding-telegram-bot-starter
Репозиторий-шаблон: PavelDumbrao/hardcoding-telegram-bot-starter

ВАЖНО:
- не работай напрямую в исходном шаблоне;
- создай отдельный GitHub-репозиторий под МОЙ проект из этого шаблона;
- GitHub должен быть единственным источником правды проекта;
- если GitHub CLI уже авторизован, всё с GitHub сделай сам;
- если авторизации GitHub нет, попроси меня только авторизовать GitHub и после этого продолжи сам;
- не проси меня выполнять Git-команды;
- не проси меня писать код;
- секреты не проси вставлять в обычный чат.

СНАЧАЛА НИЧЕГО НЕ МЕНЯЙ В КОДЕ.

ЗАДАЙ МНЕ РОВНО 5 ВОПРОСОВ ПО ОДНОМУ:

1. Как называется мой проект или бизнес и чем он занимается?
2. Кто будет пользоваться ботом?
3. Какой главный результат пользователь должен получить от бота?
4. Какой главный сценарий должен пройти пользователь от /start до результата? Если я не знаю, предложи мне 3 простых варианта и помоги выбрать.
5. Какие дополнительные функции мне нужны: заявки, квиз, CRM, запись, оплата, файлы, уведомления, работа с каналом, админка, аналитика или интеграции? Если я не знаю, предложи минимальный набор сам.

После пятого ответа сам собери краткое понимание продукта и приступай к работе.

ЧТО ТЫ ДЕЛАЕШЬ САМ ПОСЛЕ 5 ВОПРОСОВ:

1. Создай отдельный GitHub-репозиторий моего проекта из указанного шаблона.
2. Назови репозиторий понятно по моему проекту.
3. Клонируй или открой МОЮ копию проекта в рабочей среде.
4. Прочитай README.md, AGENTS.md, PROMPT_ADAPT.md и существующий код.
5. Установи зависимости и подготовь рабочее окружение.
6. Не переписывай проект с нуля без причины.
7. Адаптируй /start, тексты, кнопки, меню и главный сценарий под мои ответы.
8. Добавь нужную бизнес-логику, базу данных и интеграции.
9. Для главного сценария добавь понятную аналитику событий: старт, ключевые кнопки, важные шаги, успешный результат и ошибки.
10. Сделай понятные ошибки, защиту от дублей и нормальное журналирование.
11. BOT_TOKEN и другие секреты храни только локально через .env или безопасный механизм. Не коммить секреты.
12. Работай через GitHub: отдельная ветка для заметных изменений, понятные коммиты, тесты, push, Pull Request, GitHub Actions, merge в main после успешных проверок.
13. Обнови README так, чтобы он описывал уже МОЕГО бота, а не шаблон.
14. Запусти все тесты и исправь ошибки сам.
15. Запусти бота и фактически проверь подключение к Telegram.
16. Если доступен Telethon, проведи сквозной тест как реальный пользователь: /start, кнопки, главный сценарий, финальный результат. Сохрани message_id ключевых шагов.
17. Не говори «готово», пока реальный сценарий не работает.

В КОНЦЕ ДАЙ МНЕ ТОЛЬКО ПОНЯТНЫЙ ОТЧЁТ:
- что умеет мой бот;
- ссылка на мой GitHub-репозиторий;
- что было реализовано;
- какие тесты прошли;
- какой сквозной Telegram-сценарий проверен;
- какой commit находится в main;
- что мне нужно сделать самому, только если без моего действия действительно невозможно продолжить.

Главное: я описываю бизнес и результат. Всю техническую работу делаешь ты.

ИИ-БОТ

Telegram AI Bot Starter

Выбирай, если внутри бота должен работать ИИ-консультант, продавец, наставник, помощник или полноценный ИИ-агент с памятью и инструментами.

Шаблон: PavelDumbrao/hardcoding-telegram-ai-bot-starter

Вставь в Codex / Claude Code.

Ты мой ИИ-программист. Я не программист и не должен вручную устанавливать, настраивать или редактировать проект.

ИСПОЛЬЗУЙ ГОТОВЫЙ ШАБЛОН:
GitHub: https://github.com/PavelDumbrao/hardcoding-telegram-ai-bot-starter
Репозиторий-шаблон: PavelDumbrao/hardcoding-telegram-ai-bot-starter

ВАЖНО:
- не работай напрямую в исходном шаблоне;
- создай отдельный GitHub-репозиторий под МОЙ проект из этого шаблона;
- GitHub должен быть единственным источником правды проекта;
- если GitHub CLI уже авторизован, всё с GitHub сделай сам;
- если авторизации GitHub нет, попроси меня только авторизовать GitHub и после этого продолжи сам;
- не проси меня выполнять Git-команды;
- не проси меня писать код;
- BOT_TOKEN, AI_API_KEY и другие секреты не проси вставлять в обычный чат.

СНАЧАЛА НИЧЕГО НЕ МЕНЯЙ В КОДЕ.

ЗАДАЙ МНЕ РОВНО 5 ВОПРОСОВ ПО ОДНОМУ:

1. Как называется мой проект или бизнес и чем он занимается?
2. Кто будет пользоваться этим ИИ-ботом?
3. Какую роль должен выполнять ИИ внутри бота: консультант, продавец, наставник, поддержка, ассистент или другая роль? Если я не знаю, предложи 3 варианта.
4. Какой конкретный результат пользователь должен получить после диалога с ИИ-ботом?
5. К каким данным и действиям должен иметь доступ ИИ: база знаний, файлы, CRM, API, календарь, заявки, оплаты, поиск, внешние сервисы или другие инструменты? Если я не знаю, предложи минимальный безопасный набор сам.

После пятого ответа сам собери краткое понимание продукта и приступай к работе.

ЧТО ТЫ ДЕЛАЕШЬ САМ ПОСЛЕ 5 ВОПРОСОВ:

1. Создай отдельный GitHub-репозиторий моего проекта из указанного шаблона.
2. Назови репозиторий понятно по моему проекту.
3. Клонируй или открой МОЮ копию проекта в рабочей среде.
4. Прочитай README.md, AGENTS.md, PROMPT_ADAPT.md и существующий код.
5. Установи зависимости и подготовь рабочее окружение.
6. Не переписывай проект с нуля без причины.
7. Адаптируй /start, кнопки, тексты и путь пользователя под мой проект.
8. Настрой роль ИИ, системную инструкцию и ограничения поведения.
9. Сохрани настраиваемость ИИ-провайдера через AI_BASE_URL, AI_API_KEY и AI_MODEL.
10. Используй существующую память диалога и доработай её только если это нужно продукту.
11. Подключи только нужные моему ИИ инструменты и данные. Не давай лишние права.
12. Добавь обработку ошибок ИИ-провайдера, длинных ответов и сброса контекста.
13. Для главного сценария добавь аналитику событий: старт, начало диалога, ключевое действие, успешный результат и ошибка.
14. BOT_TOKEN, AI_API_KEY и другие секреты храни только локально через .env или безопасный механизм. Не коммить секреты.
15. Работай через GitHub: отдельная ветка для заметных изменений, понятные коммиты, тесты, push, Pull Request, GitHub Actions, merge в main после успешных проверок.
16. Обнови README под фактический продукт.
17. Запусти тесты и сам исправь всё, что падает.
18. Фактически запусти ИИ-бота и проверь подключение к Telegram и ИИ-провайдеру.
19. Проверь память диалога, /reset, основной ответ ИИ и ошибку провайдера.
20. Если доступен Telethon, проведи сквозной тест как реальный пользователь: /start, диалог с ИИ, использование ключевой функции, финальный результат. Сохрани message_id ключевых шагов.
21. Не говори «готово», пока реальный сценарий не работает.

В КОНЦЕ ДАЙ МНЕ ТОЛЬКО ПОНЯТНЫЙ ОТЧЁТ:
- какую роль выполняет мой ИИ-бот;
- что он умеет;
- ссылка на мой GitHub-репозиторий;
- какие данные и инструменты подключены;
- какие тесты прошли;
- какой сквозной Telegram-сценарий проверен;
- какой commit находится в main;
- что мне нужно сделать самому, только если без моего действия действительно невозможно продолжить.

Главное: я отвечаю на 5 вопросов о продукте. Всю техническую работу делаешь ты.

Не знаешь, какой вариант выбрать? Если ИИ не является главным смыслом продукта, начинай с обычного Telegram Bot Starter. Если пользователь должен разговаривать с ИИ и получать от него персональный результат, бери Telegram AI Bot Starter.

Схема Hardcoding PRO: создание Telegram-бота через GitHub — Схема Hardcoding PRO: шаблон → GitHub → ИИ → тесты → рабочий Telegram-бот.

0. Зачем вообще бизнесу Telegram-бот и почему это дорогой продукт

Telegram-бот - это не «несколько кнопок». Нормальный бот заменяет кусок сайта, CRM, менеджера, формы, автоматизации и первой линии поддержки прямо внутри Telegram.

Продажи и заявки

Собирает лиды, задаёт вопросы, квалифицирует, показывает продукты, считает стоимость, передаёт заявку менеджеру или в CRM.

Запись и бронирование

Показывает свободные слоты, принимает запись, напоминает клиенту, меняет статус и передаёт данные сотруднику.

Оплаты и доступ

Принимает оплату по правилам Telegram, выдаёт материал, открывает доступ в закрытый продукт или запускает следующий сценарий.

Поддержка 24/7

Отвечает на частые вопросы, принимает обращения, ищет данные, подключает человека только там, где он действительно нужен.

Канал и контент

Готовит публикации, работает с файлами, запускает уведомления, собирает реакции и помогает управлять контентом.

ИИ-агент внутри

Бот может быть интерфейсом для ИИ-консультанта, продавца, наставника или сотрудника, который использует внешние инструменты и базу знаний.

Главная мысль: полноценный Telegram-бот с бизнес-логикой, данными, интеграциями, аналитикой и ИИ - это уже коммерческий цифровой продукт, а не учебная игрушка.

Наша цель: не «сэкономить на программисте любой ценой», а научиться с ИИ доводить проект до того уровня, за который рынок реально платит: понятный путь пользователя, красивые кнопки, данные, аналитика, интеграции, тесты, стабильный запуск и нормальная документация.

4 современных формата ботов, которые стоит уметь собирать

Не думай про бота как про «автоответчик». Сегодня Telegram-бот может быть полноценным продуктом, ИИ-сотрудником или приложением внутри Telegram.

4 современных формата Telegram-ботов — Четыре продуктовых направления: ИИ-агент, Mini App, бот-продавец и бот-оператор.

AI FIRST

1. ИИ-консультант или ИИ-агент

Пользователь общается с ботом как с сотрудником. Бот помнит контекст, работает с базой знаний, файлами и внешними инструментами, может консультировать, продавать, обучать или выполнять задачи.

Пример: ИИ-продавец, эксперт по продукту, наставник, помощник отдела поддержки.

MINI APP

2. Бот + полноценное приложение

Внутри Telegram открывается красивый интерфейс: каталог, запись, личный кабинет, магазин, калькулятор, подписка, игра или сервис. Пользователю не нужно уходить на отдельный сайт.

Пример: магазин, сервис бронирования, кабинет ученика, приложение сообщества.

БИЗНЕС

3. Бот-продавец и бизнес-секретарь

Встречает клиента, задаёт вопросы, квалифицирует, собирает заявку, ведёт по воронке, фиксирует данные в CRM, напоминает о следующем шаге и подключает менеджера там, где нужен человек.

Пример: отдел продаж, запись на услугу, первичная консультация, поддержка клиентов.

АВТОМАТИЗАЦИЯ

4. Бот-оператор и помощник сообщества

Связывает Telegram с GitHub, CRM, n8n, базами данных, каналами и другими сервисами. Может модерировать группу, публиковать контент, собирать события, запускать процессы и возвращать результат пользователю.

Пример: бот сообщества, контент-оператор, служебный бот команды, автоматизация внутренних процессов.

Живые референсы механики: посмотри, как устроены @DurgerKingBot как пример Mini App и сервисные боты вроде @GitHubBot, @GMailBot, @wiki. Не копируй их один в один. Смотри на них как на подсказку, насколько разными могут быть Telegram-продукты.

Главная идея практики: ты можешь взять любой из этих форматов, описать результат обычными словами и дать Codex / Claude Code задачу превратить готовый GitHub-шаблон в такой продукт.

1. GitHub обязателен: это память твоего проекта

Мы не работаем с ботом как с папкой файлов на компьютере. Каждый ученик создаёт свой репозиторий в GitHub и дальше ИИ работает только через него.

GitHub как память Telegram-проекта — GitHub хранит код, историю и рабочее состояние, а ИИ всегда видит фактический контекст проекта.

НЕ ПОТЕРЯЕШЬ

Весь проект в одном месте

Код, история изменений, тесты и рабочая версия не разбросаны по папкам и чатам.

ИИ ПОМНИТ

Агент видит реальное состояние

Codex / Claude Code читает репозиторий, понимает, что уже сделано, и не начинает проект заново.

МОЖНО ОТКАТИТЬ

Любое изменение видно

Если новая функция сломала бота, ИИ видит историю и может вернуть рабочее состояние.

Тебе не надо учить Git. В следующем отдельном гайде мы разберём GitHub подробнее. Здесь достаточно одного правила: создай копию шаблона в своём GitHub и скажи ИИ всегда вести проект через этот репозиторий.

Вставь агенту один раз в начале проекта.

Работай с этим Telegram-ботом строго через его GitHub-репозиторий.

GitHub - главный источник правды проекта. Не оставляй важные изменения только локально и не создавай рядом отдельную копию проекта.

ТЫ САМ ДЕЛАЕШЬ ВСЮ РАБОТУ С GITHUB:
1. Проверь текущий репозиторий, origin и актуальный main.
2. Перед изменениями синхронизируйся с origin/main.
3. Для заметной новой функции создай отдельную ветку.
4. Делай понятные коммиты после законченных блоков.
5. Перед отправкой в GitHub запусти все тесты и проверки проекта.
6. После push проверь GitHub Actions.
7. Для заметных изменений создай Pull Request.
8. После успешных проверок выполни merge в main.
9. После merge убедись, что origin/main содержит итоговую рабочую версию.
10. Не коммить .env, токены, API-ключи и другие секреты.

Не проси меня вводить Git-команды вручную, если у тебя есть доступ к Git и GitHub.

Если я вернусь к проекту через неделю или открою новый чат, сначала восстанови контекст из GitHub: README, AGENTS.md, историю последних коммитов, открытые задачи и фактический код. Не полагайся на память разговора.

После каждого существенного этапа коротко сообщай мне:
- что изменилось;
- какие проверки прошли;
- ссылка на Pull Request или commit;
- что сейчас является рабочей версией.

2. Что отличает бота «за 150 тысяч» от учебной игрушки

Цена появляется не из количества строк кода. Ценность появляется из того, насколько бот закрывает реальную задачу и насколько надёжно это делает.

Из чего состоит Telegram-бот продуктового уровня — Бот продуктового уровня: интерфейс, сценарии, данные, аналитика, интеграции и ИИ там, где он действительно нужен.

Красивый путь пользователя

Понятный /start, аккуратные inline-кнопки, логичные переходы, «назад», «отмена», отсутствие тупиков и технических сообщений.

Состояния и сценарии

Бот понимает, на каком шаге находится человек, хранит прогресс и не ломает диалог после случайного сообщения.

Данные и CRM

Пользователи, заявки, оплаты, статусы и действия не теряются. Информация сохраняется и может уходить во внешнюю CRM.

Телеметрия и аналитика

Фиксируются ключевые события: старт, кнопки, шаги, заявка, оплата, ошибка, успешный результат. Видно, где люди отваливаются.

Интеграции

n8n, CRM, таблицы, API, платежи, файлы, базы данных, каналы и другие сервисы подключаются под задачу бизнеса.

AI First

Если ИИ реально усиливает продукт, внутри появляется агент: консультирует, продаёт, работает с базой знаний, файлами и внешними инструментами.

Надёжность

Ошибки обрабатываются, секреты защищены, есть журналы, тесты, автозапуск, резервный путь и понятная диагностика.

Сквозной контроль через Telethon

ИИ сам заходит в Telegram как настоящий пользователь, нажимает кнопки, проходит сценарий и доказывает, что бот реально работает.

Правило: ИИ должен не просто «написать функцию», а довести её до проверенного пользовательского результата и сохранить изменения в GitHub.

3. Новичку: что здесь происходит

Ты не создаёшь проект. Мы уже создали хороший каркас. Твоя задача: сделать копию и описать ИИ, какой бот тебе нужен.

ТЫ

Даёшь смысл

Продукт, аудитория, тексты, правила, что должен получить пользователь.

ИИ

Делает технику

Меняет код, ставит зависимости, строит меню, БД, интеграции, тесты и исправляет ошибки.

ШАБЛОН

Не даёт начать с хаоса

Уже содержит структуру, секреты через .env, Docker, SQLite, тесты и правила для агента.

Главное правило: если Codex / Claude Code может сам создать файл, запустить команду или исправить ошибку, он должен сделать это сам. Ты не работаешь вместо агента.

4. Два готовых GitHub-шаблона

БАЗОВЫЙ

Telegram Bot Starter

Для меню, заявок, квизов, уведомлений, CRM, файлов, оплат и обычной бизнес-логики без обязательной ИИ-модели.

Python 3.12 + aiogram 3.31
SQLite
.env без секретов в Git
Docker
тесты + GitHub Actions
готовый PROMPT_ADAPT.md

Создать копию из шаблона Открыть репозиторий

С ИИ

Telegram AI Bot Starter

Для консультанта, помощника, наставника, ИИ-продавца или агента с памятью диалога.

всё из базового шаблона
OpenAI-compatible API
AI_BASE_URL / AI_MODEL
память в SQLite
/reset
без привязки к одному провайдеру

Создать копию из шаблона Открыть репозиторий

Как выбрать: если ИИ не является ядром продукта, начинай с базового. Если пользователь должен разговаривать с моделью, бери ИИ-шаблон. Не тащи ИИ туда, где достаточно кнопок и обычной логики.

Важно: после кнопки «Создать копию из шаблона» работай только со своей копией в GitHub. Не скачивай проект в отдельную папку и не создавай второй источник правды.

Весь маршрут

0. Зачем бизнесу Telegram-бот и сколько стоит такой продукт Современные форматы: ИИ-агент, Mini App, продавец, автоматизатор 1. GitHub как обязательная память проекта 2. Из чего состоит бот продуктового уровня 3. Что происходит, если ты вообще не программист 4. Выбрать готовый GitHub-шаблон 5. Создать бота через BotFather 6. Практика: от шаблона до рабочего продукта 7. Главные промпты адаптации 8. Готовые промпты функций 9. Развёртывание и сквозной тест 10. Безопасность 11. Критерий готовности

5. Создай самого бота в BotFather

Это один из немногих шагов, где нужен ты. Telegram выдаёт токен бота через официального @BotFather.

Открой @BotFather

Отправь команду /newbot.

Придумай имя

Это отображаемое название. Его можно менять позже.

Придумай username

Обычно он заканчивается на bot. Например my_project_bot.

Получишь BOT_TOKEN

Относись к нему как к паролю. Не отправляй токен в обычный чат с ИИ и не коммить его в Git.

Не вставляй токен в PROMPT. ИИ должен подготовить локальный .env или безопасный ввод секрета. В репозитории уже есть .env.example без реальных значений.

6. Практика: от шаблона до продукта

Ты создаёшь копию шаблона в GitHub, отдаёшь репозиторий ИИ, описываешь бизнес обычными словами, а агент сам меняет код, тестирует, сохраняет изменения в GitHub и проверяет бота через Telegram.

Путь ученика Hardcoding PRO от нуля до рабочего Telegram-бота — Практический маршрут ученика от BotFather и шаблона до сквозного теста.

Практика 1. Создать свой GitHub-проект из шаблона

Нажми «Создать копию из шаблона». После этого твоя копия в GitHub становится единственным рабочим проектом.

Готово, если: у тебя есть свой новый GitHub-репозиторий, а не fork и не папка с чужим кодом.

Практика 2. Отдать GitHub-проект ИИ

Открой свою копию в Codex / Claude Code и сначала дай ему промпт «Работай строго через GitHub». Потом агент сам изучает проект и ведёт всю техническую историю.

Готово, если: агент прочитал проект и может простыми словами сказать, какие файлы и функции уже есть.

Практика 3. Адаптировать под свой бизнес и довести до продуктового уровня

Ты описываешь только продукт, аудиторию и результат. ИИ сам делает меню, кнопки, переходы, данные, аналитику, интеграции и при необходимости ИИ-агента внутри.

Готово, если: /start и главный сценарий уже отражают именно твой продукт, а тесты проходят.

Практика 4. Проверить всё как настоящий пользователь

После тестов и GitHub-проверок ИИ запускает Telethon и проходит бота снаружи: /start, кнопки, переходы, главный сценарий и финальный результат.

Готово, если: есть реальные message_id для /start и ключевого сценария, а агент показал результат «ПРОЙДЕНО».

7. Главные промпты: ИИ адаптирует репозиторий под тебя

Если не знаешь, какого бота строить

Можно также выделить текст вручную.

Я новичок в вайбкодинге. Хочу Telegram-бота для моего проекта, но пока не понимаю, какие функции ему нужны.

Мой бизнес / проект: [ОПИШИ]
Моя аудитория: [КТО]
Что я продаю или какую задачу решаю: [ОПИШИ]

Не пиши код сразу. Сначала предложи 3 варианта Telegram-бота:
1. Самый простой MVP.
2. Вариант, который сильнее помогает продажам или продукту.
3. ИИ-first вариант с максимальной автоматизацией.

Для каждого варианта укажи:
- путь пользователя от /start до результата;
- 3-7 функций;
- какие данные нужно хранить;
- где реально нужен ИИ, а где обычной логики достаточно;
- что можно собрать на готовом Hardcoding PRO шаблоне без лишней сложности.

Потом спроси, какой вариант я выбираю. После моего выбора возьми подходящий шаблон репозитория и сам адаптируй его.

Для обычного бота

Можно также выделить текст вручную.

Ты мой агент-программист. Перед тобой готовый шаблон Hardcoding PRO Telegram Bot Starter.

Твоя задача: САМОМУ адаптировать этот репозиторий под мой проект. Не учи меня программированию и не перекладывай на меня техническую работу.

МОЙ ПРОЕКТ
Название: [НАЗВАНИЕ]
Кто будет пользоваться: [ЦЕЛЕВАЯ АУДИТОРИЯ]
Что пользователь должен получить от бота: [РЕЗУЛЬТАТ]
Главный сценарий: [ОПИШИ ИЛИ НАПИШИ «ПРЕДЛОЖИ САМ»]
Дополнительные функции: [СПИСОК ИЛИ «ПРЕДЛОЖИ САМ»]

Сначала изучи README.md, AGENTS.md, PROMPT_ADAPT.md и текущий код. Не переписывай рабочий проект с нуля без причины.

Если тебе не хватает информации, задай мне только вопросы про продукт, пользователей, тексты и бизнес-сценарий. Все технические решения прими сам.

Сам создавай и редактируй файлы, устанавливай зависимости, запускай команды, исправляй ошибки и обновляй тесты.

Не проси BOT_TOKEN в обычном чате. Подготовь локальный .env или безопасный ввод секрета. Не коммить секреты.

Минимальный результат:
1. Понятный /start.
2. Главное меню.
3. /help.
4. Полностью работающий главный сценарий.
5. SQLite, если нужна память или данные.
6. Журналирование ошибок.
7. Понятные русские тексты.
8. Обновлённый README для этого проекта.
9. Тесты критической логики.

Перед завершением обязательно:
- pytest -q
- ruff check .
- python -m compileall -q bot
- фактический запуск бота
- проверка Telegram-подключения
- если доступен Telethon, сквозной тест как реальный пользователь

Не говори «готово», пока ключевой сценарий не проверен фактически.

ОБЯЗАТЕЛЬНО РАБОТАЙ ЧЕРЕЗ GITHUB
GitHub - единственный источник правды проекта. Сам синхронизируй main, работай через отдельную ветку для заметных изменений, делай понятные коммиты, запускай тесты, push, Pull Request, проверяй GitHub Actions и после успешных проверок merge в main. Не оставляй важные изменения только локально. Не проси меня выполнять Git-команды вручную.

ДОВЕДИ БОТА ДО ПРОДУКТОВОГО УРОВНЯ
Не ограничивайся тем, что «функция работает». Проверь путь пользователя:
- понятный /start;
- аккуратные кнопки и переходы;
- отсутствие тупиков;
- сохранение состояния там, где оно нужно;
- события аналитики для ключевых шагов;
- понятные ошибки;
- защита от дублей;
- логирование;
- сквозной тест через Telethon;
- README должен соответствовать фактическому продукту.

Для главного сценария зафиксируй события аналитики минимум: старт, ключевая кнопка, прохождение важного шага, успешный результат и ошибка. В конце покажи мне простую воронку: сколько пользователей дошло до каждого шага.

Для ИИ-бота

Можно также выделить текст вручную.

Ты мой агент-программист. Перед тобой готовый Hardcoding PRO Telegram AI Bot Starter.

Преврати его в моего ИИ-бота под задачу ниже. Делай техническую работу сам.

РОЛЬ БОТА
[НАПРИМЕР: консультант, менеджер продаж, наставник, помощник по продукту]

ЦЕЛЕВАЯ АУДИТОРИЯ
[КТО БУДЕТ ПИСАТЬ БОТУ]

ЧТО БОТ ДОЛЖЕН ДЕЛАТЬ
[ОПИШИ ПРОСТЫМИ СЛОВАМИ]

ЧТО БОТ НЕ ДОЛЖЕН ДЕЛАТЬ
[ОГРАНИЧЕНИЯ]

Сначала изучи существующий проект. Используй готовые слои конфигурации, SQLite и ИИ-провайдера. Не переписывай всё с нуля.

ИИ-провайдер должен оставаться настраиваемым через AI_BASE_URL, AI_API_KEY и AI_MODEL. Системную инструкцию вынеси в SYSTEM_PROMPT или отдельный файл, если она большая.

Добавь только те функции, которые нужны моей задаче. Если я не описал сценарий полностью, сначала предложи мне 3 коротких варианта продукта человеческим языком, дождись выбора и только потом меняй код.

Секреты не проси в обычном чате. BOT_TOKEN и AI_API_KEY должны вводиться локально или через безопасный механизм.

Обязательно проверь:
- /start;
- основной диалог с ИИ;
- память диалога;
- /reset;
- обработку ошибки ИИ-провайдера;
- длинный ответ;
- pytest;
- ruff;
- компиляцию;
- реальный запуск;
- сквозной тест через Telethon, если он доступен.

В конце дай мне не объяснение кода, а короткий отчёт: что умеет бот, что заполнить в .env, как запустить и какие проверки реально прошли.

ОБЯЗАТЕЛЬНО РАБОТАЙ ЧЕРЕЗ GITHUB
GitHub - единственный источник правды проекта. Сам синхронизируй main, работай через отдельную ветку для заметных изменений, делай понятные коммиты, запускай тесты, push, Pull Request, проверяй GitHub Actions и после успешных проверок merge в main. Не оставляй важные изменения только локально. Не проси меня выполнять Git-команды вручную.

ДОВЕДИ БОТА ДО ПРОДУКТОВОГО УРОВНЯ
Не ограничивайся тем, что «функция работает». Проверь путь пользователя:
- понятный /start;
- аккуратные кнопки и переходы;
- отсутствие тупиков;
- сохранение состояния там, где оно нужно;
- события аналитики для ключевых шагов;
- понятные ошибки;
- защита от дублей;
- логирование;
- сквозной тест через Telethon;
- README должен соответствовать фактическому продукту.

Для главного сценария зафиксируй события аналитики минимум: старт, ключевая кнопка, прохождение важного шага, успешный результат и ошибка. В конце покажи мне простую воронку: сколько пользователей дошло до каждого шага.

AI First внутри Telegram-бота — ИИ-бот может работать с базой знаний, файлами, CRM, API, памятью и автоматизациями как цифровой сотрудник.

8. Готовые промпты для функций

Сначала собери основу. Потом добавляй функции по одной. Не пытайся одним сообщением построить весь космолёт.

Сбор заявок

Форма заявки + SQLite + уведомление администратору.

Можно также выделить текст вручную.

Добавь в текущего Telegram-бота сбор заявок.

Нужно:
1. Кнопка «Оставить заявку».
2. Последовательно спросить имя, телефон или @username, интересующий продукт и комментарий.
3. Сохранять заявку в SQLite.
4. Не создавать дубли при повторном нажатии.
5. После сохранения показать пользователю понятное подтверждение.
6. Если ADMIN_IDS заполнен, отправить администратору уведомление о новой заявке без секретов и технического мусора.
7. Добавить тесты на сохранение заявки и защиту от дублей.

Сам изучи текущую архитектуру и встрои функцию аккуратно. После изменений прогони все тесты и фактически проверь сценарий.

Голосовые сообщения

Скачать, расшифровать и передать дальше в логику.

Можно также выделить текст вручную.

Добавь в текущего Telegram-бота работу с голосовыми сообщениями.

Сценарий:
- пользователь отправляет голосовое;
- бот скачивает файл;
- передаёт его в уже доступный сервис распознавания речи или аккуратно добавляет отдельный настраиваемый слой;
- получает текст;
- передаёт текст в бизнес-логику бота;
- отвечает пользователю результатом.

Не привязывай секреты к коду. Добавь настройки в .env.example без значений. Учти ошибки скачивания, распознавания и слишком длинных файлов. Добавь тесты для чистой логики и проведи реальный Telegram-тест, если доступен тестовый аккаунт.

Работа с файлами

PDF/TXT/документы с лимитами и очисткой.

Можно также выделить текст вручную.

Добавь в текущего Telegram-бота безопасную обработку файлов.

Пользователь должен иметь возможность отправить PDF, TXT или документ поддерживаемого формата. Бот должен проверить тип и размер, скачать файл во временную папку, обработать его нужным модулем и удалить временный файл после завершения.

Не принимай бесконечные размеры и неизвестные типы файлов. Не показывай пользователю внутренние пути, секреты и исключения.

Если для анализа содержимого нужен ИИ, сначала отдели извлечение текста от вызова ИИ. Добавь тесты на проверку типа, размера и очистку временных файлов.

Постоянный запуск на VPS

Docker, автозапуск, том для БД, проверка.

Можно также выделить текст вручную.

Подготовь текущего Telegram-бота к постоянной работе на моём сервере.

Работай сам. Сначала определи фактическое окружение сервера и не ломай существующие сервисы.

Используй уже имеющиеся Dockerfile и compose.yaml, если это подходит. Должны быть:
- автозапуск после перезагрузки;
- restart policy;
- .env вне Git;
- постоянный том для SQLite;
- понятные журналы;
- команда проверки состояния;
- безопасный способ обновления.

После развёртывания фактически проверь, что контейнер или сервис запущен, бот отвечает в Telegram и после одного контролируемого перезапуска снова поднимается. Не говори «готово» только потому, что сборка прошла.

Сквозной тест через Telethon

Проверка бота как настоящий пользователь.

Можно также выделить текст вручную.

Проведи сквозной тест моего Telegram-бота через уже подключённый Telethon-аккаунт.

Бот: [@USERNAME_BOT]

Сценарий:
1. Точно найди бота.
2. Отправь /start.
3. Дождись ответа и сохрани message_id.
4. Пройди главный пользовательский сценарий: [ОПИШИ].
5. Для каждого шага сохрани отправленное сообщение, ответ бота, время и message_id.
6. Проверь, что финальный результат соответствует ожидаемому.
7. Не повторяй действие вслепую при неизвестном результате. Сначала проверь, не произошло ли оно уже.
8. В конце дай ПРОЙДЕНО / ОШИБКА и фактические подтверждения.

Если тест упал, найди логи проекта, установи причину, исправь её и повтори только упавший сценарий.

Если всё сломалось

ИИ сам диагностирует и чинит, не перекладывая на ученика.

Можно также выделить текст вручную.

Я новичок. Не перекладывай на меня техническую диагностику.

Сам изучи текущую ошибку, журналы, файлы, зависимости, .env без вывода секретных значений и состояние процесса или контейнера. Найди первопричину и попробуй безопасно исправить её своими инструментами.

Не проси меня вручную запускать команды или редактировать код, если у тебя есть терминал.

Если без моего действия продолжить невозможно, попроси только одно конкретное действие простыми словами.

После исправления обязательно повтори тот тест, который раньше падал, и покажи фактический результат.

Квиз и воронка

Несколько вопросов, сохранение результата и следующий шаг.

Можно менять значения в квадратных скобках.

Добавь в текущего Telegram-бота квиз под мою задачу.

Цель квиза: [ЦЕЛЬ]
Вопросы: [СПИСОК ИЛИ «ПРЕДЛОЖИ САМ»]
Что делать после квиза: [РЕЗУЛЬТАТ]

Требования:
1. Пользователь проходит вопросы по одному.
2. Можно вернуться назад или начать заново.
3. Ответы сохраняются в SQLite.
4. Повторный запуск не создаёт мусорные дубли.
5. После завершения бот выдаёт понятный персональный результат.
6. Если заполнен ADMIN_IDS, администратор получает короткую сводку результата.
7. Добавь тесты на переходы между шагами и сохранение результата.

Встрой сценарий в существующую архитектуру, не переписывай проект. После изменений прогони проверки и реальный Telegram-тест.

Админские функции

Статистика и управление только для ADMIN_IDS.

Можно менять значения в квадратных скобках.

Добавь в текущего Telegram-бота безопасные админские функции.

Доступ должен быть только у пользователей из ADMIN_IDS.

Минимум:
- /admin показывает меню администратора;
- количество пользователей;
- количество заявок или ключевых сущностей проекта;
- последние 10 событий;
- возможность выгрузить CSV или JSON без секретов;
- понятный отказ обычному пользователю.

Не делай публичную веб-админку без необходимости. Не показывай токены, .env, внутренние пути и чувствительные данные. Добавь тест проверки прав администратора.

Как выбрать оплату: цифровые товары и услуги внутри Telegram оплачиваются через Telegram Stars. Для сценариев, где допустим внешний платёжный провайдер, можно подключить Prodamus или ЮKassa. Тебе не нужно разбираться в API: выбери нужный промпт, а ИИ сам проверит правила и реализует интеграцию.

Оплата через Telegram Stars

Для цифровых товаров и услуг, которые продаются внутри Telegram.

Можно менять значения в квадратных скобках.

Добавь оплату в текущего Telegram-бота для продукта: [ОПИШИ ПРОДУКТ].

Сначала определи тип продукта.

Если это цифровой товар или цифровая услуга внутри Telegram, используй Telegram Stars и валюту XTR по актуальным правилам Telegram. Реализуй полный цикл: счёт -> pre_checkout_query -> подтверждение -> successful_payment -> сохранение telegram_payment_charge_id -> выдача результата. Добавь /paysupport и возможность корректно обработать возврат, если это требуется продукту.

Если это физический товар или физическая услуга, проверь актуальный официальный Payments API и используй подходящего платёжного провайдера.

Никогда не отмечай заказ оплаченным до фактического successful_payment. Добавь идемпотентность, хранение платежа в БД и тесты критической логики. Перед боевым запуском проведи тестовый платёжный сценарий.

Оплата через Prodamus

Платёжная ссылка + уведомление об успешной оплате + автоматическая выдача результата.

ИИ сам настроит интеграцию.

Добавь в текущего Telegram-бота оплату через Prodamus.

ПРОДУКТ:
[ОПИШИ, ЧТО ПРОДАЁМ]

СУММА ИЛИ ТАРИФЫ:
[СУММА / СПИСОК ТАРИФОВ]

СНАЧАЛА ПРОВЕРЬ ПРАВИЛА
1. Определи, относится ли продукт к цифровому товару или цифровой услуге, продаваемой внутри Telegram.
2. Если Telegram требует для этого продукта оплату через Telegram Stars, НЕ внедряй Prodamus как обход. Остановись, объясни это простыми словами и предложи использовать уже готовый сценарий Telegram Stars.
3. Prodamus подключай только если такой платёжный сценарий допустим.

ДАЛЬШЕ ВСЮ ТЕХНИЧЕСКУЮ РАБОТУ ДЕЛАЙ САМ.

ИНТЕГРАЦИЯ PRODAMUS
1. Изучи текущий проект и не переписывай рабочую архитектуру.
2. Используй актуальную официальную документацию Prodamus для самостоятельной интеграции.
3. Добавь настройки в .env.example без реальных значений:
   - PRODAMUS_PAYFORM_URL
   - PRODAMUS_SECRET_KEY
   - PRODAMUS_SYS, если он нужен текущей интеграции
   - PUBLIC_BASE_URL для webhook, если проект использует свой HTTPS endpoint
4. Реальные секреты не проси вставлять в обычный чат. Используй локальный .env или безопасный ввод секретов.
5. Перед созданием ссылки сначала создай заказ в базе:
   - внутренний order_id;
   - telegram_id;
   - продукт или тариф;
   - сумма;
   - статус pending;
   - created_at.
6. Сформируй платёжную ссылку Prodamus через официальный способ с do=link или другой актуальный рекомендуемый сценарий.
7. Передавай уникальный order_id, название товара, цену и количество.
8. Отправляй пользователю красивую inline-кнопку «Оплатить» со сформированной ссылкой.
9. Сделай HTTPS webhook для уведомлений Prodamus.
10. Обязательно проверяй подлинность webhook по актуальной схеме подписи Prodamus и секретному ключу.
11. Никогда не меняй заказ на paid только потому, что пользователь вернулся по urlSuccess или нажал кнопку «Я оплатил».
12. Статус paid выставляй только после валидного подтверждения оплаты от Prodamus.
13. Обработка webhook должна быть идемпотентной: повторное уведомление не должно повторно выдавать товар или доступ.
14. После успешной оплаты:
   - сохрани идентификатор и данные платежа, которые нужны проекту;
   - обнови заказ;
   - выдай пользователю результат или доступ;
   - отправь понятное подтверждение;
   - зафиксируй событие payment_success в аналитике.
15. Добавь сценарии:
   - неоплаченный заказ;
   - успешная оплата;
   - повторный webhook;
   - неверная подпись;
   - неизвестный order_id;
   - ошибка Prodamus.
16. Если продукт использует подписки, отдельно проверь актуальную документацию Prodamus по уведомлениям первого и повторных платежей. Не придумывай механизм рекуррентов самостоятельно.

GITHUB
Работай только через GitHub:
ветка → изменения → тесты → commit → push → Pull Request → GitHub Actions → merge в main после успешных проверок.

ПРОВЕРКА
1. Прогони тесты критической логики.
2. Проверь формирование платёжной ссылки.
3. Проверь webhook на тестовых данных без реального списания, если это возможно.
4. Если для полного теста нужен мой тестовый платёж, попроси только одно конкретное действие и объясни сумму и цель.
5. После подтверждённой тестовой оплаты проверь, что бот автоматически увидел оплату и выдал результат.
6. Если доступен Telethon, пройди Telegram-сценарий до кнопки оплаты и после подтверждения платежа проверь финальное сообщение бота.

В конце дай мне короткий отчёт:
- что подключено;
- какие переменные нужно заполнить в .env;
- какой сценарий оплаты работает;
- какие тесты прошли;
- какой commit находится в main.

Я не должен вручную писать код или разбираться в API Prodamus. Сделай интеграцию сам.

Оплата через ЮKassa

Создание платежа через API + кнопка оплаты + webhook о результате.

ИИ сам настроит интеграцию.

Добавь в текущего Telegram-бота оплату через ЮKassa.

ПРОДУКТ:
[ОПИШИ, ЧТО ПРОДАЁМ]

СУММА ИЛИ ТАРИФЫ:
[СУММА / СПИСОК ТАРИФОВ]

СНАЧАЛА ПРОВЕРЬ ПРАВИЛА
1. Определи, относится ли продукт к цифровому товару или цифровой услуге, продаваемой внутри Telegram.
2. Если Telegram требует для этого продукта оплату через Telegram Stars, НЕ внедряй ЮKassa как обход. Остановись, объясни это простыми словами и предложи использовать Telegram Stars.
3. ЮKassa подключай только если внешний платёжный сценарий для этого продукта допустим.

ДАЛЬШЕ ВСЮ ТЕХНИЧЕСКУЮ РАБОТУ ДЕЛАЙ САМ.

ИНТЕГРАЦИЯ ЮKASSA
1. Изучи текущую архитектуру проекта и не переписывай её с нуля.
2. Используй актуальную официальную документацию и серверный API ЮKassa.
3. Если официальный Python SDK подходит текущему проекту, можешь использовать его. Не добавляй лишние зависимости без причины.
4. Добавь в .env.example без реальных значений:
   - YOOKASSA_SHOP_ID
   - YOOKASSA_SECRET_KEY
   - PUBLIC_BASE_URL
   - YOOKASSA_RETURN_URL, если нужен отдельный адрес возврата
5. Реальные shop_id и secret_key не проси вставлять в обычный чат. Используй локальный .env или безопасный ввод секретов.
6. Перед созданием платежа создай заказ в базе:
   - внутренний order_id;
   - telegram_id;
   - продукт или тариф;
   - сумма;
   - статус pending;
   - created_at.
7. Создавай платёж на сервере через API ЮKassa.
8. Для каждой операции используй уникальный Idempotence-Key.
9. Для обычного одностадийного сценария используй capture=true, если это подходит продукту.
10. Передавай внутренний order_id в metadata платежа.
11. Используй confirmation типа redirect и получай confirmation_url.
12. Отправляй confirmation_url пользователю красивой inline-кнопкой «Оплатить».
13. Настрой HTTPS webhook ЮKassa для нужных событий, минимум payment.succeeded и payment.canceled, если они нужны сценарию.
14. Webhook должен отвечать HTTP 200 только после корректной обработки уведомления.
15. Не доверяй уведомлению вслепую. Проверяй подлинность уведомления актуальным рекомендуемым ЮKassa способом, например проверкой текущего статуса платежа через API и другими официально рекомендованными мерами.
16. Никогда не отмечай заказ оплаченным по return_url или по кнопке пользователя «Я оплатил».
17. Заказ становится paid только после фактического подтверждённого статуса succeeded.
18. Обработка должна быть идемпотентной: повторный webhook не должен повторно выдавать результат.
19. После успешной оплаты:
   - сохрани yookassa payment_id;
   - сохрани подтверждённый статус и сумму;
   - обнови заказ;
   - выдай пользователю продукт, доступ или следующий шаг;
   - отправь понятное сообщение об успехе;
   - зафиксируй payment_success в аналитике.
20. Добавь обработку:
   - pending;
   - succeeded;
   - canceled;
   - повторного webhook;
   - неизвестного order_id;
   - ошибки API;
   - несовпадения суммы или продукта.
21. Если проекту нужна фискализация, чеки, сохранение способа оплаты, рекуррентные платежи или возвраты, сначала проверь актуальные настройки магазина и официальную документацию ЮKassa. Не придумывай эти сценарии сам.

GITHUB
Работай только через GitHub:
ветка → изменения → тесты → commit → push → Pull Request → GitHub Actions → merge в main после успешных проверок.

ПРОВЕРКА
1. Прогони тесты бизнес-логики и идемпотентности.
2. Проверь создание платежа и получение confirmation_url.
3. Проверь обработку webhook на тестовых данных.
4. Если для полного сквозного теста нужен мой тестовый платёж, попроси только одно конкретное действие.
5. После тестовой оплаты докажи, что бот получил succeeded, обновил заказ и выдал результат.
6. Если доступен Telethon, пройди Telegram-сценарий до кнопки «Оплатить», а после подтверждения платежа проверь финальное сообщение и сохрани message_id.

В конце дай мне короткий отчёт:
- что подключено;
- какие переменные нужно заполнить в .env;
- какой сценарий оплаты работает;
- какие тесты прошли;
- какой commit находится в main.

Я не должен вручную писать код или разбираться в API ЮKassa. Сделай интеграцию сам.

Публикация в канал

Бот публикует только при реальных правах и проверяет результат.

Можно менять значения в квадратных скобках.

Добавь текущему Telegram-боту возможность публиковать в мой канал [КАНАЛ].

Сначала фактически проверь, что бот добавлен в канал и имеет необходимые права. Не угадывай chat_id.

Нужно:
- подготовка черновика;
- отдельное подтверждение перед публикацией;
- текст + фото или документ, если это требуется;
- сохранение message_id опубликованного поста;
- контрольное чтение результата после публикации;
- защита от случайного повторного поста.

Если прав недостаточно, не пытайся обходить Telegram. Скажи, какого конкретно права не хватает.

Аналитика и воронка

ИИ добавит измерение действий пользователей.

Для любого бота.

Добавь в текущего Telegram-бота продуктовую аналитику.

Не ставь тяжёлую систему без необходимости. Сначала используй существующую БД проекта.

Нужно фиксировать ключевые события:
- bot_started;
- нажатия основных кнопок;
- вход в главный сценарий;
- прохождение важных шагов;
- успешное завершение;
- ошибка;
- заявка или оплата, если они есть.

Для каждого события сохраняй минимально необходимые данные: telegram_id или безопасный внутренний идентификатор, event_name, время и небольшой payload без секретов.

Добавь простую команду администратора или отчёт, который показывает воронку по основному сценарию и места, где пользователи отваливаются.

Работай через GitHub: отдельная ветка, тесты, commit, push, Pull Request, GitHub Actions, merge только после зелёных проверок.

После реализации проверь события реальным прохождением через Telethon.

Аналитика и воронка Telegram-бота — События показывают, где пользователь идёт к результату, а где теряется.

Довести бота до уровня продукта

Финальная полировка перед запуском.

Когда основные функции уже работают.

Проведи продуктовый аудит текущего Telegram-бота и доведи его до состояния, которое не стыдно продавать клиенту как полноценный продукт.

Я не программист. Не давай мне список технических задач. Выполни доступную работу сам.

Проверь:
1. Первый экран и /start.
2. Тексты простым русским языком.
3. Красивые и понятные кнопки.
4. Логичные переходы, назад, отмену и отсутствие тупиков.
5. Состояние пользователя между шагами.
6. Сохранение важных данных.
7. Аналитику ключевых событий и воронки.
8. Ошибки и повторные действия без дублей.
9. Права администратора.
10. Безопасность секретов.
11. README.
12. Тесты.
13. Постоянный запуск.
14. Реальный сквозной сценарий через Telethon.
15. Если ИИ действительно усиливает продукт, предложи один минимальный AI-first модуль. Не добавляй ИИ ради моды.

Работай только через GitHub. Для заметных изменений используй ветку, коммиты, Pull Request, GitHub Actions и merge после успешных проверок.

В конце дай мне человеческий отчёт:
- что было слабым;
- что ты исправил;
- какой пользовательский путь теперь работает;
- какие события аналитики собираются;
- какие сквозные тесты прошли;
- какой commit находится в main.

9. Правильный результат: GitHub + тесты + живой Telegram

Кодовая проверка

Техническая готовность0/5

pytest проходит
ruff не находит ошибок
Python компилирует bot/
.env не находится в Git
README соответствует проекту

Проверка в Telegram

Проверка глазами пользователя0/5

бот реально запускается
/start отвечает
ключевой сценарий работает
ошибки не показывают секреты
Telethon подтверждает сообщения по message_id

Важно: «контейнер запущен» не значит «бот работает». И «код не упал» не значит «пользователь получил правильный результат». Поэтому последняя проверка всегда идёт снаружи через Telegram.

Финальная цепочка: GitHub main → зелёные тесты → развёрнутая версия → Telethon проходит сценарий как пользователь → аналитика фиксирует шаги.

Сквозное тестирование Telegram-бота через Telethon — Telethon проверяет бота снаружи так, как его видит реальный пользователь.

10. Пять правил безопасности и порядка

BOT_TOKEN = полный доступ к боту. Только локальный .env или защищённое хранилище.
Не коммить секреты. В Git уходит только .env.example.
Сначала тестовый сценарий. Не начинай с массовых сообщений людям.
ИИ меняет код, но проверяет фактом. Тесты + реальный Telegram.
Не давай боту лишние права. В группах и каналах выдавай только то, что действительно нужно функции.

11. Когда у тебя уже не учебный бот, а продукт

Definition of Done продукта0/16

создан свой GitHub-репозиторий из шаблона;
бот создан через BotFather;
токен не попал в Git и промпты;
Codex / Claude Code сам адаптировал проект;
/start отражает твой продукт;
главный пользовательский сценарий работает;
SQLite или другая память работает, если она нужна;
pytest, ruff и компиляция проходят;
бот постоянно работает локально или на VPS;
Telethon прошёл сквозной тест и сохранил message_id;
GitHub является единственным источником правды проекта;
последняя рабочая версия находится в main и прошла GitHub Actions;
главный сценарий имеет красивые кнопки и понятные переходы;
ключевые события фиксируются в аналитике;
по воронке видно, где пользователи начинают и где завершают сценарий;
Telethon прошёл сценарий как реальный пользователь и сохранил message_id на ключевых шагах;

Финиш: дальше ты не ищешь «как написать Telegram-бота». Ты берёшь проверенный репозиторий и ставишь ИИ задачу изменить его под новый продукт.

Ты не «написал бота». Ты собрал Telegram-продукт: он живёт в GitHub, работает в реальном Telegram, проходит тесты и проверяется снаружи как обычным пользователем.

Начни отсюда: два готовых промпта

Telegram Bot Starter

Telegram AI Bot Starter

0. Зачем вообще бизнесу Telegram-бот и почему это дорогой продукт

Продажи и заявки

Запись и бронирование

Оплаты и доступ

Поддержка 24/7

Канал и контент

ИИ-агент внутри

4 современных формата ботов, которые стоит уметь собирать

1. ИИ-консультант или ИИ-агент

2. Бот + полноценное приложение

3. Бот-продавец и бизнес-секретарь

4. Бот-оператор и помощник сообщества

1. GitHub обязателен: это память твоего проекта

Весь проект в одном месте

Агент видит реальное состояние

Любое изменение видно

2. Что отличает бота «за 150 тысяч» от учебной игрушки

Красивый путь пользователя

Состояния и сценарии

Данные и CRM

Телеметрия и аналитика

Интеграции

AI First

Надёжность

Сквозной контроль через Telethon

3. Новичку: что здесь происходит

Даёшь смысл

Делает технику

Не даёт начать с хаоса

4. Два готовых GitHub-шаблона

Telegram Bot Starter

Telegram AI Bot Starter

Весь маршрут

5. Создай самого бота в BotFather

6. Практика: от шаблона до продукта

Практика 1. Создать свой GitHub-проект из шаблона

Практика 2. Отдать GitHub-проект ИИ

Практика 3. Адаптировать под свой бизнес и довести до продуктового уровня

Практика 4. Проверить всё как настоящий пользователь

7. Главные промпты: ИИ адаптирует репозиторий под тебя

Если не знаешь, какого бота строить

Для обычного бота

Для ИИ-бота

8. Готовые промпты для функций

Сбор заявок

Голосовые сообщения

Работа с файлами

Постоянный запуск на VPS

Сквозной тест через Telethon

Если всё сломалось

Квиз и воронка

Админские функции

Оплата через Telegram Stars

Оплата через Prodamus

Оплата через ЮKassa

Публикация в канал

Аналитика и воронка

Довести бота до уровня продукта

9. Правильный результат: GitHub + тесты + живой Telegram

Кодовая проверка

Проверка в Telegram

10. Пять правил безопасности и порядка

11. Когда у тебя уже не учебный бот, а продукт

Закрепил результат? Продолжай по карте