Примеры разработки ботов для мессенджера Telegram на языке Python

Пример 1: Inline-клавиатура и обработка callback (python-telegram-bot)

Создание клавиатуры с кнопками и реакция на нажатие:

import asyncio
from telegram import Update, InlineKeyboardButton, InlineKeyboardMarkup
from telegram.ext import Application, CommandHandler, CallbackQueryHandler

async def start(update: Update, context):
    keyboard = [
        [InlineKeyboardButton("Кнопка 1", callback_data='btn1'),
         InlineKeyboardButton("Кнопка 2", callback_data='btn2')]
    ]
    reply_markup = InlineKeyboardMarkup(keyboard)
    await update.message.reply_text("Выберите опцию:", reply_markup=reply_markup)

async def button_callback(update: Update, context):
    query = update.callback_query
    await query.answer()
    if query.data == 'btn1':
        await query.edit_message_text("Вы выбрали Кнопку 1")
    else:
        await query.edit_message_text("Вы выбрали Кнопку 2")

async def main():
    app = Application.builder().token("YOUR_TOKEN").build()
    app.add_handler(CommandHandler("start", start))
    app.add_handler(CallbackQueryHandler(button_callback))
    await app.run_polling()

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

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

(No output in console, bot running)

Пример 2: Отправка фотографии (aiogram)

Отправка изображения из файла:

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

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

@dp.message(Command("photo"))
async def send_photo(message: types.Message):
    with open("example.jpg", "rb") as photo:
        await message.answer_photo(photo, caption="Это тестовое фото")

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

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

Вместо локального файла можно указать URL: types.FSInputFile.from_url("https://example.com/photo.jpg") (в aiogram 3.x). Результат: бот отправляет фото с подписью.

Пример 3: Машина состояний (FSM) на aiogram

Реализация опроса в два шага: имя и возраст:

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

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

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

@dp.message(Command("start"))
async def cmd_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):
    if not message.text.isdigit():
        await message.answer("Пожалуйста, введите число.")
        return
    data = await state.get_data()
    name = data['name']
    age = message.text
    await message.answer(f"Спасибо, {name}! Вам {age} лет.")
    await state.clear()

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

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

Результат: бот последовательно запрашивает имя и возраст, сохраняя контекст.

Пример 4: Планировщик задач (JobQueue) в python-telegram-bot

Отправка сообщения каждые 10 секунд:

import asyncio
from telegram import Update
from telegram.ext import Application, CommandHandler, ContextTypes

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    chat_id = update.effective_chat.id
    context.job_queue.run_repeating(send_message, interval=10, first=0, data=chat_id)
    await update.message.reply_text("Запущено! Приходите через 10 секунд.")

async def send_message(context: ContextTypes.DEFAULT_TYPE):
    job = context.job
    chat_id = job.data
    await context.bot.send_message(chat_id, "Прошло 10 секунд!")

async def main():
    app = Application.builder().token("YOUR_TOKEN").build()
    app.add_handler(CommandHandler("start", start))
    await app.run_polling()

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

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

Пример 5: Использование вебхуков с python-telegram-bot (на Flask)

Настройка вебхука для продакшена:

import asyncio
from flask import Flask, request
import telegram

TOKEN = "YOUR_TOKEN"
WEBHOOK_URL = "https://your-domain.com/webhook"

bot = telegram.Bot(token=TOKEN)
app = Flask(__name__)

@app.route("/webhook", methods=["POST"])
def webhook():
    update = telegram.Update.de_json(request.get_json(force=True), bot)
    if update.message:
        update.message.reply_text("Получено!")
    return "OK"

if __name__ == "__main__":
    bot.set_webhook(url=WEBHOOK_URL)
    app.run()

Для production рекомендуется использовать асинхронные серверы, например aiohttp. Результат: бот получает обновления через вебхук.