Telegram-бот за два вечера: 8 файлов для Claude Code

Telegram-бот за два вечера: 8 файлов для Claude Code

Telegram-бот без программиста собирается за два вечера, если дать агенту порядок. Здесь восемь файлов-шагов: в каждом готовый промпт для Claude Code или Cursor и список, по которому ты проверяешь результат. Агент собирает бота по твоему ТЗ, ты отвечаешь на вопросы и проверяешь. В первый вечер у тебя бот с меню и заявками, во второй — админка, рассылка, проверка и сервер.

Зачем бизнесу бот, сколько он стоит и чем ИИ-агент отличается от конструктора, разобрано в статье Как сделать Telegram-бота с ИИ. Этот набор — пошаговая сборка с промптами под каждый шаг.

Для кого: для экспертов, предпринимателей и маркетологов, которым нужен свой бот для заявок и рассылок, а программиста нет.

Что внутри

0. Подготовка: бот в @BotFather, проверка Python и связи с Telegram, токен в отдельном файле .env командой для Mac и Windows.
1. ТЗ: агент расспрашивает тебя и записывает, что бот делает и чего не делает. Отдельно спрашивает про согласие на обработку персональных данных. Если хочешь продумать бота подробнее, есть гайд ТЗ на Telegram-бота.
2. Правила для агента: готовый CLAUDE.md со стеком и запретами, в том числе «не открывай .env» и «держи логику отдельно от Telegram», чтобы бота можно было перенести в MAX.
3. Первая версия: приветствие и меню кнопками.
4. Заявки: поля по одному, подтверждение, сохранение в базу и уведомление тебе в личку. Ссылка с меткой показывает, из какого ролика или поста пришёл человек.
5. Админка и рассылка: заявки со статусами, статистика по источникам, рассылка с предпросмотром, отписка через /stop.
6. Проверка: свежая сессия агента ищет утечки токена, дыры в админке и проверяет тестом, что бот не ломается на фото, стикерах и старых кнопках. Как устроена такая приёмка, разобрано в гайде Приёмка работы агента.
7. Сервер: вход по ключу, бот сам поднимается после перезагрузки, копия базы каждый день приходит тебе в личку. Подробнее о переезде — в гайде Переезд на сервер.

Плюс таблица частых ошибок с расшифровкой, три промпта на случай, когда агент сделал не то, пример готового ТЗ и заготовки CLAUDE.md и .env.

Как мы проверили набор

Мы прогнали все шаги в Claude Code на вымышленной студии маникюра:

• ТЗ получилось с 5 кнопками, заявкой из 4 полей и согласием на обработку данных. Ни одного текста агент не придумал за владелицу, всё недостающее пометил заглушками.
• Заявка прошла тестом с отменой, пропуском необязательного поля и двойным нажатием «Всё верно» (сохранилась одна заявка).
• Рассылка на тестовой базе шла ровно 20 сообщений в секунду, а те, кто заблокировал бота, выпадали из следующей рассылки.
• Проверка из шага 6 нашла настоящую ошибку: заявка пропадала, если человек нажимал «Всё верно» через неделю. Мы добавили защиту от этого в шаг 4.

Живую переписку в Telegram и сервер тест не проверяет. Для них в каждом шаге есть список «Проверка».

Кейс: бот привычек для канала «Метод Орлова»

Команда канала о долголетии «Метод Орлова» собрала с Claude Code бота @metod_orlova_habits_bot. Он пускает только подписчиков канала, присылает привычки из рубрики «Привычка недели», ведёт трекер, напоминает вечером и подводит итог недели. Порядок работы тот же, что в этом наборе: ТЗ, правила для агента в CLAUDE.md, сборка небольшими частями с проверкой в Telegram, потом сервер.

• Первая рабочая версия на ноутбуке появилась через два с половиной часа, бот на сервере — через полтора дня.
• Сборку разбили на восемь частей. К концу первого дня в проекте было больше двухсот автотестов.
• Больше всего времени ушло на тексты: каждую фразу бота команда читала глазами подписчика и отправляла на переделку.
• Сервер — VPS в Москве, около 2000 ₽ в месяц.

Хронология по часам, восемь затыков и как их решили — в кейсе Бот привычек для канала за полтора дня.

Как это работает у нас

Набор собран из того, что работает в боте VIBERZ. Наш сервер стоит в России, и Telegram до него не доставал: сообщения копились, бот молчал. Мы перешли на long polling — сервер сам раз в минуту забирает новые сообщения, ответ приходит через 1–2 секунды. Как это сделать, если у тебя та же проблема, написано в шаге 7. Как устроена вся наша воронка из рилса в бота, разобрано в бесплатной схеме нашей воронки.

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

Стек: Python, библиотека aiogram 3, база SQLite в одном файле. Формат: Markdown. Работает в Claude Code и Cursor.

Что входит в покупку

• Восемь файлов-шагов, памятка, таблица ошибок, пример ТЗ, три промпта на случай поломок и заготовки одним архивом.
• Оплата разовая, без подписки: 990 ₽ один раз.
• Архив появится здесь, в уроке «Скачать и установить», сразу после оплаты.

Хочешь сначала попробовать — бесплатная версия на три промпта: Telegram-бот за 30 минут. Чтобы агент не открыл файл с токеном, поставь 3 мода Claude Code.