Разработка Telegram-ботов на Python с помощью aiogram 3

Введение в aiogram 3: регистрация бота в BotFather и запуск эхо-бота

Разработка современных приложений для мессенджеров требует надежных и быстрых инструментов. Платформа Telegram предоставляет мощный API для взаимодействия с пользователями, а язык программирования Python предлагает множество библиотек для работы с этим интерфейсом. Одной из самых популярных и эффективных библиотек является aiogram.

Ключевая особенность aiogram заключается в полной поддержке асинхронности. В отличие от устаревших синхронных подходов, где программа блокируется в ожидании ответа от сервера, асинхронный код позволяет обрабатывать тысячи сообщений одновременно. Это достигается за счет использования встроенного модуля asyncio.

Чтобы понять математическое преимущество асинхронности, рассмотрим время обработки запросов. Пусть у нас есть пользователей, каждый из которых отправляет сообщение, требующее времени на обработку сервером. При синхронном подходе общее время выполнения составит:

Где — общее время синхронной работы, — количество запросов, а — время обработки -го запроса. Программа будет ждать завершения каждого шага по очереди. В асинхронной модели, благодаря конкурентному выполнению задач, идеальное время обработки стремится к времени самой долгой операции:

Где — время асинхронной работы, а — функция выбора максимального значения из множества временных отрезков .

Например, если 5 пользователей одновременно отправляют запросы, каждый из которых обрабатывается ровно 2 секунды, синхронный бот ответит последнему пользователю через 10 секунд (). Асинхронный бот на aiogram начнет обрабатывать все 5 запросов параллельно и ответит всем примерно через 2 секунды.

Сравнение популярных библиотек

Для наглядности рассмотрим основные инструменты, доступные разработчикам на Python.

| Характеристика | aiogram 3.x | python-telegram-bot | pyTelegramBotAPI (Telebot) | |---|---|---|---| | Архитектура | Полностью асинхронная | Поддерживает асинхронность (с версии 20.x) | Синхронная (асинхронность добавлена как надстройка) | | Скорость работы | Очень высокая | Высокая | Средняя | | Сложность освоения | Средняя | Высокая | Низкая | | Идеально подходит для | Высоконагруженных проектов и сложных ботов | Крупных проектов со сложной структурой | Простых скриптов и обучения новичков |

Регистрация бота и получение токена

Любое взаимодействие с серверами Telegram начинается с получения уникального ключа доступа — токена. Этот процесс централизован и происходит через официального системного бота BotFather.

Откройте мессенджер и введите в глобальный поиск @BotFather. Убедитесь, что рядом с именем стоит синяя галочка верификации.

Нажмите кнопку «Запустить» или отправьте команду /start.

Отправьте команду /newbot для создания нового проекта.

Введите имя бота (оно будет отображаться в списке контактов и чатах, может быть на любом языке).

Введите username (уникальное имя пользователя). Оно должно быть на английском языке, не содержать пробелов и обязательно заканчиваться на слово bot (например, MyAwesome_bot или super_shop_bot).

В ответ BotFather пришлет сообщение, содержащее HTTP API токен. Он выглядит как длинная строка из цифр и букв, например: 1234567890:ABCDefghIJKLmnopQRSTuvwxYZ123456789.

!Схема взаимодействия пользователя, серверов Telegram и Python-скрипта

> Токен — это единственный ключ к управлению вашим ботом. Тот, кто владеет токеном, может читать все сообщения пользователей и отправлять спам от имени вашего проекта. > > Официальная документация Telegram API

Если вы случайно опубликуете токен в открытом доступе (например, на GitHub), злоумышленники могут перехватить его за считанные секунды. Представьте: база вашего магазина насчитывает 5 000 клиентов. Получив токен, хакер может отправить всем 5 000 пользователям фишинговую ссылку. При конверсии в 5% по ссылке перейдут 250 человек, что нанесет непоправимый удар по репутации бизнеса.

Подготовка рабочего окружения

Для начала работы убедитесь, что на вашем компьютере установлен Python версии не ниже 3.8 (рекомендуется 3.10 или 3.11). Создайте новую папку для проекта и откройте ее в вашем любимом редакторе кода (например, VS Code или PyCharm).

Установите библиотеку aiogram третьей версии с помощью пакетного менеджера pip, выполнив следующую команду в терминале:

Создание первого эхо-бота

Эхо-бот — это классическое приложение уровня «Hello World» в мире разработки ботов. Его задача предельно проста: получать текстовое сообщение от пользователя и отправлять точно такой же текст в ответ.

Создайте файл main.py и напишите следующий код:

Разбор архитектуры кода

Каждая строка в этом скрипте выполняет строго определенную функцию. Разберем ключевые компоненты:

Объект Bot отвечает за связь с серверами Telegram. Он хранит токен и содержит методы для отправки данных (например, bot.send_message()). В нашем примере метод отправки вызывается неявно через message.answer(), что является удобной синтаксической оберткой.

Объект Dispatcher (диспетчер) — это мозг нашего приложения. Он получает все входящие события (апдейты) от серверов Telegram и решает, какая именно функция должна на них отреагировать.

!Визуализация работы диспетчера и маршрутизации сообщений

Декораторы @dp.message() используются для регистрации обработчиков (хендлеров). Декоратор — это специальная конструкция в Python, которая оборачивает функцию и расширяет ее поведение.

В коде выше мы видим два обработчика:

handle_start реагирует только на сообщения, содержащие команду /start. Это достигается за счет использования фильтра CommandStart().

echo_message не имеет фильтров, поэтому он перехватывает абсолютно все текстовые сообщения, которые не были обработаны предыдущими функциями.

Порядок регистрации обработчиков имеет критическое значение. Диспетчер проверяет фильтры сверху вниз. Если бы мы поставили пустой декоратор @dp.message() самым первым, он бы перехватил команду /start, и функция handle_start никогда бы не выполнилась.

Механизм получения обновлений

В конце скрипта вызывается метод dp.start_polling(bot). Поллинг (Long Polling) — это процесс, при котором скрипт непрерывно отправляет запросы к серверу Telegram с вопросом: «Есть ли новые сообщения?».

Если сообщений нет, сервер «удерживает» соединение открытым на несколько десятков секунд, а затем отвечает пустым списком. Если сообщение появляется, сервер немедленно отдает его боту. Этот подход идеален для локальной разработки и небольших проектов, так как не требует настройки выделенного IP-адреса и SSL-сертификатов.

Запустите скрипт командой python main.py в терминале. Откройте диалог с вашим ботом в мессенджере, нажмите «Запустить» и отправьте любой текст. Бот мгновенно ответит вам тем же сообщением, подтверждая, что вся цепочка от регистрации до написания кода работает корректно.