botapi-py 1.5.8__tar.gz → 1.5.9__tar.gz

{botapi_py-1.5.8 → botapi_py-1.5.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: botapi-py
-Version: 1.5.8
+Version: 1.5.9
 Summary: A simple and flexible Python library to conveniently build fast Telegram bots using the Bot API.
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: pydantic>=2.12.0

{botapi_py-1.5.8 → botapi_py-1.5.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "botapi-py"
-version = "1.5.8"
+version = "1.5.9"
 description = "A simple and flexible Python library to conveniently build fast Telegram bots using the Bot API."
 # readme = "README.md"
 # authors = [

{botapi_py-1.5.8 → botapi_py-1.5.9}/src/botapi/enums.py

@@ -42,6 +42,8 @@ class UpdateType(enum.StrEnum):
 	EDITED_BUSINESS_MESSAGE = 'edited_business_message'
 	DELETED_BUSINESS_MESSAGES = 'deleted_business_messages'
 	PURCHASED_PAID_MEDIA = 'purchased_paid_media'
+	MANAGED_BOT = 'managed_bot'
+	GUEST_MESSAGE = 'guest_message'
 	
 class MediaType(enum.StrEnum):
 	'''
@@ -59,6 +61,7 @@ class MediaType(enum.StrEnum):
 	VOICE = 'voice'
 	STORY = 'story' # does not have `file_id`, only `id`
 	PAID_MEDIA = 'paid_media' # this contains a `photo` attribute that is a list of `PhotoSize` objects
+	LIVE_PHOTO = 'live_photo'
 	
 class ServiceMessage(enum.StrEnum):
 	'''

{botapi_py-1.5.8 → botapi_py-1.5.9}/src/botapi/methods.py

@@ -37,6 +37,7 @@ from .types import (
 	Animation,
 	Audio,
 	Document,
+	LivePhoto,
 	Story,
 	VideoQuality,
 	Video,
@@ -46,11 +47,19 @@ from .types import (
 	PaidMedia,
 	_PaidMedia,
 	PaidMediaAdapter,
-	PaidMediaPreview,
+	PaidMediaLivePhoto,
 	PaidMediaPhoto,
+	PaidMediaPreview,
 	PaidMediaVideo,
 	Contact,
 	Dice,
+	PollMedia,
+	InputPollMedia,
+	_InputPollMedia,
+	InputPollMediaAdapter,
+	InputPollOptionMedia,
+	_InputPollOptionMedia,
+	InputPollOptionMediaAdapter,
 	PollOption,
 	InputPollOption,
 	PollAnswer,
@@ -193,6 +202,7 @@ from .types import (
 	OwnedGiftRegular,
 	OwnedGiftUnique,
 	OwnedGifts,
+	BotAccessSettings,
 	AcceptedGiftTypes,
 	StarAmount,
 	BotCommand,
@@ -231,21 +241,27 @@ from .types import (
 	BusinessConnection,
 	BusinessMessagesDeleted,
 	SentWebAppMessage,
+	SentGuestMessage,
 	PreparedInlineMessage,
 	PreparedKeyboardButton,
 	ResponseParameters,
 	InputMedia,
 	_InputMedia,
 	InputMediaAdapter,
-	InputMediaPhoto,
-	InputMediaVideo,
 	InputMediaAnimation,
 	InputMediaAudio,
 	InputMediaDocument,
+	InputMediaLivePhoto,
+	InputMediaLocation,
+	InputMediaPhoto,
+	InputMediaSticker,
+	InputMediaVenue,
+	InputMediaVideo,
 	InputFile,
 	InputPaidMedia,
 	_InputPaidMedia,
 	InputPaidMediaAdapter,
+	InputPaidMediaLivePhoto,
 	InputPaidMediaPhoto,
 	InputPaidMediaVideo,
 	InputProfilePhoto,
@@ -753,6 +769,56 @@ class Methods(core.BaseBot):
 		})
 		return Message.model_validate(response)
 
+	async def send_live_photo(
+		self,
+		chat_id: Union[int, str],
+		live_photo: Union[InputFile, str],
+		photo: Union[InputFile, str],
+		business_connection_id: Optional[str] = None,
+		message_thread_id: Optional[int] = None,
+		direct_messages_topic_id: Optional[int] = None,
+		caption: Optional[str] = None,
+		parse_mode: Optional[Union[str, enums.ParseMode]] = None,
+		caption_entities: Optional[List[MessageEntity]] = None,
+		show_caption_above_media: Optional[bool] = None,
+		has_spoiler: Optional[bool] = None,
+		disable_notification: Optional[bool] = None,
+		protect_content: Optional[bool] = None,
+		allow_paid_broadcast: Optional[bool] = None,
+		message_effect_id: Optional[str] = None,
+		suggested_post_parameters: Optional[SuggestedPostParameters] = None,
+		reply_parameters: Optional[ReplyParameters] = None,
+		reply_markup: Optional[Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]] = None,
+	) -> Message:
+		'''
+        Use this method to send live photos. On
+        success, the sent Message is returned.
+
+        Reference: https://core.telegram.org/bots/api#sendlivephoto
+		'''
+
+		response = await self._send_request('sendLivePhoto', {
+			'business_connection_id': business_connection_id,
+			'chat_id': chat_id,
+			'message_thread_id': message_thread_id,
+			'direct_messages_topic_id': direct_messages_topic_id,
+			'live_photo': live_photo,
+			'photo': photo,
+			'caption': caption,
+			'parse_mode': parse_mode,
+			'caption_entities': caption_entities,
+			'show_caption_above_media': show_caption_above_media,
+			'has_spoiler': has_spoiler,
+			'disable_notification': disable_notification,
+			'protect_content': protect_content,
+			'allow_paid_broadcast': allow_paid_broadcast,
+			'message_effect_id': message_effect_id,
+			'suggested_post_parameters': suggested_post_parameters,
+			'reply_parameters': reply_parameters,
+			'reply_markup': reply_markup,
+		})
+		return Message.model_validate(response)
+
 	async def send_audio(
 		self,
 		chat_id: Union[int, str],
@@ -1140,7 +1206,7 @@ class Methods(core.BaseBot):
 	async def send_media_group(
 		self,
 		chat_id: Union[int, str],
-		media: List[Union[InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo]],
+		media: List[Union[InputMediaAudio, InputMediaDocument, InputMediaLivePhoto, InputMediaPhoto, InputMediaVideo]],
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,
 		direct_messages_topic_id: Optional[int] = None,
@@ -1152,11 +1218,11 @@ class Methods(core.BaseBot):
 	) -> List[Message]:
 		'''
         Use this method to send a group of
-        photos, videos, documents or audios as an album.
-        Documents and audio files can be only grouped
-        in an album with messages of the same
-        type. On success, an array of Message objects
-        that were sent is returned.
+        photos, live photos, videos, documents or audios as
+        an album. Documents and audio files can be
+        only grouped in an album with messages of
+        the same type. On success, an array of
+        Message objects that were sent is returned.
 
         Reference: https://core.telegram.org/bots/api#sendmediagroup
 		'''
@@ -1335,16 +1401,20 @@ class Methods(core.BaseBot):
 		shuffle_options: Optional[bool] = None,
 		allow_adding_options: Optional[bool] = None,
 		hide_results_until_closes: Optional[bool] = None,
+		members_only: Optional[bool] = None,
+		country_codes: Optional[List[str]] = None,
 		correct_option_ids: Optional[List[int]] = None,
 		explanation: Optional[str] = None,
 		explanation_parse_mode: Optional[str] = None,
 		explanation_entities: Optional[List[MessageEntity]] = None,
+		explanation_media: Optional[_InputPollMedia] = None,
 		open_period: Optional[int] = None,
 		close_date: Optional[int] = None,
 		is_closed: Optional[bool] = None,
 		description: Optional[str] = None,
 		description_parse_mode: Optional[str] = None,
 		description_entities: Optional[List[MessageEntity]] = None,
+		media: Optional[_InputPollMedia] = None,
 		disable_notification: Optional[bool] = None,
 		protect_content: Optional[bool] = None,
 		allow_paid_broadcast: Optional[bool] = None,
@@ -1374,16 +1444,20 @@ class Methods(core.BaseBot):
 			'shuffle_options': shuffle_options,
 			'allow_adding_options': allow_adding_options,
 			'hide_results_until_closes': hide_results_until_closes,
+			'members_only': members_only,
+			'country_codes': country_codes,
 			'correct_option_ids': correct_option_ids,
 			'explanation': explanation,
 			'explanation_parse_mode': explanation_parse_mode,
 			'explanation_entities': explanation_entities,
+			'explanation_media': explanation_media,
 			'open_period': open_period,
 			'close_date': close_date,
 			'is_closed': is_closed,
 			'description': description,
 			'description_parse_mode': description_parse_mode,
 			'description_entities': description_entities,
+			'media': media,
 			'disable_notification': disable_notification,
 			'protect_content': protect_content,
 			'allow_paid_broadcast': allow_paid_broadcast,
@@ -1396,7 +1470,7 @@ class Methods(core.BaseBot):
 	async def send_checklist(
 		self,
 		business_connection_id: str,
-		chat_id: int,
+		chat_id: Union[int, str],
 		checklist: InputChecklist,
 		disable_notification: Optional[bool] = None,
 		protect_content: Optional[bool] = None,
@@ -1467,15 +1541,19 @@ class Methods(core.BaseBot):
 		self,
 		chat_id: int,
 		draft_id: int,
-		text: str,
 		message_thread_id: Optional[int] = None,
+		text: Optional[str] = None,
 		parse_mode: Optional[Union[str, enums.ParseMode]] = None,
 		entities: Optional[List[MessageEntity]] = None,
 	) -> bool:
 		'''
         Use this method to stream a partial message
         to a user while the message is being
-        generated. Returns True on success.
+        generated. Note that the streamed draft is ephemeral
+        and acts as a temporary 30-second preview -
+        once the output is finalized, you must call
+        sendMessage with the complete message to persist it
+        in the user's chat. Returns True on success.
 
         Reference: https://core.telegram.org/bots/api#sendmessagedraft
 		'''
@@ -2277,17 +2355,19 @@ class Methods(core.BaseBot):
 	async def get_chat_administrators(
 		self,
 		chat_id: Union[int, str],
+		return_bots: Optional[bool] = None,
 	) -> List[_ChatMember]:
 		'''
         Use this method to get a list of
-        administrators in a chat, which aren't bots. Returns
-        an Array of ChatMember objects.
+        administrators in a chat. Returns an Array of
+        ChatMember objects.
 
         Reference: https://core.telegram.org/bots/api#getchatadministrators
 		'''
 
 		response = await self._send_request('getChatAdministrators', {
 			'chat_id': chat_id,
+			'return_bots': return_bots,
 		})
 		return [ChatMemberAdapter.validate_python(x) for x in response]
 
@@ -2328,6 +2408,27 @@ class Methods(core.BaseBot):
 		})
 		return ChatMemberAdapter.validate_python(response)
 
+	async def get_user_personal_chat_messages(
+		self,
+		user_id: int,
+		limit: int,
+	) -> List[Message]:
+		'''
+        Use this method to get the last messages
+        from the personal chat (i.e., the chat currently
+        added to their profile) of a given user.
+        On success, an array of Message objects is
+        returned.
+
+        Reference: https://core.telegram.org/bots/api#getuserpersonalchatmessages
+		'''
+
+		response = await self._send_request('getUserPersonalChatMessages', {
+			'user_id': user_id,
+			'limit': limit,
+		})
+		return [Message.model_validate(x) for x in response]
+
 	async def set_chat_sticker_set(
 		self,
 		chat_id: Union[int, str],
@@ -2679,6 +2780,25 @@ class Methods(core.BaseBot):
 		})
 		return BoolAdapter.validate_python(response)
 
+	async def answer_guest_query(
+		self,
+		guest_query_id: str,
+		result: _InlineQueryResult,
+	) -> SentGuestMessage:
+		'''
+        Use this method to reply to a received
+        guest message. On success, a SentGuestMessage object is
+        returned.
+
+        Reference: https://core.telegram.org/bots/api#answerguestquery
+		'''
+
+		response = await self._send_request('answerGuestQuery', {
+			'guest_query_id': guest_query_id,
+			'result': result,
+		})
+		return SentGuestMessage.model_validate(response)
+
 	async def get_user_chat_boosts(
 		self,
 		chat_id: Union[int, str],
@@ -2751,6 +2871,43 @@ class Methods(core.BaseBot):
 		})
 		return StrAdapter.validate_python(response)
 
+	async def get_managed_bot_access_settings(
+		self,
+		user_id: int,
+	) -> BotAccessSettings:
+		'''
+        Use this method to get the access settings
+        of a managed bot. Returns a BotAccessSettings object
+        on success.
+
+        Reference: https://core.telegram.org/bots/api#getmanagedbotaccesssettings
+		'''
+
+		response = await self._send_request('getManagedBotAccessSettings', {
+			'user_id': user_id,
+		})
+		return BotAccessSettings.model_validate(response)
+
+	async def set_managed_bot_access_settings(
+		self,
+		user_id: int,
+		is_access_restricted: bool,
+		added_user_ids: Optional[List[int]] = None,
+	) -> bool:
+		'''
+        Use this method to change the access settings
+        of a managed bot. Returns True on success.
+
+        Reference: https://core.telegram.org/bots/api#setmanagedbotaccesssettings
+		'''
+
+		response = await self._send_request('setManagedBotAccessSettings', {
+			'user_id': user_id,
+			'is_access_restricted': is_access_restricted,
+			'added_user_ids': added_user_ids,
+		})
+		return BoolAdapter.validate_python(response)
+
 	async def set_my_commands(
 		self,
 		commands: List[BotCommand],
@@ -3815,22 +3972,22 @@ class Methods(core.BaseBot):
 	) -> Union[Message, bool]:
 		'''
         Use this method to edit animation, audio, document,
-        photo, or video messages, or to add media
-        to text messages. If a message is part
-        of a message album, then it can be
-        edited only to an audio for audio albums,
-        only to a document for document albums and
-        to a photo or a video otherwise. When
-        an inline message is edited, a new file
-        can't be uploaded; use a previously uploaded file
-        via its file_id or specify a URL. On
-        success, if the edited message is not an
-        inline message, the edited Message is returned, otherwise
-        True is returned. Note that business messages that
-        were not sent by the bot and do
-        not contain an inline keyboard can only be
-        edited within 48 hours from the time they
-        were sent.
+        live photo, photo, or video messages, or to
+        add media to text messages. If a message
+        is part of a message album, then it
+        can be edited only to an audio for
+        audio albums, only to a document for document
+        albums and to a photo, a live photo,
+        or a video otherwise. When an inline message
+        is edited, a new file can't be uploaded;
+        use a previously uploaded file via its file_id
+        or specify a URL. On success, if the
+        edited message is not an inline message, the
+        edited Message is returned, otherwise True is returned.
+        Note that business messages that were not sent
+        by the bot and do not contain an
+        inline keyboard can only be edited within 48
+        hours from the time they were sent.
 
         Reference: https://core.telegram.org/bots/api#editmessagemedia
 		'''
@@ -3923,7 +4080,7 @@ class Methods(core.BaseBot):
 	async def edit_message_checklist(
 		self,
 		business_connection_id: str,
-		chat_id: int,
+		chat_id: Union[int, str],
 		message_id: int,
 		checklist: InputChecklist,
 		reply_markup: Optional[InlineKeyboardMarkup] = None,
@@ -4099,6 +4256,53 @@ class Methods(core.BaseBot):
 		})
 		return BoolAdapter.validate_python(response)
 
+	async def delete_message_reaction(
+		self,
+		chat_id: Union[int, str],
+		message_id: int,
+		user_id: Optional[int] = None,
+		actor_chat_id: Optional[int] = None,
+	) -> bool:
+		'''
+        Use this method to remove a reaction from
+        a message in a group or a supergroup
+        chat. The bot must have the 'can_delete_messages' administrator
+        right in the chat. Returns True on success.
+
+        Reference: https://core.telegram.org/bots/api#deletemessagereaction
+		'''
+
+		response = await self._send_request('deleteMessageReaction', {
+			'chat_id': chat_id,
+			'message_id': message_id,
+			'user_id': user_id,
+			'actor_chat_id': actor_chat_id,
+		})
+		return BoolAdapter.validate_python(response)
+
+	async def delete_all_message_reactions(
+		self,
+		chat_id: Union[int, str],
+		user_id: Optional[int] = None,
+		actor_chat_id: Optional[int] = None,
+	) -> bool:
+		'''
+        Use this method to remove up to 10000
+        recent reactions in a group or a supergroup
+        chat added by a given user or chat.
+        The bot must have the 'can_delete_messages' administrator right
+        in the chat. Returns True on success.
+
+        Reference: https://core.telegram.org/bots/api#deleteallmessagereactions
+		'''
+
+		response = await self._send_request('deleteAllMessageReactions', {
+			'chat_id': chat_id,
+			'user_id': user_id,
+			'actor_chat_id': actor_chat_id,
+		})
+		return BoolAdapter.validate_python(response)
+
 	async def send_sticker(
 		self,
 		chat_id: Union[int, str],
@@ -4756,7 +4960,7 @@ class Methods(core.BaseBot):
 
 	async def send_game(
 		self,
-		chat_id: int,
+		chat_id: Union[int, str],
 		game_short_name: str,
 		business_connection_id: Optional[str] = None,
 		message_thread_id: Optional[int] = None,

{botapi_py-1.5.8 → botapi_py-1.5.9}/src/botapi/types.py

@@ -37,6 +37,7 @@ class Message(MaybeInaccessibleMessage):
 	sender_boost_count: Optional[int] = Field(default=None)
 	sender_business_bot: Optional[User] = Field(default=None)
 	sender_tag: Optional[str] = Field(default=None)
+	guest_query_id: Optional[str] = Field(default=None)
 	business_connection_id: Optional[str] = Field(default=None)
 	forward_origin: Optional[_MessageOrigin] = Field(default=None)
 	is_topic_message: Optional[bool] = Field(default=None)
@@ -48,6 +49,8 @@ class Message(MaybeInaccessibleMessage):
 	reply_to_checklist_task_id: Optional[int] = Field(default=None)
 	reply_to_poll_option_id: Optional[str] = Field(default=None)
 	via_bot: Optional[User] = Field(default=None)
+	guest_bot_caller_user: Optional[User] = Field(default=None)
+	guest_bot_caller_chat: Optional[Chat] = Field(default=None)
 	edit_date: Optional[int] = Field(default=None)
 	has_protected_content: Optional[bool] = Field(default=None)
 	is_from_offline: Optional[bool] = Field(default=None)
@@ -63,6 +66,7 @@ class Message(MaybeInaccessibleMessage):
 	animation: Optional[Animation] = Field(default=None)
 	audio: Optional[Audio] = Field(default=None)
 	document: Optional[Document] = Field(default=None)
+	live_photo: Optional[LivePhoto] = Field(default=None)
 	paid_media: Optional[PaidMediaInfo] = Field(default=None)
 	photo: Optional[List[PhotoSize]] = Field(default=None)
 	sticker: Optional[Sticker] = Field(default=None)
@@ -487,19 +491,17 @@ _MessageOrigin = Union[
 MessageOriginAdapter = TypeAdapter[_MessageOrigin](_MessageOrigin) 
 
 class PaidMedia(BaseModel):	
-	type: Literal['preview', 'photo', 'video']
+	type: Literal['live_photo', 'photo', 'preview', 'video']
 
-class PaidMediaPreview(PaidMedia):
+class PaidMediaLivePhoto(PaidMedia):
 	'''
-    The paid media isn't available before the payment.
+    The paid media is a live photo.
 
-    Reference: https://core.telegram.org/bots/api#paidmediapreview
+    Reference: https://core.telegram.org/bots/api#paidmedialivephoto
 	'''
 
-	type: Literal['preview'] = 'preview' # pyright: ignore[reportIncompatibleVariableOverride]
-	width: Optional[int] = Field(default=None)
-	height: Optional[int] = Field(default=None)
-	duration: Optional[int] = Field(default=None) 
+	type: Literal['live_photo'] = 'live_photo' # pyright: ignore[reportIncompatibleVariableOverride]
+	live_photo: LivePhoto 
 
 class PaidMediaPhoto(PaidMedia):
 	'''
@@ -511,6 +513,18 @@ class PaidMediaPhoto(PaidMedia):
 	type: Literal['photo'] = 'photo' # pyright: ignore[reportIncompatibleVariableOverride]
 	photo: List[PhotoSize] 
 
+class PaidMediaPreview(PaidMedia):
+	'''
+    The paid media isn't available before the payment.
+
+    Reference: https://core.telegram.org/bots/api#paidmediapreview
+	'''
+
+	type: Literal['preview'] = 'preview' # pyright: ignore[reportIncompatibleVariableOverride]
+	width: Optional[int] = Field(default=None)
+	height: Optional[int] = Field(default=None)
+	duration: Optional[int] = Field(default=None) 
+
 class PaidMediaVideo(PaidMedia):
 	'''
     The paid media is a video.
@@ -522,12 +536,188 @@ class PaidMediaVideo(PaidMedia):
 	video: Video 
 
 _PaidMedia = Union[
-	PaidMediaPreview,
+	PaidMediaLivePhoto,
 	PaidMediaPhoto,
+	PaidMediaPreview,
 	PaidMediaVideo,
 ]
 PaidMediaAdapter = TypeAdapter[_PaidMedia](_PaidMedia) 
 
+class InputPollMedia(BaseModel):	
+	type: Literal['animation', 'audio', 'document', 'live_photo', 'location', 'photo', 'venue', 'video']
+
+class InputMediaAnimation(InputPollMedia):
+	'''
+    Represents an animation file (GIF or H.264/MPEG-4 AVC
+    video without sound) to be sent.
+
+    Reference: https://core.telegram.org/bots/api#inputmediaanimation
+	'''
+
+	type: Literal['animation'] = 'animation' # pyright: ignore[reportIncompatibleVariableOverride]
+	media: Union[InputFile, str]
+	thumbnail: Optional[str] = Field(default=None)
+	caption: Optional[str] = Field(default=None)
+	parse_mode: Optional[str] = Field(default=None)
+	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
+	show_caption_above_media: Optional[bool] = Field(default=None)
+	width: Optional[int] = Field(default=None)
+	height: Optional[int] = Field(default=None)
+	duration: Optional[int] = Field(default=None)
+	has_spoiler: Optional[bool] = Field(default=None) 
+
+class InputMediaAudio(InputPollMedia):
+	'''
+    Represents an audio file to be treated as
+    music to be sent.
+
+    Reference: https://core.telegram.org/bots/api#inputmediaaudio
+	'''
+
+	type: Literal['audio'] = 'audio' # pyright: ignore[reportIncompatibleVariableOverride]
+	media: Union[InputFile, str]
+	thumbnail: Optional[str] = Field(default=None)
+	caption: Optional[str] = Field(default=None)
+	parse_mode: Optional[str] = Field(default=None)
+	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
+	duration: Optional[int] = Field(default=None)
+	performer: Optional[str] = Field(default=None)
+	title: Optional[str] = Field(default=None) 
+
+class InputMediaDocument(InputPollMedia):
+	'''
+    Represents a general file to be sent.
+
+    Reference: https://core.telegram.org/bots/api#inputmediadocument
+	'''
+
+	type: Literal['document'] = 'document' # pyright: ignore[reportIncompatibleVariableOverride]
+	media: Union[InputFile, str]
+	thumbnail: Optional[str] = Field(default=None)
+	caption: Optional[str] = Field(default=None)
+	parse_mode: Optional[str] = Field(default=None)
+	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
+	disable_content_type_detection: Optional[bool] = Field(default=None) 
+
+class InputMediaLivePhoto(InputPollMedia):
+	'''
+    Represents a live photo to be sent.
+
+    Reference: https://core.telegram.org/bots/api#inputmedialivephoto
+	'''
+
+	type: Literal['live_photo'] = 'live_photo' # pyright: ignore[reportIncompatibleVariableOverride]
+	media: Union[InputFile, str]
+	photo: Union[InputFile, str]
+	caption: Optional[str] = Field(default=None)
+	parse_mode: Optional[str] = Field(default=None)
+	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
+	show_caption_above_media: Optional[bool] = Field(default=None)
+	has_spoiler: Optional[bool] = Field(default=None) 
+
+class InputMediaLocation(InputPollMedia):
+	'''
+    Represents a location to be sent.
+
+    Reference: https://core.telegram.org/bots/api#inputmedialocation
+	'''
+
+	type: Literal['location'] = 'location' # pyright: ignore[reportIncompatibleVariableOverride]
+	latitude: float
+	longitude: float
+	horizontal_accuracy: Optional[float] = Field(default=None) 
+
+class InputMediaPhoto(InputPollMedia):
+	'''
+    Represents a photo to be sent.
+
+    Reference: https://core.telegram.org/bots/api#inputmediaphoto
+	'''
+
+	type: Literal['photo'] = 'photo' # pyright: ignore[reportIncompatibleVariableOverride]
+	media: Union[InputFile, str]
+	caption: Optional[str] = Field(default=None)
+	parse_mode: Optional[str] = Field(default=None)
+	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
+	show_caption_above_media: Optional[bool] = Field(default=None)
+	has_spoiler: Optional[bool] = Field(default=None) 
+
+class InputMediaVenue(InputPollMedia):
+	'''
+    Represents a venue to be sent.
+
+    Reference: https://core.telegram.org/bots/api#inputmediavenue
+	'''
+
+	type: Literal['venue'] = 'venue' # pyright: ignore[reportIncompatibleVariableOverride]
+	latitude: float
+	longitude: float
+	title: str
+	address: str
+	foursquare_id: Optional[str] = Field(default=None)
+	foursquare_type: Optional[str] = Field(default=None)
+	google_place_id: Optional[str] = Field(default=None)
+	google_place_type: Optional[str] = Field(default=None) 
+
+class InputMediaVideo(InputPollMedia):
+	'''
+    Represents a video to be sent.
+
+    Reference: https://core.telegram.org/bots/api#inputmediavideo
+	'''
+
+	type: Literal['video'] = 'video' # pyright: ignore[reportIncompatibleVariableOverride]
+	media: Union[InputFile, str]
+	thumbnail: Optional[str] = Field(default=None)
+	cover: Optional[str] = Field(default=None)
+	start_timestamp: Optional[int] = Field(default=None)
+	caption: Optional[str] = Field(default=None)
+	parse_mode: Optional[str] = Field(default=None)
+	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
+	show_caption_above_media: Optional[bool] = Field(default=None)
+	width: Optional[int] = Field(default=None)
+	height: Optional[int] = Field(default=None)
+	duration: Optional[int] = Field(default=None)
+	supports_streaming: Optional[bool] = Field(default=None)
+	has_spoiler: Optional[bool] = Field(default=None) 
+
+_InputPollMedia = Union[
+	InputMediaAnimation,
+	InputMediaAudio,
+	InputMediaDocument,
+	InputMediaLivePhoto,
+	InputMediaLocation,
+	InputMediaPhoto,
+	InputMediaVenue,
+	InputMediaVideo,
+]
+InputPollMediaAdapter = TypeAdapter[_InputPollMedia](_InputPollMedia) 
+
+class InputPollOptionMedia(BaseModel):	
+	type: Literal['animation', 'live_photo', 'location', 'photo', 'sticker', 'venue', 'video']
+
+class InputMediaSticker(InputPollOptionMedia):
+	'''
+    Represents a sticker file to be sent.
+
+    Reference: https://core.telegram.org/bots/api#inputmediasticker
+	'''
+
+	type: Literal['sticker'] = 'sticker' # pyright: ignore[reportIncompatibleVariableOverride]
+	media: Union[InputFile, str]
+	emoji: Optional[str] = Field(default=None) 
+
+_InputPollOptionMedia = Union[
+	InputMediaAnimation,
+	InputMediaLivePhoto,
+	InputMediaLocation,
+	InputMediaPhoto,
+	InputMediaSticker,
+	InputMediaVenue,
+	InputMediaVideo,
+]
+InputPollOptionMediaAdapter = TypeAdapter[_InputPollOptionMedia](_InputPollOptionMedia) 
+
 class BackgroundFill(BaseModel):	
 	type: Literal['solid', 'gradient', 'freeform_gradient']
 
@@ -728,9 +918,45 @@ class ChatMember(BaseModel):
 				can_add_web_page_previews=False,
 				can_change_info=False,
 				can_invite_users=False,
-				can_pin_messages=False
+				can_pin_messages=False,
+				can_edit_tag=False,
+				can_manage_topics=False,
+				can_react_to_messages=False,
 			),
 			until_date=until_date
+		)
+	
+	async def unmute(
+		self,
+		bot: bot.Bot,
+		chat_id: Union[int, str]
+	) -> bool:
+		'''
+		Unmute (un-restrict) this chat member.
+	
+		From the docs: "Pass True for all permissions to lift restrictions from a user."
+		'''
+		return await bot.restrict_chat_member(
+			chat_id=chat_id,
+			user_id=self.user.id,
+			permissions=ChatPermissions(
+				can_send_messages=True,
+				can_send_audios=True,
+				can_send_documents=True,
+				can_send_photos=True,
+				can_send_videos=True,
+				can_send_video_notes=True,
+				can_send_voice_notes=True,
+				can_send_polls=True,
+				can_send_other_messages=True,
+				can_add_web_page_previews=True,
+				can_change_info=True,
+				can_invite_users=True,
+				can_pin_messages=True,
+				can_edit_tag=True,
+				can_manage_topics=True,
+				can_react_to_messages=True,
+			)
 	)
 	
 
@@ -811,6 +1037,7 @@ class ChatMemberRestricted(ChatMember):
 	can_send_polls: bool
 	can_send_other_messages: bool
 	can_add_web_page_previews: bool
+	can_react_to_messages: bool
 	can_edit_tag: bool
 	can_change_info: bool
 	can_invite_users: bool
@@ -1212,115 +1439,38 @@ _ChatBoostSource = Union[
 ChatBoostSourceAdapter = TypeAdapter[_ChatBoostSource](_ChatBoostSource) 
 
 class InputMedia(BaseModel):	
-	type: Literal['animation', 'document', 'audio', 'photo', 'video']	
+	type: Literal['animation', 'audio', 'document', 'live_photo', 'photo', 'video']	
 	media: Union[InputFile, str]	
 	caption: Optional[str] = Field(default=None)	
 	parse_mode: Optional[str] = Field(default=None)	
 	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
 
-class InputMediaAnimation(InputMedia):
-	'''
-    Represents an animation file (GIF or H.264/MPEG-4 AVC
-    video without sound) to be sent.
-
-    Reference: https://core.telegram.org/bots/api#inputmediaanimation
-	'''
-
-	type: Literal['animation'] = 'animation' # pyright: ignore[reportIncompatibleVariableOverride]
-	media: Union[InputFile, str]
-	thumbnail: Optional[str] = Field(default=None)
-	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default=None)
-	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
-	show_caption_above_media: Optional[bool] = Field(default=None)
-	width: Optional[int] = Field(default=None)
-	height: Optional[int] = Field(default=None)
-	duration: Optional[int] = Field(default=None)
-	has_spoiler: Optional[bool] = Field(default=None) 
-
-class InputMediaDocument(InputMedia):
-	'''
-    Represents a general file to be sent.
-
-    Reference: https://core.telegram.org/bots/api#inputmediadocument
-	'''
-
-	type: Literal['document'] = 'document' # pyright: ignore[reportIncompatibleVariableOverride]
-	media: Union[InputFile, str]
-	thumbnail: Optional[str] = Field(default=None)
-	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default=None)
-	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
-	disable_content_type_detection: Optional[bool] = Field(default=None) 
-
-class InputMediaAudio(InputMedia):
-	'''
-    Represents an audio file to be treated as
-    music to be sent.
-
-    Reference: https://core.telegram.org/bots/api#inputmediaaudio
-	'''
-
-	type: Literal['audio'] = 'audio' # pyright: ignore[reportIncompatibleVariableOverride]
-	media: Union[InputFile, str]
-	thumbnail: Optional[str] = Field(default=None)
-	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default=None)
-	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
-	duration: Optional[int] = Field(default=None)
-	performer: Optional[str] = Field(default=None)
-	title: Optional[str] = Field(default=None) 
-
-class InputMediaPhoto(InputMedia):
-	'''
-    Represents a photo to be sent.
-
-    Reference: https://core.telegram.org/bots/api#inputmediaphoto
-	'''
-
-	type: Literal['photo'] = 'photo' # pyright: ignore[reportIncompatibleVariableOverride]
-	media: Union[InputFile, str]
-	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default=None)
-	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
-	show_caption_above_media: Optional[bool] = Field(default=None)
-	has_spoiler: Optional[bool] = Field(default=None) 
-
-class InputMediaVideo(InputMedia):
-	'''
-    Represents a video to be sent.
-
-    Reference: https://core.telegram.org/bots/api#inputmediavideo
-	'''
-
-	type: Literal['video'] = 'video' # pyright: ignore[reportIncompatibleVariableOverride]
-	media: Union[InputFile, str]
-	thumbnail: Optional[str] = Field(default=None)
-	cover: Optional[str] = Field(default=None)
-	start_timestamp: Optional[int] = Field(default=None)
-	caption: Optional[str] = Field(default=None)
-	parse_mode: Optional[str] = Field(default=None)
-	caption_entities: Optional[List[MessageEntity]] = Field(default=None)
-	show_caption_above_media: Optional[bool] = Field(default=None)
-	width: Optional[int] = Field(default=None)
-	height: Optional[int] = Field(default=None)
-	duration: Optional[int] = Field(default=None)
-	supports_streaming: Optional[bool] = Field(default=None)
-	has_spoiler: Optional[bool] = Field(default=None) 
-
 _InputMedia = Union[
 	InputMediaAnimation,
-	InputMediaDocument,
 	InputMediaAudio,
+	InputMediaDocument,
+	InputMediaLivePhoto,
 	InputMediaPhoto,
 	InputMediaVideo,
 ]
 InputMediaAdapter = TypeAdapter[_InputMedia](_InputMedia) 
 
 class InputPaidMedia(BaseModel):	
-	type: Literal['photo', 'video']	
+	type: Literal['live_photo', 'photo', 'video']	
 	media: Union[InputFile, str]
 
+class InputPaidMediaLivePhoto(InputPaidMedia):
+	'''
+    The paid media to send is a live
+    photo.
+
+    Reference: https://core.telegram.org/bots/api#inputpaidmedialivephoto
+	'''
+
+	type: Literal['live_photo'] = 'live_photo' # pyright: ignore[reportIncompatibleVariableOverride]
+	media: Union[InputFile, str]
+	photo: Union[InputFile, str] 
+
 class InputPaidMediaPhoto(InputPaidMedia):
 	'''
     The paid media to send is a photo.
@@ -1349,6 +1499,7 @@ class InputPaidMediaVideo(InputPaidMedia):
 	supports_streaming: Optional[bool] = Field(default=None) 
 
 _InputPaidMedia = Union[
+	InputPaidMediaLivePhoto,
 	InputPaidMediaPhoto,
 	InputPaidMediaVideo,
 ]
@@ -2302,7 +2453,7 @@ PassportElementErrorAdapter = TypeAdapter[_PassportElementError](_PassportElemen
 class Update(BaseModel):
 	'''
     This object represents an incoming update.At most one
-    of the optional parameters can be present in
+    of the optional fields can be present in
     any given update.
 
     Reference: https://core.telegram.org/bots/api#update
@@ -2317,6 +2468,7 @@ class Update(BaseModel):
 	business_message: Optional[Message] = Field(default=None)
 	edited_business_message: Optional[Message] = Field(default=None)
 	deleted_business_messages: Optional[BusinessMessagesDeleted] = Field(default=None)
+	guest_message: Optional[Message] = Field(default=None)
 	message_reaction: Optional[MessageReactionUpdated] = Field(default=None)
 	message_reaction_count: Optional[MessageReactionCountUpdated] = Field(default=None)
 	inline_query: Optional[InlineQuery] = Field(default=None)
@@ -2378,6 +2530,7 @@ class User(BaseModel):
 	added_to_attachment_menu: Optional[bool] = Field(default=None)
 	can_join_groups: Optional[bool] = Field(default=None)
 	can_read_all_group_messages: Optional[bool] = Field(default=None)
+	supports_guest_queries: Optional[bool] = Field(default=None)
 	supports_inline_queries: Optional[bool] = Field(default=None)
 	can_connect_to_business: Optional[bool] = Field(default=None)
 	has_main_web_app: Optional[bool] = Field(default=None)
@@ -2536,6 +2689,7 @@ class ExternalReplyInfo(BaseModel):
 	animation: Optional[Animation] = Field(default=None)
 	audio: Optional[Audio] = Field(default=None)
 	document: Optional[Document] = Field(default=None)
+	live_photo: Optional[LivePhoto] = Field(default=None)
 	paid_media: Optional[PaidMediaInfo] = Field(default=None)
 	photo: Optional[List[PhotoSize]] = Field(default=None)
 	sticker: Optional[Sticker] = Field(default=None)
@@ -2638,6 +2792,22 @@ class Document(BaseModel):
 	mime_type: Optional[str] = Field(default=None)
 	file_size: Optional[int] = Field(default=None) 
 
+class LivePhoto(BaseModel):
+	'''
+    This object represents a live photo.
+
+    Reference: https://core.telegram.org/bots/api#livephoto
+	'''
+
+	file_id: str
+	file_unique_id: str
+	width: int
+	height: int
+	duration: int
+	photo: Optional[List[PhotoSize]] = Field(default=None)
+	mime_type: Optional[str] = Field(default=None)
+	file_size: Optional[int] = Field(default=None) 
+
 class Story(BaseModel):
 	'''
     This object represents a story.
@@ -2745,6 +2915,24 @@ class Dice(BaseModel):
 	emoji: str
 	value: int 
 
+class PollMedia(BaseModel):
+	'''
+    At most one of the optional fields can
+    be present in any given object.
+
+    Reference: https://core.telegram.org/bots/api#pollmedia
+	'''
+
+	animation: Optional[Animation] = Field(default=None)
+	audio: Optional[Audio] = Field(default=None)
+	document: Optional[Document] = Field(default=None)
+	live_photo: Optional[LivePhoto] = Field(default=None)
+	location: Optional[Location] = Field(default=None)
+	photo: Optional[List[PhotoSize]] = Field(default=None)
+	sticker: Optional[Sticker] = Field(default=None)
+	venue: Optional[Venue] = Field(default=None)
+	video: Optional[Video] = Field(default=None) 
+
 class PollOption(BaseModel):
 	'''
     This object contains information about one answer option
@@ -2757,6 +2945,7 @@ class PollOption(BaseModel):
 	text: str
 	voter_count: int
 	text_entities: Optional[List[MessageEntity]] = Field(default=None)
+	media: Optional[PollMedia] = Field(default=None)
 	added_by_user: Optional[User] = Field(default=None)
 	added_by_chat: Optional[Chat] = Field(default=None)
 	addition_date: Optional[int] = Field(default=None) 
@@ -2771,7 +2960,8 @@ class InputPollOption(BaseModel):
 
 	text: str
 	text_parse_mode: Optional[str] = Field(default=None)
-	text_entities: Optional[List[MessageEntity]] = Field(default=None) 
+	text_entities: Optional[List[MessageEntity]] = Field(default=None)
+	media: Optional[_InputPollOptionMedia] = Field(default=None) 
 
 class PollAnswer(BaseModel):
 	'''
@@ -2803,14 +2993,18 @@ class Poll(BaseModel):
 	type: str
 	allows_multiple_answers: bool
 	allows_revoting: bool
+	members_only: bool
 	question_entities: Optional[List[MessageEntity]] = Field(default=None)
+	country_codes: Optional[List[str]] = Field(default=None)
 	correct_option_ids: Optional[List[int]] = Field(default=None)
 	explanation: Optional[str] = Field(default=None)
 	explanation_entities: Optional[List[MessageEntity]] = Field(default=None)
+	explanation_media: Optional[PollMedia] = Field(default=None)
 	open_period: Optional[int] = Field(default=None)
 	close_date: Optional[int] = Field(default=None)
 	description: Optional[str] = Field(default=None)
-	description_entities: Optional[List[MessageEntity]] = Field(default=None) 
+	description_entities: Optional[List[MessageEntity]] = Field(default=None)
+	media: Optional[PollMedia] = Field(default=None) 
 
 class ChecklistTask(BaseModel):
 	'''
@@ -3485,7 +3679,7 @@ class ReplyKeyboardMarkup(BaseModel):
     This object represents a custom keyboard with reply
     options (see Introduction to bots for details and
     examples). Not supported in channels and for messages
-    sent on behalf of a Telegram Business account.
+    sent on behalf of a business account.
 
     Reference: https://core.telegram.org/bots/api#replykeyboardmarkup
 	'''
@@ -3598,7 +3792,7 @@ class ReplyKeyboardRemove(BaseModel):
     one-time keyboards that are hidden immediately after the
     user presses a button (see ReplyKeyboardMarkup). Not supported
     in channels and for messages sent on behalf
-    of a Telegram Business account.
+    of a business account.
 
     Reference: https://core.telegram.org/bots/api#replykeyboardremove
 	'''
@@ -3730,7 +3924,7 @@ class ForceReply(BaseModel):
     be extremely useful if you want to create
     user-friendly step-by-step interfaces without having to sacrifice privacy
     mode. Not supported in channels and for messages
-    sent on behalf of a Telegram Business account.
+    sent on behalf of a user account.
 
     Reference: https://core.telegram.org/bots/api#forcereply
 	'''
@@ -3870,6 +4064,7 @@ class ChatPermissions(BaseModel):
 	can_send_polls: Optional[bool] = Field(default=None)
 	can_send_other_messages: Optional[bool] = Field(default=None)
 	can_add_web_page_previews: Optional[bool] = Field(default=None)
+	can_react_to_messages: Optional[bool] = Field(default=None)
 	can_edit_tag: Optional[bool] = Field(default=None)
 	can_change_info: Optional[bool] = Field(default=None)
 	can_invite_users: Optional[bool] = Field(default=None)
@@ -4221,6 +4416,17 @@ class OwnedGifts(BaseModel):
 	gifts: List[_OwnedGift]
 	next_offset: Optional[str] = Field(default=None) 
 
+class BotAccessSettings(BaseModel):
+	'''
+    This object describes the access settings of a
+    bot.
+
+    Reference: https://core.telegram.org/bots/api#botaccesssettings
+	'''
+
+	is_access_restricted: bool
+	added_users: Optional[List[User]] = Field(default=None) 
+
 class AcceptedGiftTypes(BaseModel):
 	'''
     This object describes the types of gifts that
@@ -4408,6 +4614,16 @@ class SentWebAppMessage(BaseModel):
 
 	inline_message_id: Optional[str] = Field(default=None) 
 
+class SentGuestMessage(BaseModel):
+	'''
+    Describes an inline message sent by a guest
+    bot.
+
+    Reference: https://core.telegram.org/bots/api#sentguestmessage
+	'''
+
+	inline_message_id: str 
+
 class PreparedInlineMessage(BaseModel):
 	'''
     Describes an inline message to be sent by
@@ -4877,12 +5093,14 @@ MediaTypeUnion = Union[
 	VideoNote,
 	Voice,
 	Story,
-	PaidMedia
+	PaidMedia,
+	LivePhoto
 ]
 
 _InputMediaGroupTypes = Union[
 	InputMediaAudio,
 	InputMediaDocument,
+	InputMediaLivePhoto,
 	InputMediaPhoto,
 	InputMediaVideo,
 ]