Выбор библиотеки для написания бота на Python

Расширенные примеры использования aiogram

Создание инлайн-клавиатуры

Инлайн-клавиатуры позволяют размещать кнопки под сообщением. Пример с двумя кнопками:

from aiogram import Bot, Dispatcher, types
from aiogram.types import InlineKeyboardMarkup, InlineKeyboardButton
from aiogram.filters import Command

bot = Bot(token="TOKEN")
dp = Dispatcher()

@dp.message(Command("start"))
async def cmd_start(message: types.Message):
    kb = InlineKeyboardMarkup(inline_keyboard=[
        [InlineKeyboardButton(text="Кнопка 1", callback_data="btn1")],
        [InlineKeyboardButton(text="Кнопка 2", callback_data="btn2")]
    ])
    await message.answer("Выберите действие:", reply_markup=kb)

@dp.callback_query()
async def process_callback(callback: types.CallbackQuery):
    await callback.answer()
    if callback.data == "btn1":
        await callback.message.edit_text("Нажата кнопка 1")
    elif callback.data == "btn2":
        await callback.message.edit_text("Нажата кнопка 2")

if __name__ == "__main__":
    import asyncio
    asyncio.run(dp.start_polling(bot))

Результат: после отправки /start пользователь видит сообщение с двумя кнопками. Нажатие на любую кнопку заменяет текст.

Использование конечного автомата (FSM) для многошаговых диалогов

FSM (Finite State Machine) позволяет организовать последовательность вопросов. Пример сбора имени и возраста:

from aiogram import Bot, Dispatcher, types, F
from aiogram.fsm.context import FSMContext
from aiogram.fsm.state import State, StatesGroup
from aiogram.filters import Command

class Form(StatesGroup):
    name = State()
    age = State()

@dp.message(Command("form"))
async def cmd_form(message: types.Message, state: FSMContext):
    await state.set_state(Form.name)
    await message.answer("Как вас зовут?")

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

@dp.message(Form.age)
async def process_age(message: types.Message, state: FSMContext):
    if not message.text.isdigit():
        await message.answer("Пожалуйста, введите число.")
        return
    data = await state.get_data()
    age = int(message.text)
    await message.answer(f"Спасибо, {data['name']}! Вам {age} лет.")
    await state.clear()

Результат: по команде /form бот последовательно запрашивает имя и возраст. При неверном вводе возраста (не число) запрос повторяется.

Настройка вебхука вместо поллинга

Для продакшена часто удобнее использовать вебхук. Пример для aiogram с использованием aiohttp:

from aiohttp import web
from aiogram import Bot, Dispatcher, types
from aiogram.webhook.aiohttp_server import SimpleRequestHandler, setup_application

TOKEN = "TOKEN"
WEBHOOK_PATH = "/webhook"
WEBHOOK_URL = "https://example.com" + WEBHOOK_PATH

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

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

async def on_startup(app):
    await bot.set_webhook(WEBHOOK_URL)

async def on_shutdown(app):
    await bot.delete_webhook()

app = web.Application()
app.on_startup.append(on_startup)
app.on_shutdown.append(on_shutdown)

SimpleRequestHandler(dispatcher=dp, bot=bot).register(app, path=WEBHOOK_PATH)
setup_application(app, dp, bot=bot)

if __name__ == "__main__":
    web.run_app(app, host="0.0.0.0", port=8080)

Результат: сервер запускается на порту 8080, бот получает обновления через POST-запросы на /webhook.

Работа с медиафайлами: отправка фото и документов

Бот может отправлять изображения из URL или локального файла:

from aiogram import Bot, Dispatcher, types
from aiogram.filters import Command

@dp.message(Command("photo"))
async def send_photo(message: types.Message):
    url = "https://example.com/image.jpg"
    await message.answer_photo(photo=url, caption="Вот фото!")

@dp.message(Command("document"))
async def send_document(message: types.Message):
    file_path = "local_file.pdf"
    with open(file_path, "rb") as f:
        await message.answer_document(document=types.BufferedInputFile(f.read(), filename="file.pdf"))

Результат: команда /photo отправляет изображение по ссылке, /document - PDF-файл из локальной папки.

Middleware для логирования и ограничения частоты

Middleware (промежуточное ПО) позволяет выполнять код до и после обработки сообщения. Пример простого логгера:

from aiogram import BaseMiddleware
from typing import Callable, Awaitable, Dict, Any

class LoggingMiddleware(BaseMiddleware):
    async def __call__(
        self,
        handler: Callable[[types.TelegramObject, Dict[str, Any]], Awaitable[Any]],
        event: types.TelegramObject,
        data: Dict[str, Any]
    ) -> Any:
        print(f"Получено событие: {type(event).__name__}")
        result = await handler(event, data)
        print("Обработка завершена")
        return result

dp.message.middleware(LoggingMiddleware())

Результат: в консоль выводятся сообщения о каждом входящем событии и завершении его обработки.