python-telegram-bot: полное руководство разработчика

О библиотеке python-telegram-bot

python-telegram-bot — самая популярная и мощная Python библиотека для Telegram Bot API, разработанная командой Leandro Toledo. Золотой стандарт для Python разработчиков.

Почему Python лидирует?

Python занимает 1-е место для Telegram ботов:

• Простой и читаемый синтаксис
• Богатая экосистема для AI/ML
• Отличная async поддержка
• Большое сообщество
• Множество готовых решений

Плюсы и минусы

Быстрый старт

pip install python-telegram-bot

from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, filters

async def start(update: Update, context):
    await update.message.reply_text('Привет! Я на python-telegram-bot!')

async def echo(update: Update, context):
    await update.message.reply_text(update.message.text)

def main():
    app = Application.builder().token("YOUR_TOKEN").build()
    
    app.add_handler(CommandHandler("start", start))
    app.add_handler(MessageHandler(filters.TEXT, echo))
    
    app.run_polling()

if __name__ == '__main__':
    main()

Ключевые возможности

from telegram.ext import ConversationHandler

NAME, AGE = range(2)

async def start_survey(update, context):
    await update.message.reply_text('Как вас зовут?')
    return NAME

async def get_name(update, context):
    context.user_data['name'] = update.message.text
    await update.message.reply_text('Сколько вам лет?')
    return AGE

async def get_age(update, context):
    name = context.user_data['name']
    age = update.message.text
    await update.message.reply_text(
        f'Спасибо, {name}! Вам {age} лет.'
    )
    return ConversationHandler.END

conv_handler = ConversationHandler(
    entry_points=[CommandHandler('survey', start_survey)],
    states={
        NAME: [MessageHandler(filters.TEXT, get_name)],
        AGE: [MessageHandler(filters.TEXT, get_age)],
    },
    fallbacks=[]
)

async def alarm(context):
    job = context.job
    await context.bot.send_message(
        chat_id=job.chat_id, 
        text='⏰ Время!'
    )

async def set_timer(update, context):
    try:
        seconds = int(context.args[0])
        context.job_queue.run_once(
            alarm, 
            seconds, 
            chat_id=update.effective_chat.id
        )
        await update.message.reply_text(
            f'Таймер установлен на {seconds} сек!'
        )
    except (IndexError, ValueError):
        await update.message.reply_text(
            'Использование: /timer <секунды>'
        )

Для каких проектов?

Сравнение с конкурентами

Заключение

python-telegram-bot - безусловный лидер для серьезных Python проектов. Лучший выбор для production готовых ботов с complex логикой.