Как сделать Telegram-бота на Python с нуля: BotFather, команды и запуск

Чтобы запустить Telegram-бота на Python, создайте его через @BotFather, сохраните токен в переменной окружения, установите python-telegram-bot и подключите обработчики команд к Application. Соберём бота с командами /start и /help, ответом на обычный текст и понятной диагностикой. Токен в исходный код вставлять не будем.

Telegram-бот состоит из двух частей. Telegram хранит аккаунт бота и пересылает события через Bot API. Ваша Python-программа получает эти события, выбирает обработчик и отправляет ответ. Если программа остановлена, логика тоже не работает, даже если сам бот по-прежнему виден в Telegram.

Как Telegram, Bot API и Python связаны между собой

Пользователь пишет не вашей программе напрямую. Сообщение сначала приходит на серверы Telegram и превращается в объект Update. Библиотека python-telegram-bot получает update, передаёт его подходящему handler и отправляет ответ обратно через Bot API.

Ответ появляется только после того, как запущенная программа обработает update.

Создаём бота через BotFather и сохраняем токен

Создайте папку проекта и виртуальное окружение. На Windows команды удобно выполнять в PowerShell; на macOS и Linux отличается только команда активации.

mkdir telegram-bot
cd telegram-bot
py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install python-telegram-bot
$env:TELEGRAM_BOT_TOKEN="ВСТАВЬТЕ_ТОКЕН_ТОЛЬКО_ЗДЕСЬ"

В macOS или Linux окружение включается командой source .venv/bin/activate, а переменная задаётся как export TELEGRAM_BOT_TOKEN="...". Значение существует только в текущем окне терминала, что удобно для первого безопасного запуска.

Токен даёт полный контроль над ботом, поэтому его отделяют от файлов проекта.

Пишем команды start, help и ответ на текст

Создайте файл bot.py. В актуальном интерфейсе библиотеки обработчики асинхронные: перед ними стоит async def, а отправка сообщения вызывается через await. CommandHandler ловит команды, MessageHandler отбирает обычный текст.

import os

from telegram import Update
from telegram.ext import (
    Application,
    CommandHandler,
    ContextTypes,
    MessageHandler,
    filters,
)


async def start(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    user = update.effective_user
    name = user.first_name if user else "друг"
    await update.message.reply_text(
        f"Привет, {name}! Напишите сообщение, и я его повторю."
    )


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


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


def main() -> None:
    token = os.environ.get("TELEGRAM_BOT_TOKEN")
    if not token:
        raise RuntimeError("Не задана переменная TELEGRAM_BOT_TOKEN")

    app = Application.builder().token(token).build()
    app.add_handler(CommandHandler("start", start))
    app.add_handler(CommandHandler("help", help_command))
    app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))

    print("Бот запущен. Для остановки нажмите Ctrl+C.")
    app.run_polling(allowed_updates=Update.ALL_TYPES)


if __name__ == "__main__":
    main()

• Application.builder().token(token).build() создаёт приложение с вашим ботом.
• Обработчики проверяются по порядку и получают объект Update с данными события.
• Фильтр filters.TEXT & ~filters.COMMAND означает «текст, но не команда».
• Проверка переменной окружения останавливает программу с понятной ошибкой вместо неясного сетевого сбоя.

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

Запускаем бота и проверяем полный путь сообщения

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

Почему Telegram-бот не отвечает

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