Как выбрать библиотеку для Telegram бота на Python

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

Реализация диалога (FSM) с помощью python-telegram-bot

В этом примере бот собирает имя и возраст пользователя, используя ConversationHandler.

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

# Состояния
NAME, AGE = range(2)

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text(
        'Привет! Как тебя зовут?',
        reply_markup=ReplyKeyboardRemove()
    )
    return NAME

async def get_name(update: Update, context: ContextTypes.DEFAULT_TYPE):
    context.user_data['name'] = update.message.text
    await update.message.reply_text(
        f'Приятно познакомиться, {context.user_data["name"]}! Сколько тебе лет?'
    )
    return AGE

async def get_age(update: Update, context: ContextTypes.DEFAULT_TYPE):
    text = update.message.text
    if not text.isdigit():
        await update.message.reply_text('Пожалуйста, введите число.')
        return AGE
    age = int(text)
    context.user_data['age'] = age
    await update.message.reply_text(
        f'Итак, тебя зовут {context.user_data["name"]} и тебе {age} лет.'
    )
    return ConversationHandler.END

async def cancel(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text('Диалог отменён.')
    return ConversationHandler.END

conv_handler = ConversationHandler(
    entry_points=[CommandHandler('start', start)],
    states={
        NAME: [MessageHandler(filters.TEXT & ~filters.COMMAND, get_name)],
        AGE: [MessageHandler(filters.TEXT & ~filters.COMMAND, get_age)],
    },
    fallbacks=[CommandHandler('cancel', cancel)]
)

app = Application.builder().token('YOUR_TOKEN').build()
app.add_handler(conv_handler)
app.run_polling()

Пользователь вводит /start -> бот спрашивает имя -> получает имя -> спрашивает возраст -> выводит итог.

Отправка медиа (фото и документов) с помощью aiogram

Пример отправки изображения из локального файла и документа.

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

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

@dp.message(Command('send_media'))
async def send_media(message: types.Message):
    # Отправка фото
    with open('image.jpg', 'rb') as photo:
        await message.answer_photo(photo, caption='Это моё фото')
    # Отправка документа
    doc = types.FSInputFile('report.pdf')
    await message.answer_document(doc, caption='Отчёт')

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

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

Пользователь пишет /send_media -> бот отправляет фото и документ.

Обработка inline-запросов (pyTelegramBotAPI)

Бот отвечает на inline-запросы из других чатов.

import telebot
from telebot.types import InlineQueryResultArticle, InputTextMessageContent

TOKEN = 'YOUR_TOKEN'
bot = telebot.TeleBot(TOKEN)

@bot.inline_handler(lambda query: len(query.query) > 0)
def query_text(inline_query):
    try:
        r = InlineQueryResultArticle(
            id='1',
            title='Повторить текст',
            input_message_content=InputTextMessageContent(inline_query.query)
        )
        bot.answer_inline_query(inline_query.id, [r])
    except Exception as e:
        print(e)

bot.polling()

Пользователь вводит @YourBot какой-то текст -> появляется кнопка с этим текстом, при нажатии текст отправляется в чат.

Использование middleware в aiogram для логирования

Middleware позволяет перехватывать все входящие обновления и выполнять дополнительную логику.

from aiogram import Bot, Dispatcher, types
from aiogram.dispatcher.middlewares.base import BaseMiddleware
from aiogram.types import Update
import asyncio
import logging

logging.basicConfig(level=logging.INFO)

class LoggingMiddleware(BaseMiddleware):
    async def __call__(self, handler, event: Update, data):
        logging.info(f'Получено событие: {event.update_id}')
        return await handler(event, data)

TOKEN = 'YOUR_TOKEN'
bot = Bot(token=TOKEN)
dp = Dispatcher()
dp.update.middleware(LoggingMiddleware())

@dp.message()
async def echo(message: types.Message):
    await message.answer(f'Вы сказали: {message.text}')

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

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

В консоль будет выводиться update_id каждого входящего обновления.