Skip to content

Releases

v1.4.0

Choose a tag to compare

@juntatalor juntatalor released this 15 Nov 10:16
094a697

Что нового

  • Тихие события ухода (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 — метка диплинка доезжает до бота

Choose a tag to compare

@juntatalor juntatalor released this 23 Oct 16:34
fe5088e

Ссылка вида 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

Choose a tag to compare

@juntatalor juntatalor released this 17 Aug 17:21
8242eaa

Пересылка и ответ доезжают до 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 без тела не роняет опрос

Choose a tag to compare

@juntatalor juntatalor released this 09 Aug 14:45
da7dad6

Починка аварии на проде pocherk 9 августа: MAX прислал message_created без поля message, to_update падал с KeyError, и валился весь круг get_updates. Событие оставалось в голове очереди и роняло каждый следующий круг — опрос MAX стоял, люди не получали ответов.

Теперь такое событие пропускается, как message_removed и прочие неизвестные типы: один странный апдейт не останавливает бота целиком.

ПР: #4

v1.1.1 — первая публикация на PyPI

Choose a tag to compare

@juntatalor juntatalor released this 07 Aug 11:23
ade60e0

Первый выпуск пакета на PyPI: pip install aiogram-max

Кода не касается — с v1.1.0 изменились только метаданные пакета, бейджи в README и workflow публикации.

Публикация идёт через доверенного издателя PyPI: короткоживущий OIDC-токен от GitHub, постоянного секрета в репозитории нет.

v1.1.0 — публичный marker

Choose a tag to compare

@juntatalor juntatalor released this 07 Aug 10:54
5654eb1

Свойство MaxSession.marker — позиция в ленте событий MAX после последнего get_updates, включая пропущенные библиотекой события.

Без него потребитель со своим polling-циклом вставал намертво на первом же message_removed: наверх пусто, двигать позицию нечем, следующий запрос возвращает то же событие.

Заодно version в pyproject приведена к тегу — было 0.3.0 при выпущенном v1.0.0.

v0.1.0

Choose a tag to compare

@juntatalor juntatalor released this 27 Jul 21:37

Первая версия. 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 это делается).