Как перенести бота на aiogram 3 в MAX
aiogram 3 — асинхронный фреймворк для ботов на Python с роутерами, фильтрами и машиной состояний. В aiogram адрес Bot API задаётся через сессию, поэтому перенос в MAX сводится к одной настройке.
Коротко: замените адрес api.telegram.org на api.bothop.ru. Токен, хендлеры и база остаются прежними, а бот начинает работать в MAX.
Что поменять в коде aiogram 3
Там, где создаётся объект Bot. Обычно это bot.py, main.py или loader.py. Зачёркнутая строка — как было, подсвеченная — как станет.
from aiogram import Bot, Dispatcher
from aiogram.client.session.aiohttp import AiohttpSession
from aiogram.client.telegram import TelegramAPIServer
Было: bot = Bot(token=TOKEN)Стало: session = AiohttpSession(api=TelegramAPIServer.from_base("https://api.bothop.ru"))Стало: bot = Bot(token=TOKEN, session=session)dp = Dispatcher()
Если библиотека ещё не установлена: pip install aiogram.
Long polling и вебхук
await dp.start_polling(bot) работает как раньше: шлюз отдаёт события через getUpdates.
Если бот работает на вебхуке через SimpleRequestHandler, оставьте его: bot.set_webhook(url) уйдёт в шлюз, и шлюз будет присылать события на ваш адрес.
MAX сам по себе требует вебхук на порту 443 с сертификатом доверенного центра и повторяет доставку, если не получил ответ вовремя. Эту часть берёт на себя шлюз: он держит вебхук MAX и отсекает дубли до того, как событие дойдёт до вашего бота.
Файлы
bot.download(file) и bot.get_file() тоже идут через сессию, поэтому файлы скачиваются без доработок.
Что заработает сразу
- Текст с форматированием, ответы, пересылка, правка и удаление сообщений
- Inline-кнопки с callback и ссылками, всплывающие уведомления после нажатия
- Фото, видео, аудио, документы, альбомы, контакты и геоточки
- Команды
/startс меткой из ссылки и меню команд - Группы и каналы: участники, администраторы, события входа и выхода
Чего нет в MAX и что сделает шлюз
| В Telegram | Что сделает шлюз | Как |
|---|---|---|
| Клавиатура под полем ввода | Покажет те же кнопки под сообщением. Нажатие отправит боту тот же текст, как в Telegram | Аналог |
| Опросы | Соберёт опрос на кнопках, сам посчитает голоса и обновит результат | Аналог |
| GIF, голосовые, кружки | Отправит как видео и аудио | Аналог |
| Спойлеры и свои эмодзи | Покажет как обычный текст | Аналог |
| Реакции и кубик | Пропустит. Бот получит ok: true и не упадёт | Пропуск |
| Стикеры из Telegram | Пропустит или заменит на эмодзи, который вы выберете | Пропуск |
| Темы в группах | Отправит сообщение в общий чат | Пропуск |
| Inline-режим, игры, звёзды | Вернёт понятную ошибку в формате Telegram | Ошибка |
| Платежи | Переделаем на оплату по ссылке через вашу платёжную систему, например ЮKassa или CloudPayments | Под ключ |
| Мини-приложения | Кнопка откроет приложение. Само приложение адаптируем под MAX | Под ключ |
Как проверить
- Создайте бота в кабинете «MAX для бизнеса» и получите токен.
- Добавьте токен в кабинет BotHop: он выдаст токен в формате Telegram.
- Поменяйте адрес API в коде aiogram 3, как в примере выше, и перезапустите бота.
- Напишите боту в MAX
/startи пройдите основные сценарии.
Нет своего разработчика? Перенесём бота сами за 4 990 ₽: напишите в Telegram @svintsovyan.
Частые вопросы
Работают ли роутеры, фильтры и FSM в aiogram?
Да. Они работают внутри вашего кода и не зависят от мессенджера. Шлюз меняет только то, куда уходят запросы.
Нужно ли менять хендлеры `callback_query`?
Нет. Нажатия на кнопки в MAX приходят как обычный `callback_query` с вашим `callback_data`.
Подойдёт ли это для aiogram 2?
Для aiogram 2 адрес задаётся по-другому, через параметр `server`. Смотрите отдельную инструкцию по aiogram 2.