Repository navigation
Releases
v1.4.0
Что нового
- Тихие события ухода (
bot_stopped,dialog_removed) конвертируются в пустойUpdate: позиция ленты двигается штатно, потребитель видитkind=unknownвместо «прыжка» по подсказке. MaxSession.dropped_events— сырые словари тихих и отброшенных событий последней пачки (update_type,user_id,chat_id,timestamp) для аналитики отписок. Список заменяется целиком на каждомget_updates.is_quiet(raw)— публичная проверка тихого типа.
v1.3.0 — метка диплинка доезжает до бота
Ссылка вида https://max.ru/<бот>?start=<метка> приносит метку в поле payload события bot_started. Конвертер его не читал: текст подставлялся константой "/start", и метка пропадала молча — а на ней держатся привязка аккаунта одним нажатием, реферальные ссылки и метки рекламного источника.
Что изменилось
payloadкладётся хвостом команды, ровно как отдаёт Telegram:"/start t7k3f9zqm". Обработчику не нужно знать площадку,CommandObject.argsработает одинаково на обеих.- Пустой или отсутствующий
payloadдаёт прежнее"/start"— старое поведение не меняется, обновление безопасное. - В README появился раздел «Диплинки»: формат ссылки, пример обработчика, лимит 128 символов, требования к версии приложения (iOS 2.7.0+, Android 2.9.0+).
Почему это стоило отдельной версии
В документации MAX поле payload описано, а то, что заполняет его параметр start, — нет. Отсюда распространённый вывод «в MAX диплинков нет» и обходные пути вида «откройте бота и пришлите код 4821» — лишний шаг и заметно худшая конверсия.
PR: #7
1.2.0 — пересылка и ответ из MAX
Пересылка и ответ доезжают до aiogram
MAX кладёт оба случая в поле message.link, различая их по type. Библиотека это поле не читала.
Для ответа потеря была умеренной — терялась цитата. А у пересланного сообщения внешний body.text приходит пустым: весь текст лежит в link.message.text. Форвард доезжал до бота как сообщение без текста и без признака пересылки, и бот на такое обычно не отвечал вовсе.
| MAX | aiogram |
|---|---|
link: {type: forward, sender, message} |
forward_origin (MessageOriginUser), текст из link.message.text |
link: {type: reply, sender, message} |
reply_to_message |
Скрытый отправитель отдаётся как MessageOriginHiddenUser. Незнакомый вид связи ничего не роняет: сообщение доезжает как обычное.
Форма объекта снята с живого API 17 августа 2026 — страница LinkedMessage в документации MAX отдаёт 404. Оба события обезличены и лежат в живых фикстурах.
Совместимость: ломающих изменений нет, обычные сообщения разбираются как раньше.
v1.1.2 — message_created без тела не роняет опрос
Починка аварии на проде pocherk 9 августа: MAX прислал message_created без поля message, to_update падал с KeyError, и валился весь круг get_updates. Событие оставалось в голове очереди и роняло каждый следующий круг — опрос MAX стоял, люди не получали ответов.
Теперь такое событие пропускается, как message_removed и прочие неизвестные типы: один странный апдейт не останавливает бота целиком.
ПР: #4
v1.1.1 — первая публикация на PyPI
Первый выпуск пакета на PyPI: pip install aiogram-max
Кода не касается — с v1.1.0 изменились только метаданные пакета, бейджи в README и workflow публикации.
Публикация идёт через доверенного издателя PyPI: короткоживущий OIDC-токен от GitHub, постоянного секрета в репозитории нет.
v1.1.0 — публичный marker
Свойство MaxSession.marker — позиция в ленте событий MAX после последнего get_updates, включая пропущенные библиотекой события.
Без него потребитель со своим polling-циклом вставал намертво на первом же message_removed: наверх пусто, двигать позицию нечем, следующий запрос возвращает то же событие.
Заодно version в pyproject приведена к тегу — было 0.3.0 при выпущенном v1.0.0.
v0.1.0
Первая версия. aiogram-бот работает в MAX без правок кода: подменяется только транспорт.
Проверено на живом MAX Bot API: polling, /start, текст, inline-клавиатура, callback, скачивание вложений.
Поддержано: GetUpdates, SendMessage, EditMessageText, DeleteMessage, AnswerCallbackQuery, GetFile, GetMe, SendChatAction (no-op — у MAX нет typing).
Остальное разведено на два случая: UnsupportedByMax (свойство платформы) и NotImplementedYet (ждём PR, в тексте ошибки подсказка каким методом MAX это делается).