Telegram Bot API 4.5

docs/api/methods/add_sticker_to_set.md

@@ -60,5 +60,5 @@ result: bool = await AddStickerToSet(...)
 ## Related pages:
 
 - [Official documentation](https://core.telegram.org/bots/api#addstickertoset)
-- [aiogram.types.InputFile](../types/input_file.md)
 - [aiogram.types.MaskPosition](../types/mask_position.md)
+- [aiogram.types.InputFile](../types/input_file.md)

docs/api/methods/create_new_sticker_set.md

@@ -62,5 +62,5 @@ result: bool = await CreateNewStickerSet(...)
 ## Related pages:
 
 - [Official documentation](https://core.telegram.org/bots/api#createnewstickerset)
-- [aiogram.types.InputFile](../types/input_file.md)
 - [aiogram.types.MaskPosition](../types/mask_position.md)
+- [aiogram.types.InputFile](../types/input_file.md)

docs/api/types/animation.md

@@ -9,7 +9,8 @@ This object represents an animation file (GIF or H.264/MPEG-4 AVC video without
 
 | Name | Type | Description |
 | - | - | - |
-| `file_id` | `#!python str` | Identifier for this file |
+| `file_id` | `#!python str` | Identifier for this file, which can be used to download or reuse the file |
+| `file_unique_id` | `#!python str` | Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. |
 | `width` | `#!python int` | Video width as defined by sender |
 | `height` | `#!python int` | Video height as defined by sender |
 | `duration` | `#!python int` | Duration of the video in seconds as defined by sender |

docs/api/types/audio.md

@@ -9,7 +9,8 @@ This object represents an audio file to be treated as music by the Telegram clie
 
 | Name | Type | Description |
 | - | - | - |
-| `file_id` | `#!python str` | Identifier for this file |
+| `file_id` | `#!python str` | Identifier for this file, which can be used to download or reuse the file |
+| `file_unique_id` | `#!python str` | Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. |
 | `duration` | `#!python int` | Duration of the audio in seconds as defined by sender |
 | `performer` | `#!python Optional[str]` | Optional. Performer of the audio as defined by sender or by audio tags |
 | `title` | `#!python Optional[str]` | Optional. Title of the audio as defined by sender or by audio tags |

docs/api/types/callback_query.md

@@ -30,5 +30,5 @@ NOTE: After the user presses a callback button, Telegram clients will display a
 ## Related pages:
 
 - [Official documentation](https://core.telegram.org/bots/api#callbackquery)
-- [aiogram.types.User](../types/user.md)
 - [aiogram.types.Message](../types/message.md)
+- [aiogram.types.User](../types/user.md)

docs/api/types/chat.md

@@ -20,6 +20,7 @@ This object represents a chat.
 | `invite_link` | `#!python Optional[str]` | Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat. |
 | `pinned_message` | `#!python Optional[Message]` | Optional. Pinned message, for groups, supergroups and channels. Returned only in getChat. |
 | `permissions` | `#!python Optional[ChatPermissions]` | Optional. Default chat member permissions, for groups and supergroups. Returned only in getChat. |
+| `slow_mode_delay` | `#!python Optional[int]` | Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat. |
 | `sticker_set_name` | `#!python Optional[str]` | Optional. For supergroups, name of group sticker set. Returned only in getChat. |
 | `can_set_sticker_set` | `#!python Optional[bool]` | Optional. True, if the bot can change the group sticker set. Returned only in getChat. |
 

docs/api/types/chat_member.md

@@ -11,6 +11,7 @@ This object contains information about one member of a chat.
 | - | - | - |
 | `user` | `#!python User` | Information about the user |
 | `status` | `#!python str` | The member's status in the chat. Can be 'creator', 'administrator', 'member', 'restricted', 'left' or 'kicked' |
+| `custom_title` | `#!python Optional[str]` | Optional. Owner and administrators only. Custom title for this user |
 | `until_date` | `#!python Optional[Union[int, datetime.datetime, datetime.timedelta]]` | Optional. Restricted and kicked only. Date when restrictions will be lifted for this user; unix time |
 | `can_be_edited` | `#!python Optional[bool]` | Optional. Administrators only. True, if the bot is allowed to edit administrator privileges of that user |
 | `can_post_messages` | `#!python Optional[bool]` | Optional. Administrators only. True, if the administrator can post in the channel; channels only |

docs/api/types/chat_photo.md

@@ -10,7 +10,9 @@ This object represents a chat photo.
 | Name | Type | Description |
 | - | - | - |
 | `small_file_id` | `#!python str` | File identifier of small (160x160) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed. |
+| `small_file_unique_id` | `#!python str` | Unique file identifier of small (160x160) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. |
 | `big_file_id` | `#!python str` | File identifier of big (640x640) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed. |
+| `big_file_unique_id` | `#!python str` | Unique file identifier of big (640x640) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. |
 
 
 

docs/api/types/document.md

@@ -9,7 +9,8 @@ This object represents a general file (as opposed to photos, voice messages and
 
 | Name | Type | Description |
 | - | - | - |
-| `file_id` | `#!python str` | Identifier for this file |
+| `file_id` | `#!python str` | Identifier for this file, which can be used to download or reuse the file |
+| `file_unique_id` | `#!python str` | Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. |
 | `thumb` | `#!python Optional[PhotoSize]` | Optional. Document thumbnail as defined by sender |
 | `file_name` | `#!python Optional[str]` | Optional. Original filename as defined by sender |
 | `mime_type` | `#!python Optional[str]` | Optional. MIME type of the file as defined by sender |

docs/api/types/file.md

@@ -11,7 +11,8 @@ Maximum file size to download is 20 MB
 
 | Name | Type | Description |
 | - | - | - |
-| `file_id` | `#!python str` | Identifier for this file |
+| `file_id` | `#!python str` | Identifier for this file, which can be used to download or reuse the file |
+| `file_unique_id` | `#!python str` | Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. |
 | `file_size` | `#!python Optional[int]` | Optional. File size, if known |
 | `file_path` | `#!python Optional[str]` | Optional. File path. Use https://api.telegram.org/file/bot<token>/<file_path> to get the file. |
 

docs/api/types/message_entity.md

@@ -9,7 +9,7 @@ This object represents one special entity in a text message. For example, hashta
 
 | Name | Type | Description |
 | - | - | - |
-| `type` | `#!python str` | Type of the entity. Can be mention (@username), hashtag, cashtag, bot_command, url, email, phone_number, bold (bold text), italic (italic text), code (monowidth string), pre (monowidth block), text_link (for clickable text URLs), text_mention (for users without usernames) |
+| `type` | `#!python str` | Type of the entity. Can be 'mention' (@username), 'hashtag' (#hashtag), 'cashtag' ($USD), 'bot_command' (/start@jobs_bot), 'url' (https://telegram.org), 'email' (do-not-reply@telegram.org), 'phone_number' (+1-212-555-0123), 'bold' (bold text), 'italic' (italic text), 'underline' (underlined text), 'strikethrough' (strikethrough text), 'code' (monowidth string), 'pre' (monowidth block), 'text_link' (for clickable text URLs), 'text_mention' (for users without usernames) |
 | `offset` | `#!python int` | Offset in UTF-16 code units to the start of the entity |
 | `length` | `#!python int` | Length of the entity in UTF-16 code units |
 | `url` | `#!python Optional[str]` | Optional. For 'text_link' only, url that will be opened after user taps on the text |

docs/api/types/passport_file.md

@@ -9,7 +9,8 @@ This object represents a file uploaded to Telegram Passport. Currently all Teleg
 
 | Name | Type | Description |
 | - | - | - |
-| `file_id` | `#!python str` | Identifier for this file |
+| `file_id` | `#!python str` | Identifier for this file, which can be used to download or reuse the file |
+| `file_unique_id` | `#!python str` | Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. |
 | `file_size` | `#!python int` | File size |
 | `file_date` | `#!python int` | Unix time when the file was uploaded |
 

docs/api/types/photo_size.md

@@ -9,7 +9,8 @@ This object represents one size of a photo or a file / sticker thumbnail.
 
 | Name | Type | Description |
 | - | - | - |
-| `file_id` | `#!python str` | Identifier for this file |
+| `file_id` | `#!python str` | Identifier for this file, which can be used to download or reuse the file |
+| `file_unique_id` | `#!python str` | Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. |
 | `width` | `#!python int` | Photo width |
 | `height` | `#!python int` | Photo height |
 | `file_size` | `#!python Optional[int]` | Optional. File size |

docs/api/types/sticker.md

@@ -9,7 +9,8 @@ This object represents a sticker.
 
 | Name | Type | Description |
 | - | - | - |
-| `file_id` | `#!python str` | Identifier for this file |
+| `file_id` | `#!python str` | Identifier for this file, which can be used to download or reuse the file |
+| `file_unique_id` | `#!python str` | Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. |
 | `width` | `#!python int` | Sticker width |
 | `height` | `#!python int` | Sticker height |
 | `is_animated` | `#!python bool` | True, if the sticker is animated |

docs/api/types/video.md

@@ -9,7 +9,8 @@ This object represents a video file.
 
 | Name | Type | Description |
 | - | - | - |
-| `file_id` | `#!python str` | Identifier for this file |
+| `file_id` | `#!python str` | Identifier for this file, which can be used to download or reuse the file |
+| `file_unique_id` | `#!python str` | Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. |
 | `width` | `#!python int` | Video width as defined by sender |
 | `height` | `#!python int` | Video height as defined by sender |
 | `duration` | `#!python int` | Duration of the video in seconds as defined by sender |

docs/api/types/video_note.md

@@ -9,7 +9,8 @@ This object represents a video message (available in Telegram apps as of v.4.0).
 
 | Name | Type | Description |
 | - | - | - |
-| `file_id` | `#!python str` | Identifier for this file |
+| `file_id` | `#!python str` | Identifier for this file, which can be used to download or reuse the file |
+| `file_unique_id` | `#!python str` | Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. |
 | `length` | `#!python int` | Video width and height (diameter of the video message) as defined by sender |
 | `duration` | `#!python int` | Duration of the video in seconds as defined by sender |
 | `thumb` | `#!python Optional[PhotoSize]` | Optional. Video thumbnail |

docs/api/types/voice.md

@@ -9,7 +9,8 @@ This object represents a voice note.
 
 | Name | Type | Description |
 | - | - | - |
-| `file_id` | `#!python str` | Identifier for this file |
+| `file_id` | `#!python str` | Identifier for this file, which can be used to download or reuse the file |
+| `file_unique_id` | `#!python str` | Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. |
 | `duration` | `#!python int` | Duration of the audio in seconds as defined by sender |
 | `mime_type` | `#!python Optional[str]` | Optional. MIME type of the file as defined by sender |
 | `file_size` | `#!python Optional[int]` | Optional. File size |

docs/index.md

@@ -4,7 +4,7 @@ Documentation for version 3.0 [WIP] [^1]
 
 [![MIT License](https://img.shields.io/pypi/l/aiogram.svg?style=flat-square)](https://opensource.org/licenses/MIT)
 [![Supported python versions](https://img.shields.io/pypi/pyversions/aiogram.svg?style=flat-square)](https://pypi.python.org/pypi/aiogram)
-[![Telegram Bot API](https://img.shields.io/badge/Telegram%20Bot%20API-4.4-blue.svg?style=flat-square&logo=telegram)](https://core.telegram.org/bots/api)
+[![Telegram Bot API](https://img.shields.io/badge/Telegram%20Bot%20API-4.5-blue.svg?style=flat-square&logo=telegram)](https://core.telegram.org/bots/api)
 [![PyPi Package Version](https://img.shields.io/pypi/v/aiogram.svg?style=flat-square)](https://pypi.python.org/pypi/aiogram)
 [![PyPi status](https://img.shields.io/pypi/status/aiogram.svg?style=flat-square)](https://pypi.python.org/pypi/aiogram)
 [![Downloads](https://img.shields.io/pypi/dm/aiogram.svg?style=flat-square)](https://pypi.python.org/pypi/aiogram)
@@ -16,7 +16,7 @@ Documentation for version 3.0 [WIP] [^1]
 ## Features
 
 - Asynchronous
-- [Supports Telegram Bot API v4.4](api/index.md)
+- [Supports Telegram Bot API v4.5](api/index.md)
 - Finite State Machine
 - [Replies into Webhook](https://core.telegram.org/bots/faq#how-can-i-make-requests-in-response-to-updates)
 - Middlewares