Разработка асинхронного бота для Telegram с использованием aiogram

Как организовать обработку текстовых сообщений с фильтрами?

Для обработки не только команд, но и обычных сообщений используются фильтры, например, TextContains или StateFilter. В aiogram 3.x фильтры передаются в декоратор.

from aiogram.filters import Text

@dp.message(Text(text="Привет"))
async def hello_handler(message: types.Message):
    await message.answer("И тебе привет!")

Aiogram python (создание бота на aiogram (асинхронный telegram бот))

Также можно использовать F (магический фильтр) для создания сложных условий.

from aiogram import F

@dp.message(F.text.lower().contains("пока"))
async def bye_handler(message: types.Message):
    await message.answer("До свидания!")

библиотека имен python (библиотека имен в python)

Как реализовать диалог с пользователем (FSM)?

Для многошаговых сценариев используется FSM (Finite State Machine). В aiogram есть встроенная поддержка состояний через State и StatesGroup.

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

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

@dp.message(Command("form"))
async def form_start(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):
    data = await state.get_data()
    await message.answer(f"Спасибо, {data['name']}! Ваш возраст: {message.text}")
    await state.clear()

Python pandas типы данных (типы данных pandas в python)

Как добавлять клавиатуры (Reply и Inline)?

Клавиатуры делают взаимодействие удобнее. Reply-клавиатура отправляет кнопки в поле ввода, Inline – кнопки под сообщением.

from aiogram.types import ReplyKeyboardMarkup, KeyboardButton, InlineKeyboardMarkup, InlineKeyboardButton

# Reply клавиатура
reply_kb = ReplyKeyboardMarkup(
    keyboard=[
        [KeyboardButton(text="Кнопка 1"), KeyboardButton(text="Кнопка 2")],
        [KeyboardButton(text="Кнопка 3")]
    ],
    resize_keyboard=True
)

@dp.message(Command("reply_kb"))
async def show_reply_kb(message: types.Message):
    await message.answer("Выберите действие:", reply_markup=reply_kb)

# Inline клавиатура с callback_data
inline_kb = InlineKeyboardMarkup(
    inline_keyboard=[
        [InlineKeyboardButton(text="Нажми меня", callback_data="btn_pressed")]
    ]
)

@dp.message(Command("inline_kb"))
async def show_inline_kb(message: types.Message):
    await message.answer("Кнопка под сообщением:", reply_markup=inline_kb)

@dp.callback_query(lambda c: c.data == "btn_pressed")
async def process_callback(callback: types.CallbackQuery):
    await callback.answer("Вы нажали кнопку!")
    await callback.message.edit_text("Кнопка нажата")

Как обрабатывать ошибки и логировать?

Можно использовать middleware или глобальный обработчик ошибок. В aiogram есть встроенный ErrorEvent.

from aiogram.types import ErrorEvent

@dp.error()
async def error_handler(event: ErrorEvent):
    print(f"Ошибка: {event.exception}")
    await event.update.message.answer("Произошла внутренняя ошибка.")

Также middleware позволяют перехватывать все обновления до обработчиков.

from aiogram import BaseMiddleware

class LoggingMiddleware(BaseMiddleware):
    async def __call__(self, handler, event, data):
        print(f"Получено обновление: {event}")
        return await handler(event, data)

dp.message.middleware(LoggingMiddleware())