Aiogram

====================

.. warning::

**Python 3.8 End of Life**: Python 3.8 will reach its end of life (EOL) soon and will no longer
be supported by aiogram in the next releases (1-2 months ETA).

Please upgrade to a newer version of Python to ensure compatibility and receive future updates.

Misc
----

- Increase max pydantic version support "<2.9" -> "<2.10" (only For Python >=3.9)
`1576 <https://github.com/aiogram/aiogram/issues/1576>`_
- Bump aiofiles version upper bound to <24.2
`1577 <https://github.com/aiogram/aiogram/issues/1577>`_


Bugfixes
--------

- Fixed `Default` object annotation resolution using `pydantic`
`1579 <https://github.com/aiogram/aiogram/issues/1579>`_

====================

Features
--------

- - Added updates about purchased paid media, represented by the class
:class:`aiogram.types.paid_media_purchased.PaidMediaPurchased`
and the field :code:`purchased_paid_media` in the class
:class:`aiogram.types.update.Update`.
- Added the ability to specify a payload in
:class:`aiogram.methods.send_paid_media.SendPaidMedia` that is received back by the bot in
:class:`aiogram.types.transaction_partner_user.TransactionPartnerUser`
and :code:`purchased_paid_media` updates.
- Added the field :code:`prize_star_count` to the classes
:class:`aiogram.types.giveaway_created.GiveawayCreated`,
:class:`aiogram.types.giveaway.Giveaway`,
:class:`aiogram.types.giveaway_winners.GiveawayWinners`
and :class:`aiogram.types.chat_boost_source_giveaway.ChatBoostSourceGiveaway`.
- Added the field :code:`is_star_giveaway` to the class
:class:`aiogram.types.giveaway_completed.GiveawayCompleted`.
`1510 <https://github.com/aiogram/aiogram/issues/1510>`_
- Added missing method aliases such as `.answer()`, `.reply()`, and others to `InaccessibleMessage`.
This change ensures consistency and improves usability by aligning the functionality of `InaccessibleMessage` with the `Message` type.
`1574 <https://github.com/aiogram/aiogram/issues/1574>`_


Bugfixes
--------

- Fixed link preview options to use global defaults in various types and methods
to use global defaults for `link_preview_options`.
This change ensures consistency and enhances flexibility in handling link preview options
across different components.
`1543 <https://github.com/aiogram/aiogram/issues/1543>`_

====================

Features
--------

- Added **message_thread_id** parameter to **message.get_url()**.
`1451 <https://github.com/aiogram/aiogram/issues/1451>`_
- Added getting user from `chat_boost` with source `ChatBoostSourcePremium` in `UserContextMiddleware` for `EventContext`
`1474 <https://github.com/aiogram/aiogram/issues/1474>`_
- Added full support of `Bot API 7.8 <https://core.telegram.org/bots/api-changelog#august-14-2024>`_

- Added the ability to send paid media to any chat.
- Added the parameter :code:`business_connection_id` to the method
:class:`aiogram.methods.send_paid_media.SendPaidMedia`,
allowing bots to send paid media on behalf of a business account.
- Added the field :code:`paid_media` to the class
:class:`aiogram.types.transaction_partner_user.TransactionPartnerUser`
for transactions involving paid media.
- Added the method
:class:`aiogram.methods.create_chat_subscription_invite_link.CreateChatSubscriptionInviteLink`,
allowing bots to create subscription invite links.
- Added the method
:class:`aiogram.methods.edit_chat_subscription_invite_link.EditChatSubscriptionInviteLink`,
allowing bots to edit the name of subscription invite links.
- Added the field :code:`until_date` to the class
:class:`aiogram.types.chat_member_member.ChatMemberMember` for members with an active subscription.
- Added support for paid reactions and the class
:class:`aiogram.types.reaction_type_paid.ReactionTypePaid`.
`1560 <https://github.com/aiogram/aiogram/issues/1560>`_


Misc
----

- Improved performance of StatesGroup
`1507 <https://github.com/aiogram/aiogram/issues/1507>`_

====================

Features
--------

- Added full support of `Bot API 7.8 <https://core.telegram.org/bots/api-changelog#july-31-2024>`_

- Added the field :code:`has_main_web_app` to the class :class:`aiogram.types.user.User`,
which is returned in the response to :class:`aiogram.methods.get_me.GetMe`.
- Added the parameter :code:`business_connection_id` to the methods
:class:`aiogram.methods.pin_chat_message.PinChatMessage`
and :class:`aiogram.methods.unpin_chat_message.UnpinChatMessage`,
allowing bots to manage pinned messages on behalf of a business account.
`1551 <https://github.com/aiogram/aiogram/issues/1551>`_


Bugfixes
--------

- Fixed URL path in the "Open" button at the "demo/sendMessage" endpoint in the web_app example.
`1546 <https://github.com/aiogram/aiogram/issues/1546>`_


Misc
----

- Added method :func:`aiogram.types.message.Message.as_reply_parameters`.
Replaced usage of the argument :code:`reply_to_message_id` with :code:`reply_parameters`
in all Message reply methods.
`1538 <https://github.com/aiogram/aiogram/issues/1538>`_
- Added `aiohttp v3.10 <https://github.com/aio-libs/aiohttp/releases/tag/v3.10.0>`_ ` support.
`1548 <https://github.com/aiogram/aiogram/issues/1548>`_

====================

Features
--------

- Added full support of `Bot API 7.7 <https://core.telegram.org/bots/api-changelog#july-7-2024>`_

- Added the class :class:`aiogram.types.refunded_payment.RefundedPayment`,
containing information about a refunded payment.
- Added the field :code:`refunded_payment` to the class
:class:`aiogram.types.message.Message`,
describing a service message about a refunded payment.
`1536 <https://github.com/aiogram/aiogram/issues/1536>`_

===================

Features
--------

- Added ChatMember resolution tool and updated 2.x migration guide.
`1525 <https://github.com/aiogram/aiogram/issues/1525>`_
- Added full support of `Bot API 7.6 <https://core.telegram.org/bots/api-changelog#july-1-2024>`_

- Added the classes :class:`aiogram.types.paid_media.PaidMedia`,
:class:`aiogram.types.paid_media_info.PaidMediaInfo`,
:class:`aiogram.types.paid_media_preview.PaidMediaPreview`,
:class:`aiogram.types.paid_media_photo.PaidMediaPhoto`
and :class:`aiogram.types.paid_media_video.PaidMediaVideo`,
containing information about paid media.
- Added the method :class:`aiogram.methods.send_paid_media.SendPaidMedia`
and the classes :class:`aiogram.types.input_paid_media.InputPaidMedia`,
:class:`aiogram.types.input_paid_media_photo.InputPaidMediaPhoto`
and :class:`aiogram.types.input_paid_media_video.InputPaidMediaVideo`,
to support sending paid media.
- Documented that the methods :class:`aiogram.methods.copy_message.CopyMessage`
and :class:`aiogram.methods.copy_messages.CopyMessages` cannot be used to copy paid media.
- Added the field :code:`can_send_paid_media` to the class
:class:`aiogram.types.chat_full_info.ChatFullInfo`.
- Added the field :code:`paid_media` to the classes
:class:`aiogram.types.message.Message` and
:class:`aiogram.types.external_reply_info.ExternalReplyInfo`.
- Added the class
:class:`aiogram.types.transaction_partner_telegram_ads.TransactionPartnerTelegramAds`,
containing information about Telegram Star transactions involving the Telegram Ads Platform.
- Added the field :code:`invoice_payload` to the class
:class:`aiogram.types.transaction_partner_user.TransactionPartnerUser`,
containing the bot-specified invoice payload.
- Changed the default opening mode for Direct Link Mini Apps.
- Added support for launching Web Apps via t.me link in the class
:class:`aiogram.types.menu_button_web_app.MenuButtonWebApp`.
- Added the field :code:`section_separator_color` to the class :code:`ThemeParams`.
`1533 <https://github.com/aiogram/aiogram/issues/1533>`_


Bugfixes
--------

- Fixed event context resolving for the callback query that is coming from the business account
`1520 <https://github.com/aiogram/aiogram/issues/1520>`_