Update docs

2026-04-08 16:37:47 +00:00 · 2022-11-25 05:25:26 +02:00 · 2022-11-25 05:25:26 +02:00 · e84b8b92e6
commit e84b8b92e6
parent 3d38577bb0
70 changed files with 203 additions and 264 deletions
--- a/.butcher/templates/enums/index.rst.jinja2
+++ b/.butcher/templates/enums/index.rst.jinja2
@ -1,5 +1,5 @@
 #####
-Types
+Enums
 #####

 Here is list of all available enums:
--- a/.butcher/templates/methods/entity.rst.jinja2
+++ b/.butcher/templates/methods/entity.rst.jinja2
@ -47,7 +47,7 @@ As reply into Webhook in handler

 {% if aliased %}
 As shortcut from received object
-------------------
+--------------------------------
 {% for alias in aliased %}
 - :meth:`aiogram.types.{{ alias.type|pythonize_name }}.{{ alias.type|pythonize_class_name }}.{{ alias.name }}`
 {%- endfor %}
--- a/.butcher/types/ErrorEvent/replace.yml
+++ b/.butcher/types/ErrorEvent/replace.yml
@ -0,0 +1,2 @@
+bases:
+  - _ErrorEvent
--- a/aiogram/client/bot.py
+++ b/aiogram/client/bot.py
@ -175,10 +175,6 @@ T = TypeVar("T")


 class Bot(ContextInstanceMixin["Bot"]):
-    """
-    Bot class
-    """
-
    def __init__(
        self,
        token: str,
@ -186,6 +182,8 @@ class Bot(ContextInstanceMixin["Bot"]):
        parse_mode: Optional[str] = None,
    ) -> None:
        """
+        Bot class
+
        :param token: Telegram Bot token `Obtained from @BotFather <https://t.me/BotFather>`_
        :param session: HTTP Client session (For example AiohttpSession).
            If not specified it will be automatically created.
@ -234,6 +232,11 @@ class Bot(ContextInstanceMixin["Bot"]):
            self.reset_current(token)

    async def me(self) -> User:
+        """
+        Cached alias for getMe method
+
+        :return:
+        """
        if self._me is None:  # pragma: no cover
            self._me = await self.get_me()
        return self._me
--- a/aiogram/types/init.py
+++ b/aiogram/types/init.py
@ -36,6 +36,7 @@ from .document import Document
 from .downloadable import Downloadable
 from .encrypted_credentials import EncryptedCredentials
 from .encrypted_passport_element import EncryptedPassportElement
+from .error_event import ErrorEvent
 from .file import File
 from .force_reply import ForceReply
 from .forum_topic import ForumTopic
@ -141,150 +142,151 @@ from .web_app_info import WebAppInfo
 from .webhook_info import WebhookInfo

 __all__ = (
-    "TelegramObject",
-    "Downloadable",
-    "UNSET",
-    "BufferedInputFile",
-    "FSInputFile",
-    "URLInputFile",
-    "Update",
-    "WebhookInfo",
-    "User",
-    "Chat",
-    "Message",
-    "ContentType",
-    "MessageId",
-    "MessageEntity",
-    "PhotoSize",
    "Animation",
    "Audio",
-    "Document",
-    "Video",
-    "VideoNote",
-    "Voice",
-    "Contact",
-    "Dice",
-    "PollOption",
-    "PollAnswer",
-    "Poll",
-    "Location",
-    "Venue",
-    "WebAppData",
-    "ProximityAlertTriggered",
-    "MessageAutoDeleteTimerChanged",
-    "ForumTopicCreated",
-    "ForumTopicClosed",
-    "ForumTopicReopened",
-    "VideoChatScheduled",
-    "VideoChatStarted",
-    "VideoChatEnded",
-    "VideoChatParticipantsInvited",
-    "UserProfilePhotos",
-    "File",
-    "WebAppInfo",
-    "ReplyKeyboardMarkup",
-    "KeyboardButton",
-    "KeyboardButtonPollType",
-    "ReplyKeyboardRemove",
-    "InlineKeyboardMarkup",
-    "InlineKeyboardButton",
-    "LoginUrl",
-    "CallbackQuery",
-    "ForceReply",
-    "ChatPhoto",
-    "ChatInviteLink",
-    "ChatAdministratorRights",
-    "ChatMember",
-    "ChatMemberOwner",
-    "ChatMemberAdministrator",
-    "ChatMemberMember",
-    "ChatMemberRestricted",
-    "ChatMemberLeft",
-    "ChatMemberBanned",
-    "ChatMemberUpdated",
-    "ChatJoinRequest",
-    "ChatPermissions",
-    "ChatLocation",
-    "ForumTopic",
    "BotCommand",
    "BotCommandScope",
-    "BotCommandScopeDefault",
-    "BotCommandScopeAllPrivateChats",
-    "BotCommandScopeAllGroupChats",
    "BotCommandScopeAllChatAdministrators",
+    "BotCommandScopeAllGroupChats",
+    "BotCommandScopeAllPrivateChats",
    "BotCommandScopeChat",
    "BotCommandScopeChatAdministrators",
    "BotCommandScopeChatMember",
-    "MenuButton",
-    "MenuButtonCommands",
-    "MenuButtonWebApp",
-    "MenuButtonDefault",
-    "ResponseParameters",
-    "InputMedia",
-    "InputMediaPhoto",
-    "InputMediaVideo",
-    "InputMediaAnimation",
-    "InputMediaAudio",
-    "InputMediaDocument",
-    "InputFile",
-    "Sticker",
-    "StickerSet",
-    "MaskPosition",
+    "BotCommandScopeDefault",
+    "BufferedInputFile",
+    "CallbackGame",
+    "CallbackQuery",
+    "Chat",
+    "ChatAdministratorRights",
+    "ChatInviteLink",
+    "ChatJoinRequest",
+    "ChatLocation",
+    "ChatMember",
+    "ChatMemberAdministrator",
+    "ChatMemberBanned",
+    "ChatMemberLeft",
+    "ChatMemberMember",
+    "ChatMemberOwner",
+    "ChatMemberRestricted",
+    "ChatMemberUpdated",
+    "ChatPermissions",
+    "ChatPhoto",
+    "ChosenInlineResult",
+    "Contact",
+    "ContentType",
+    "Dice",
+    "Document",
+    "Downloadable",
+    "EncryptedCredentials",
+    "EncryptedPassportElement",
+    "ErrorEvent",
+    "FSInputFile",
+    "File",
+    "ForceReply",
+    "ForumTopic",
+    "ForumTopicClosed",
+    "ForumTopicCreated",
+    "ForumTopicReopened",
+    "Game",
+    "GameHighScore",
+    "InlineKeyboardButton",
+    "InlineKeyboardMarkup",
    "InlineQuery",
    "InlineQueryResult",
    "InlineQueryResultArticle",
-    "InlineQueryResultPhoto",
-    "InlineQueryResultGif",
-    "InlineQueryResultMpeg4Gif",
-    "InlineQueryResultVideo",
    "InlineQueryResultAudio",
-    "InlineQueryResultVoice",
-    "InlineQueryResultDocument",
-    "InlineQueryResultLocation",
-    "InlineQueryResultVenue",
-    "InlineQueryResultContact",
-    "InlineQueryResultGame",
-    "InlineQueryResultCachedPhoto",
+    "InlineQueryResultCachedAudio",
+    "InlineQueryResultCachedDocument",
    "InlineQueryResultCachedGif",
    "InlineQueryResultCachedMpeg4Gif",
+    "InlineQueryResultCachedPhoto",
    "InlineQueryResultCachedSticker",
-    "InlineQueryResultCachedDocument",
    "InlineQueryResultCachedVideo",
    "InlineQueryResultCachedVoice",
-    "InlineQueryResultCachedAudio",
+    "InlineQueryResultContact",
+    "InlineQueryResultDocument",
+    "InlineQueryResultGame",
+    "InlineQueryResultGif",
+    "InlineQueryResultLocation",
+    "InlineQueryResultMpeg4Gif",
+    "InlineQueryResultPhoto",
+    "InlineQueryResultVenue",
+    "InlineQueryResultVideo",
+    "InlineQueryResultVoice",
+    "InputContactMessageContent",
+    "InputFile",
+    "InputInvoiceMessageContent",
+    "InputLocationMessageContent",
+    "InputMedia",
+    "InputMediaAnimation",
+    "InputMediaAudio",
+    "InputMediaDocument",
+    "InputMediaPhoto",
+    "InputMediaVideo",
    "InputMessageContent",
    "InputTextMessageContent",
-    "InputLocationMessageContent",
    "InputVenueMessageContent",
-    "InputContactMessageContent",
-    "InputInvoiceMessageContent",
-    "ChosenInlineResult",
-    "SentWebAppMessage",
-    "LabeledPrice",
    "Invoice",
-    "ShippingAddress",
+    "KeyboardButton",
+    "KeyboardButtonPollType",
+    "LabeledPrice",
+    "Location",
+    "LoginUrl",
+    "MaskPosition",
+    "MenuButton",
+    "MenuButtonCommands",
+    "MenuButtonDefault",
+    "MenuButtonWebApp",
+    "Message",
+    "MessageAutoDeleteTimerChanged",
+    "MessageEntity",
+    "MessageId",
    "OrderInfo",
-    "ShippingOption",
-    "SuccessfulPayment",
-    "ShippingQuery",
-    "PreCheckoutQuery",
    "PassportData",
-    "PassportFile",
-    "EncryptedPassportElement",
-    "EncryptedCredentials",
    "PassportElementError",
    "PassportElementErrorDataField",
+    "PassportElementErrorFile",
+    "PassportElementErrorFiles",
    "PassportElementErrorFrontSide",
    "PassportElementErrorReverseSide",
    "PassportElementErrorSelfie",
-    "PassportElementErrorFile",
-    "PassportElementErrorFiles",
    "PassportElementErrorTranslationFile",
    "PassportElementErrorTranslationFiles",
    "PassportElementErrorUnspecified",
-    "Game",
-    "CallbackGame",
-    "GameHighScore",
+    "PassportFile",
+    "PhotoSize",
+    "Poll",
+    "PollAnswer",
+    "PollOption",
+    "PreCheckoutQuery",
+    "ProximityAlertTriggered",
+    "ReplyKeyboardMarkup",
+    "ReplyKeyboardRemove",
+    "ResponseParameters",
+    "SentWebAppMessage",
+    "ShippingAddress",
+    "ShippingOption",
+    "ShippingQuery",
+    "Sticker",
+    "StickerSet",
+    "SuccessfulPayment",
+    "TelegramObject",
+    "UNSET",
+    "URLInputFile",
+    "Update",
+    "User",
+    "UserProfilePhotos",
+    "Venue",
+    "Video",
+    "VideoChatEnded",
+    "VideoChatParticipantsInvited",
+    "VideoChatScheduled",
+    "VideoChatStarted",
+    "VideoNote",
+    "Voice",
+    "WebAppData",
+    "WebAppInfo",
+    "WebhookInfo",
 )

 # Load typing forward refs for every TelegramObject
--- a/aiogram/types/error_event.py
+++ b/aiogram/types/error_event.py
@ -2,15 +2,19 @@ from aiogram.types import Update
 from aiogram.types.base import MutableTelegramObject


-class ErrorEvent(MutableTelegramObject):
+class _ErrorEvent(MutableTelegramObject):
+    class Config:
+        arbitrary_types_allowed = True
+
+
+class ErrorEvent(_ErrorEvent):
    """
    Internal event, should be used to receive errors while processing Updates from Telegram
+
+    Source: https://core.telegram.org/bots/api#error-event
    """

    update: Update
    """Received update"""
    exception: Exception
    """Exception"""
-
-    class Config:
-        arbitrary_types_allowed = True
--- a/docs/api/bot.rst
+++ b/docs/api/bot.rst
@ -15,3 +15,4 @@ For example :code:`sendMessage` named :code:`send_message` and has the same spec
    :member-order: bysource
    :special-members: __init__
    :undoc-members: True
+    :noindex:
--- a/docs/api/enums/index.rst
+++ b/docs/api/enums/index.rst
@ -1,5 +1,5 @@
 #####
-Types
+Enums
 #####

 Here is list of all available enums:
--- a/docs/api/methods/answer_callback_query.rst
+++ b/docs/api/methods/answer_callback_query.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.callback_query.CallbackQuery.answer`
--- a/docs/api/methods/answer_inline_query.rst
+++ b/docs/api/methods/answer_inline_query.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.inline_query.InlineQuery.answer`
--- a/docs/api/methods/approve_chat_join_request.rst
+++ b/docs/api/methods/approve_chat_join_request.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat_join_request.ChatJoinRequest.approve`
--- a/docs/api/methods/ban_chat_member.rst
+++ b/docs/api/methods/ban_chat_member.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.ban`
--- a/docs/api/methods/ban_chat_sender_chat.rst
+++ b/docs/api/methods/ban_chat_sender_chat.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.ban_sender_chat`
--- a/docs/api/methods/copy_message.rst
+++ b/docs/api/methods/copy_message.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.copy_to`
--- a/docs/api/methods/create_chat_invite_link.rst
+++ b/docs/api/methods/create_chat_invite_link.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.create_invite_link`
--- a/docs/api/methods/decline_chat_join_request.rst
+++ b/docs/api/methods/decline_chat_join_request.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat_join_request.ChatJoinRequest.decline`
--- a/docs/api/methods/delete_chat_photo.rst
+++ b/docs/api/methods/delete_chat_photo.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.delete_photo`
--- a/docs/api/methods/delete_chat_sticker_set.rst
+++ b/docs/api/methods/delete_chat_sticker_set.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.delete_sticker_set`
--- a/docs/api/methods/delete_message.rst
+++ b/docs/api/methods/delete_message.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.delete`
 - :meth:`aiogram.types.chat.Chat.delete_message`
--- a/docs/api/methods/delete_sticker_from_set.rst
+++ b/docs/api/methods/delete_sticker_from_set.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.sticker.Sticker.delete_from_set`
--- a/docs/api/methods/edit_chat_invite_link.rst
+++ b/docs/api/methods/edit_chat_invite_link.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.edit_invite_link`
--- a/docs/api/methods/edit_message_caption.rst
+++ b/docs/api/methods/edit_message_caption.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.edit_caption`
--- a/docs/api/methods/edit_message_live_location.rst
+++ b/docs/api/methods/edit_message_live_location.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.edit_live_location`
--- a/docs/api/methods/edit_message_media.rst
+++ b/docs/api/methods/edit_message_media.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.edit_media`
--- a/docs/api/methods/edit_message_reply_markup.rst
+++ b/docs/api/methods/edit_message_reply_markup.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.edit_reply_markup`
--- a/docs/api/methods/edit_message_text.rst
+++ b/docs/api/methods/edit_message_text.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.edit_text`
--- a/docs/api/methods/export_chat_invite_link.rst
+++ b/docs/api/methods/export_chat_invite_link.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.export_invite_link`
--- a/docs/api/methods/forward_message.rst
+++ b/docs/api/methods/forward_message.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.forward`
--- a/docs/api/methods/get_chat_administrators.rst
+++ b/docs/api/methods/get_chat_administrators.rst
@ -40,6 +40,6 @@ With specific bot


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.get_administrators`
--- a/docs/api/methods/get_chat_member.rst
+++ b/docs/api/methods/get_chat_member.rst
@ -40,6 +40,6 @@ With specific bot


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.get_member`
--- a/docs/api/methods/get_chat_member_count.rst
+++ b/docs/api/methods/get_chat_member_count.rst
@ -40,6 +40,6 @@ With specific bot


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.get_member_count`
--- a/docs/api/methods/get_chat_members_count.rst
+++ b/docs/api/methods/get_chat_members_count.rst
@ -1,37 +0,0 @@
-###################
-getChatMembersCount
-###################
-
-Returns: :obj:`int`
-
-.. automodule:: aiogram.methods.get_chat_members_count
-    :members:
-    :member-order: bysource
-    :undoc-members: True
-
-
-Usage
-=====
-
-As bot method
-------------
-
-.. code-block::
-
-    result: int = await bot.get_chat_members_count(...)
-
-
-Method as object
----------------
-
-Imports:
-
- :code:`from aiogram.methods.get_chat_members_count import GetChatMembersCount`
- alias: :code:`from aiogram.methods import GetChatMembersCount`
-
-With specific bot
-~~~~~~~~~~~~~~~~~
-
-.. code-block:: python
-
-    result: int = await bot(GetChatMembersCount(...))
--- a/docs/api/methods/get_user_profile_photos.rst
+++ b/docs/api/methods/get_user_profile_photos.rst
@ -40,6 +40,6 @@ With specific bot


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.user.User.get_profile_photos`
--- a/docs/api/methods/kick_chat_member.rst
+++ b/docs/api/methods/kick_chat_member.rst
@ -1,44 +0,0 @@
-##############
-kickChatMember
-##############
-
-Returns: :obj:`bool`
-
-.. automodule:: aiogram.methods.kick_chat_member
-    :members:
-    :member-order: bysource
-    :undoc-members: True
-
-
-Usage
-=====
-
-As bot method
-------------
-
-.. code-block::
-
-    result: bool = await bot.kick_chat_member(...)
-
-
-Method as object
----------------
-
-Imports:
-
- :code:`from aiogram.methods.kick_chat_member import KickChatMember`
- alias: :code:`from aiogram.methods import KickChatMember`
-
-With specific bot
-~~~~~~~~~~~~~~~~~
-
-.. code-block:: python
-
-    result: bool = await bot(KickChatMember(...))
-
-As reply into Webhook in handler
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. code-block:: python
-
-    return KickChatMember(...)
--- a/docs/api/methods/leave_chat.rst
+++ b/docs/api/methods/leave_chat.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.leave`
--- a/docs/api/methods/pin_chat_message.rst
+++ b/docs/api/methods/pin_chat_message.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.pin`
 - :meth:`aiogram.types.chat.Chat.pin_message`
--- a/docs/api/methods/promote_chat_member.rst
+++ b/docs/api/methods/promote_chat_member.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.promote`
--- a/docs/api/methods/restrict_chat_member.rst
+++ b/docs/api/methods/restrict_chat_member.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.restrict`
--- a/docs/api/methods/revoke_chat_invite_link.rst
+++ b/docs/api/methods/revoke_chat_invite_link.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.revoke_invite_link`
--- a/docs/api/methods/send_animation.rst
+++ b/docs/api/methods/send_animation.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_animation`
 - :meth:`aiogram.types.message.Message.reply_animation`
--- a/docs/api/methods/send_audio.rst
+++ b/docs/api/methods/send_audio.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_audio`
 - :meth:`aiogram.types.message.Message.reply_audio`
--- a/docs/api/methods/send_chat_action.rst
+++ b/docs/api/methods/send_chat_action.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.do`
--- a/docs/api/methods/send_contact.rst
+++ b/docs/api/methods/send_contact.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_contact`
 - :meth:`aiogram.types.message.Message.reply_contact`
--- a/docs/api/methods/send_dice.rst
+++ b/docs/api/methods/send_dice.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_dice`
 - :meth:`aiogram.types.message.Message.reply_dice`
--- a/docs/api/methods/send_document.rst
+++ b/docs/api/methods/send_document.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_document`
 - :meth:`aiogram.types.message.Message.reply_document`
--- a/docs/api/methods/send_game.rst
+++ b/docs/api/methods/send_game.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_game`
 - :meth:`aiogram.types.message.Message.reply_game`
--- a/docs/api/methods/send_invoice.rst
+++ b/docs/api/methods/send_invoice.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_invoice`
 - :meth:`aiogram.types.message.Message.reply_invoice`
--- a/docs/api/methods/send_location.rst
+++ b/docs/api/methods/send_location.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_location`
 - :meth:`aiogram.types.message.Message.reply_location`
--- a/docs/api/methods/send_media_group.rst
+++ b/docs/api/methods/send_media_group.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_media_group`
 - :meth:`aiogram.types.message.Message.reply_media_group`
--- a/docs/api/methods/send_message.rst
+++ b/docs/api/methods/send_message.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer`
 - :meth:`aiogram.types.message.Message.reply`
--- a/docs/api/methods/send_photo.rst
+++ b/docs/api/methods/send_photo.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_photo`
 - :meth:`aiogram.types.message.Message.reply_photo`
--- a/docs/api/methods/send_poll.rst
+++ b/docs/api/methods/send_poll.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_poll`
 - :meth:`aiogram.types.message.Message.reply_poll`
--- a/docs/api/methods/send_sticker.rst
+++ b/docs/api/methods/send_sticker.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_sticker`
 - :meth:`aiogram.types.message.Message.reply_sticker`
--- a/docs/api/methods/send_venue.rst
+++ b/docs/api/methods/send_venue.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_venue`
 - :meth:`aiogram.types.message.Message.reply_venue`
--- a/docs/api/methods/send_video.rst
+++ b/docs/api/methods/send_video.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_video`
 - :meth:`aiogram.types.message.Message.reply_video`
--- a/docs/api/methods/send_video_note.rst
+++ b/docs/api/methods/send_video_note.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_video_note`
 - :meth:`aiogram.types.message.Message.reply_video_note`
--- a/docs/api/methods/send_voice.rst
+++ b/docs/api/methods/send_voice.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.answer_voice`
 - :meth:`aiogram.types.message.Message.reply_voice`
--- a/docs/api/methods/set_chat_administrator_custom_title.rst
+++ b/docs/api/methods/set_chat_administrator_custom_title.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.set_administrator_custom_title`
--- a/docs/api/methods/set_chat_description.rst
+++ b/docs/api/methods/set_chat_description.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.set_description`
--- a/docs/api/methods/set_chat_permissions.rst
+++ b/docs/api/methods/set_chat_permissions.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.set_permissions`
--- a/docs/api/methods/set_chat_photo.rst
+++ b/docs/api/methods/set_chat_photo.rst
@ -40,6 +40,6 @@ With specific bot


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.set_photo`
--- a/docs/api/methods/set_chat_sticker_set.rst
+++ b/docs/api/methods/set_chat_sticker_set.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.set_sticker_set`
--- a/docs/api/methods/set_chat_title.rst
+++ b/docs/api/methods/set_chat_title.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.set_title`
--- a/docs/api/methods/set_sticker_position_in_set.rst
+++ b/docs/api/methods/set_sticker_position_in_set.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.sticker.Sticker.set_position_in_set`
--- a/docs/api/methods/stop_message_live_location.rst
+++ b/docs/api/methods/stop_message_live_location.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.stop_live_location`
--- a/docs/api/methods/unban_chat_member.rst
+++ b/docs/api/methods/unban_chat_member.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.unban`
--- a/docs/api/methods/unban_chat_sender_chat.rst
+++ b/docs/api/methods/unban_chat_sender_chat.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.unban_sender_chat`
--- a/docs/api/methods/unpin_all_chat_messages.rst
+++ b/docs/api/methods/unpin_all_chat_messages.rst
@ -45,6 +45,6 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.chat.Chat.unpin_all_messages`
--- a/docs/api/methods/unpin_chat_message.rst
+++ b/docs/api/methods/unpin_chat_message.rst
@ -45,7 +45,7 @@ As reply into Webhook in handler


 As shortcut from received object
-------------------
+--------------------------------

 - :meth:`aiogram.types.message.Message.unpin`
 - :meth:`aiogram.types.chat.Chat.unpin_message`
--- a/docs/api/types/index.rst
+++ b/docs/api/types/index.rst
@ -190,3 +190,11 @@ Games
    callback_game
    game
    game_high_score
+
+Internals
+=========
+
+.. toctree::
+    :maxdepth: 1
+
+    error_event