Как создать Телеграм-бота на Python

Перед написанием кода установите минимальный набор инструментов. Для старта подойдёт Python 3.11 или новее: он прост для первых проектов, быстро настраивается и поддерживается большинством библиотек для Telegram API. Проверьте установку командой python --version или python3 --version. Если команда не находится, скачайте Python с официального сайта и при установке отметьте пункт добавления в PATH.

• Создайте отдельную папку проекта, например telegram_bot_start.
• Откройте её в VS Code, PyCharm или другом редакторе.
• Создайте виртуальное окружение: python -m venv venv.
• Активируйте его: в Windows — venv\Scripts\activate, в macOS/Linux — source venv/bin/activate.
• Установите библиотеку: pip install python-telegram-bot.

После подготовки окружения зарегистрируйте бота в Telegram. Найдите в поиске официальный аккаунт @BotFather и запустите диалог командой /start. Далее отправьте /newbot. BotFather попросит указать отображаемое имя бота, затем username. Username должен быть уникальным и заканчиваться на bot, например study_helper_bot.

После успешной регистрации BotFather выдаст токен вида 123456789:AA.... Это ключ доступа к управлению ботом через API. Не публикуйте его в GitHub, чатах и скриншотах. Для локальной разработки сохраните токен в файле .env или во временной переменной окружения, а не вставляйте напрямую в код.

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

Бесплатный экспресс аудит

Проведём SEO аудит без оплаты. Акция действует до конца августа.

Заказать аудит

Пишем первый код на Python: команды, ответы и логика работы

Для первого запуска установите библиотеку python-telegram-bot и создайте файл bot.py. Токен, полученный в BotFather, не вставляйте в публичный репозиторий: сохраните его в переменной окружения или в отдельном .env-файле.

pip install python-telegram-bot python-dotenv

Минимальный каркас бота выглядит так:

import os
from dotenv import load_dotenv
from telegram import Update
from telegram.ext import ApplicationBuilder, CommandHandler, MessageHandler, ContextTypes, filters

load_dotenv()
TOKEN = os.getenv("BOT_TOKEN")

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("Привет! Напиши /help, чтобы увидеть команды.")

async def help_command(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("Команды: /start, /help, /about")

async def about(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("Я учебный бот на Python.")

async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE):
    text = update.message.text
    await update.message.reply_text(f"Вы написали: {text}")

app = ApplicationBuilder().token(TOKEN).build()

app.add_handler(CommandHandler("start", start))
app.add_handler(CommandHandler("help", help_command))
app.add_handler(CommandHandler("about", about))
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))

app.run_polling()

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

• /start — приветствует пользователя и показывает точку входа;
• /help — выводит список доступных команд;
• /about — отправляет описание проекта;
• echo — возвращает пользователю введённый текст.

Запустите файл командой python bot.py, откройте чат с ботом и отправьте /start. Если ответа нет, проверьте токен, установленную библиотеку и наличие интернета. На этом этапе Создание телеграмм бота для новичков в прогрпммировании сводится к трём ключевым действиям: принять сообщение, определить его тип и отправить корректный ответ.

Запуск проекта, тестирование и типичные ошибки на старте

Перед первым запуском проверьте, что токен от BotFather не вставлен прямо в код. Создайте файл .env, добавьте туда BOT_TOKEN=ваш_токен и загрузите переменную через библиотеку python-dotenv. Такой подход защитит проект, если вы позже выложите код на GitHub.

Для локального старта активируйте виртуальное окружение и установите зависимости:

• python -m venv venv — создание окружения;
• source venv/bin/activate или venv\Scripts\activate — активация;
• pip install aiogram python-dotenv — установка библиотек;
• python bot.py — запуск бота.

После запуска откройте Telegram, найдите своего бота по username и отправьте команду /start. Если ответ не пришёл, сначала смотрите консоль: там обычно сразу видны ошибки импорта, неверный токен, конфликт версий или проблема с обработчиком команды.

Минимальный чек-лист тестирования:

• проверьте команды /start, /help и неизвестный текст;
• отправьте боту стикер, фото и пустое сообщение, если такие случаи не обрабатываются;
• перезапустите скрипт и убедитесь, что бот снова отвечает;
• проверьте, что при ошибке бот не падает полностью.

Типичная ошибка новичков — запускать одновременно две копии бота с polling. Telegram вернёт конфликт, потому что обновления может получать только один процесс. Ещё одна частая проблема — забытый await перед асинхронной отправкой сообщения: код выполняется, но ответ не уходит.

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