← Все гайды
07 · НачинайБесплатно

Telegram-бот без ручного кода

Первый AI-проект для предпринимателя: рабочий Telegram-бот за вечер через один промпт. Без курсов по программированию.

Первый AI-проект для фаундеров из Узбекистана: рабочий Telegram-бот за вечер через один промпт. Без курсов по программированию.


Зачем именно Telegram-бот

В Узбекистане Telegram — главный канал для бизнеса. Клиенты пишут туда, заказы приходят туда, поддержка живёт там. Если хочешь автоматизировать первую рутину — начинать стоит именно с бота.

И второе. Бот — самый простой проект из всего что можно собрать через AI. Три файла, один токен, одна команда запуска. За вечер получаешь рабочую штуку, которую видно у себя в телефоне. Это и есть тот опыт, после которого "вайбкодинг" перестаёт звучать как магия и становится навыком.

В этом гайде — пошагово. От пустой папки до бота, который отвечает на сообщения. Без кода руками. Минимум 30 минут, максимум вечер.

Один универсальный промпт → рабочий бот. Главный смысл — научиться давать AI правильный контекст, а не разобраться в Python. Когда поймёшь принцип, ты соберёшь любую следующую штуку этим же способом.


Что понадобится

  • Аккаунт Telegram (любой).
  • Компьютер с интернетом.
  • AI-редактор кода. Подойдёт Codex, Claude Code или Cursor. Все три платные подписки оплачиваются картой Visa или Mastercard узбекского банка напрямую. Бесплатные тарифы тоже подойдут на первый бот.
  • Python 3.10 или новее. Если не уверен что стоит — AI сам скажет где скачать когда дойдёшь до запуска. Или даже можешь и это делегировать — сказать, чтобы он сам установил, а от тебя только подтвердить.
Совет

Если ставишь Python сам, впервые — на сайте python.org поставь галочку "Add to PATH" в установщике. Это сэкономит 20 минут разборок дальше.


Шаг 1. Получи токен от @BotFather

В Telegram открой бота @BotFather. Это официальный бот от Telegram, через который создаются все остальные боты.

  1. Напиши ему /newbot
  2. Дай боту имя — то, что увидят пользователи (например, "Помощник Магазина Айгуль")
  3. Дай username — техническое имя, обязательно заканчивается на bot (например, aigul_shop_helper_bot)
  4. BotFather пришлёт сообщение со строкой токена. Выглядит как:
123456789:AAF1b2C3d4E5f6G7h8I9j0KLMNOPQRSTUVWXYZ

Скопируй его в заметки или в буфер — на следующем шаге вставим в код.

Совет

Никогда не публикуй этот токен открыто и не отправляй его в чаты. Кто получит токен — управляет твоим ботом полностью. Если случайно слил — пиши /revoke BotFather и получи новый.


Шаг 2. Сгенерируй проект одним промптом

Открой AI-редактор. На примере Claude Code — у Codex и Cursor шаги аналогичные.

Создай пустую папку, например telegram-bot-start, и открой её в редакторе. Открой встроенный чат с AI и вставь такой промпт:

Собери проект Telegram-бота на Python.

Стек:
— python-telegram-bot версии 21+
— Application и async/await
— токен через .env и python-dotenv

Команды бота:
— /start — приветствие
— /help — список команд
— на любое текстовое сообщение бот отвечает: "Принял: <текст сообщения>"

Создай файлы:
— bot.py — основной скрипт
— .env — для токена (placeholder TELEGRAM_BOT_TOKEN=)
— requirements.txt — список зависимостей

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

AI попросит разрешение создать файлы — одобри. Через 30-60 секунд проект будет готов: появятся три файла в папке.

Заметка

Промпт работает с любой моделью — Claude, GPT, Gemini. Если используешь другой язык (Node.js вместо Python) — просто замени "Python" и "python-telegram-bot" на "Node.js" и "node-telegram-bot-api". Структура промпта остаётся та же.


Шаг 3. Вставь токен и запусти

Открой файл .env и замени placeholder на свой токен из шага 1:

TELEGRAM_BOT_TOKEN=123456789:AAF1b2C3d4E5f6G7h8I9j0KLMNOPQRSTUVWXYZ

Открой терминал в той же папке (в Cursor — Ctrl+`, в VS Code так же). Запусти две команды по очереди:

pip install -r requirements.txt
python bot.py

Первая ставит зависимости. Вторая запускает бота. В терминале увидишь что-то вроде "Application started polling" — это значит бот живой и слушает сообщения.

Открой Telegram, найди своего бота по username из шага 1, нажми Start. Если приходит приветствие — всё работает. Напиши любой текст — должен прийти ответ "Принял: <твой текст>".

До этого момента — 10 минут чистого времени. Остальное — установка Python и редактора если их ещё не было. Это и есть точка где люди впервые понимают, что вайбкодинг работает.


Шаг 4. Улучшай через короткие промпты

С этого момента бот живой, и каждое улучшение — это просто новый промпт в чат с AI. Не пиши код руками.

Хорошая структура промпта на улучшение:

Возьми текущий код бота. Добавь команду /price.
При вызове команды бот отвечает прайс-листом из 5 позиций:
— Стрижка детская — 80 000 сум
— Стрижка взрослая — 120 000 сум
— ...
Прайс храни в отдельном словаре в начале файла, чтобы было легко править.

AI вносит правки, ты перезапускаешь бота (Ctrl+Cpython bot.py), проверяешь в Telegram.

Несколько направлений куда бот растёт первым делом:

  • Прайс-команда для сферы услуг: парикмахерская, IT-школа, медицина.
  • Запись на услугу — бот собирает имя, телефон, дату через диалог и пересылает тебе в личку.
  • Каталог товаров — для магазина, с категориями и фотками.
  • Подписка на канал — бот отправляет пользователю ссылку с UTM и считает откуда пришёл.

«Сделай бота лучше»

«Добавь к существующему боту команду /zakaz. При вызове бот спрашивает: имя клиента, телефон, тип услуги (из списка 3 вариантов), желаемая дата. Собранные данные шлёт в личку владельцу с chat_id 12345678. Все шаги — последовательным диалогом, не одним сообщением.»

Заметь — во втором примере мы дали AI: что добавить, как собирать данные, куда отправлять, какой формат диалога. С таким промптом результат с первой итерации почти всегда рабочий.


Что часто ломается и как чинить

"Module not found" при запуске. Скорее всего не отработал pip install. Скопируй ошибку в чат с AI и попроси разобраться — он подскажет какую зависимость поставить отдельно.

Бот не отвечает в Telegram, но в терминале нет ошибок. Проверь токен в .env — буква в букву из BotFather. Один лишний пробел в конце ломает всё.

"Application not initialized" или конфликт polling. Если бот уже запущен в другом терминале, второй экземпляр не стартует. Закрой первый (Ctrl+C) или убей процесс через Диспетчер задач.

Хочешь чтобы бот работал когда комп выключен. Локальный python bot.py крутится только пока редактор открыт. Чтобы крутить 24/7 — нужен сервер. Это тема следующего гайда; пока на этом этапе достаточно того, что бот живёт пока ты тестируешь.


Что забрать с собой

Если все 4 шага отработали — у тебя в руках первая рабочая AI-сборка. Дальше любая идея, которую ты можешь сформулировать в один абзац, становится таким же проектом за вечер.

Главное правило, которое работает для всех будущих проектов: AI получает контекст → AI генерирует → ты проверяешь → ты просишь улучшения. Не пытайся писать код руками между этими шагами. Доверься циклу.


Что дальше

  • AGENTS.md и Memory Bank (paid) — как давать AI постоянный контекст про твой проект, чтобы не объяснять заново при каждом промпте.
  • Подключаем Notion к AI-агенту (paid) — заставь агента работать с твоей базой знаний.