Разработка Telegram-бота на Python: пошаговое руководство от установки библиотек до запуска готового проекта

Telegram-боты — это инструменты, которые автоматизируют общение, продажи и сервисы для миллионов пользователей

Python остаётся самым популярным языком для их создания благодаря простому синтаксису и мощным библиотекам. Это руководство проведёт через весь путь: от регистрации бота в BotFather до развёртывания на сервере с реальными примерами кода.

⚠ Важно: токен — это пароль бота. Если он попал в чужие руки, мгновенно отзовите его командой /revoke в BotFather и получите новый.

Критерий	aiogram 3.x	python-telegram-bot
Подход	Полностью асинхронный (asyncio)	Асинхронный с v20, синхронные обёртки
Скорость разработки	Высокая — готовые FSM, фильтры, роутеры	Средняя — больше ручной настройки
Документация	Хорошая + активное русскоязычное сообщество	Исчерпывающая, англоязычная
Машина состояний (FSM)	Встроена из коробки	ConversationHandler (своя реализация)
Идеально подходит для	Ботов быстрого запуска, MVP, хакатонов	Enterprise-проектов, сложных интеграций

pip install aiogram

# bot.py
import asyncio
from aiogram import Bot, Dispatcher
from aiogram.filters import CommandStart
from aiogram.types import Message

BOT_TOKEN = "ВАШ_ТОКЕН_ОТ_BOTFATHER"

bot = Bot(token=BOT_TOKEN)
dp = Dispatcher()

@dp.message(CommandStart())
async def cmd_start(message: Message):
    await message.answer(
        "Привет! Я ваш первый бот на Python 🐍"
    )

@dp.message()
async def echo(message: Message):
    await message.answer(message.text)

async def main():
    await dp.start_polling(bot)

if __name__ == "__main__":
    asyncio.run(main())

Как это работает: декоратор @dp.message() — это фильтр. Хендлер cmd_start срабатывает только на команду /start, а хендлер без фильтров ловит все остальные сообщения. Метод start_polling запускает постоянный опрос серверов Telegram на предмет новых сообщений.

from aiogram.types import InlineKeyboardMarkup, InlineKeyboardButton
from aiogram import F
from aiogram.types import CallbackQuery

@dp.message(CommandStart())
async def cmd_start(message: Message):
    kb = InlineKeyboardMarkup(inline_keyboard=[
        [InlineKeyboardButton(text="Узнать новости", callback_data="news")],
        [InlineKeyboardButton(text="О нас", callback_data="about")]
    ])
    await message.answer("Выберите действие:", reply_markup=kb)

@dp.callback_query(F.data == "news")
async def show_news(callback: CallbackQuery):
    await callback.answer()  # убирает "часики" на кнопке
    await callback.message.answer("Здесь будут новости!")

from aiogram.fsm.context import FSMContext
from aiogram.fsm.state import State, StatesGroup

class Form(StatesGroup):
    waiting_name = State()
    waiting_age = State()

@dp.message(CommandStart())
async def start_form(message: Message, state: FSMContext):
    await state.set_state(Form.waiting_name)
    await message.answer("Как вас зовут?")

@dp.message(Form.waiting_name)
async def get_name(message: Message, state: FSMContext):
    await state.update_data(name=message.text)
    await state.set_state(Form.waiting_age)
    await message.answer("Сколько вам лет?")

@dp.message(Form.waiting_age)
async def get_age(message: Message, state: FSMContext):
    data = await state.get_data()
    await message.answer(
        f"Приятно познакомиться, {data['name']}! Вам {message.text} лет."
    )
    await state.clear()

[Unit]
Description=My Telegram Bot
After=network.target

[Service]
User=ubuntu
WorkingDirectory=/home/ubuntu/mybot
ExecStart=/home/ubuntu/mybot/venv/bin/python bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

1. Токен хранится прямо в коде

Публикуя код на GitHub с токеном внутри, вы отдаёте бота злоумышленникам. Решение: переменные окружения или файл .env с библиотекой python-dotenv.

2. Синхронные операции внутри async-хендлеров

time.sleep() или requests.get() блокируют весь бот. Решение: аналоги asyncio.sleep() и aiohttp.

3. Отсутствие обработки ошибок и логирования

Бот падает молча, а причина неизвестна. Решение: модуль logging и middleware с try/except.

4. Хранение данных только в памяти

После перезапуска всё теряется. Решение: SQLite/PostgreSQL (SQLAlchemy) и Redis для FSM.

5. Нет защиты от флуда

Telegram забанит бота за превышение лимитов API (~30 сообщений/сек). Решение: механизм антиспама (throttling middleware).

6. Весь код в одном файле

500 строк в bot.py — путь к хаосу. Решение: роутеры aiogram, разделение на handlers/, keyboards/, database/.

7. Игнорирование callback.answer()

Пользователь нажимает inline-кнопку и видит бесконечные «часики». Решение: всегда вызывать await callback.answer().