telegrinder 0.1.dev161__py3-none-any.whl → 0.1.dev163__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of telegrinder might be problematic. Click here for more details.

Files changed (35) hide show
  1. telegrinder/api/api.py +4 -2
  2. telegrinder/api/error.py +3 -3
  3. telegrinder/bot/bot.py +8 -12
  4. telegrinder/bot/cute_types/base.py +1 -4
  5. telegrinder/bot/cute_types/message.py +140 -0
  6. telegrinder/bot/dispatch/composition.py +1 -1
  7. telegrinder/bot/dispatch/dispatch.py +3 -4
  8. telegrinder/bot/dispatch/view/box.py +6 -6
  9. telegrinder/bot/dispatch/waiter_machine/short_state.py +1 -1
  10. telegrinder/bot/rules/__init__.py +4 -0
  11. telegrinder/bot/rules/is_from.py +18 -3
  12. telegrinder/bot/scenario/checkbox.py +3 -4
  13. telegrinder/client/aiohttp.py +1 -2
  14. telegrinder/modules.py +5 -3
  15. telegrinder/msgspec_json.py +3 -3
  16. telegrinder/msgspec_utils.py +80 -38
  17. telegrinder/node/source.py +2 -3
  18. telegrinder/tools/__init__.py +6 -0
  19. telegrinder/tools/buttons.py +8 -13
  20. telegrinder/tools/error_handler/error_handler.py +2 -2
  21. telegrinder/tools/formatting/__init__.py +6 -0
  22. telegrinder/tools/formatting/html.py +10 -0
  23. telegrinder/tools/formatting/links.py +7 -0
  24. telegrinder/tools/formatting/spec_html_formats.py +27 -15
  25. telegrinder/tools/global_context/global_context.py +7 -5
  26. telegrinder/tools/keyboard.py +3 -3
  27. telegrinder/tools/loop_wrapper/abc.py +4 -4
  28. telegrinder/tools/magic.py +1 -1
  29. telegrinder/types/enums.py +4 -0
  30. telegrinder/types/methods.py +175 -41
  31. telegrinder/types/objects.py +442 -201
  32. {telegrinder-0.1.dev161.dist-info → telegrinder-0.1.dev163.dist-info}/METADATA +1 -1
  33. {telegrinder-0.1.dev161.dist-info → telegrinder-0.1.dev163.dist-info}/RECORD +35 -35
  34. {telegrinder-0.1.dev161.dist-info → telegrinder-0.1.dev163.dist-info}/WHEEL +1 -1
  35. {telegrinder-0.1.dev161.dist-info → telegrinder-0.1.dev163.dist-info}/LICENSE +0 -0
@@ -8,7 +8,7 @@ from telegrinder.types.enums import * # noqa: F403
8
8
 
9
9
 
10
10
  class ReactionType(Model):
11
- """Base object `ReactionType`, see the [documentation](https://core.telegram.org/bots/api#reactiontype)
11
+ """Base object `ReactionType`, see the [documentation](https://core.telegram.org/bots/api#reactiontype).
12
12
 
13
13
  This object describes the type of a reaction. Currently, it can be one of
14
14
  - ReactionTypeEmoji
@@ -17,7 +17,7 @@ class ReactionType(Model):
17
17
 
18
18
 
19
19
  class PassportElementError(Model):
20
- """Base object `PassportElementError`, see the [documentation](https://core.telegram.org/bots/api#passportelementerror)
20
+ """Base object `PassportElementError`, see the [documentation](https://core.telegram.org/bots/api#passportelementerror).
21
21
 
22
22
  This object represents an error in the Telegram Passport element which was submitted that should be resolved by the user. It should be one of:
23
23
  - PassportElementErrorDataField
@@ -33,7 +33,7 @@ class PassportElementError(Model):
33
33
 
34
34
 
35
35
  class MessageOrigin(Model):
36
- """Base object `MessageOrigin`, see the [documentation](https://core.telegram.org/bots/api#messageorigin)
36
+ """Base object `MessageOrigin`, see the [documentation](https://core.telegram.org/bots/api#messageorigin).
37
37
 
38
38
  This object describes the origin of a message. It can be one of
39
39
  - MessageOriginUser
@@ -44,7 +44,7 @@ class MessageOrigin(Model):
44
44
 
45
45
 
46
46
  class MaybeInaccessibleMessage(Model):
47
- """Base object `MaybeInaccessibleMessage`, see the [documentation](https://core.telegram.org/bots/api#maybeinaccessiblemessage)
47
+ """Base object `MaybeInaccessibleMessage`, see the [documentation](https://core.telegram.org/bots/api#maybeinaccessiblemessage).
48
48
 
49
49
  This object describes a message that can be inaccessible to the bot. It can be one of
50
50
  - Message
@@ -53,7 +53,7 @@ class MaybeInaccessibleMessage(Model):
53
53
 
54
54
 
55
55
  class MenuButton(Model):
56
- """Base object `MenuButton`, see the [documentation](https://core.telegram.org/bots/api#menubutton)
56
+ """Base object `MenuButton`, see the [documentation](https://core.telegram.org/bots/api#menubutton).
57
57
 
58
58
  This object describes the bot's menu button in a private chat. It should be one of
59
59
  - MenuButtonCommands
@@ -64,7 +64,7 @@ class MenuButton(Model):
64
64
 
65
65
 
66
66
  class InputMessageContent(Model):
67
- """Base object `InputMessageContent`, see the [documentation](https://core.telegram.org/bots/api#inputmessagecontent)
67
+ """Base object `InputMessageContent`, see the [documentation](https://core.telegram.org/bots/api#inputmessagecontent).
68
68
 
69
69
  This object represents the content of a message to be sent as a result of an inline query. Telegram clients currently support the following 5 types:
70
70
  - InputTextMessageContent
@@ -76,7 +76,7 @@ class InputMessageContent(Model):
76
76
 
77
77
 
78
78
  class InputMedia(Model):
79
- """Base object `InputMedia`, see the [documentation](https://core.telegram.org/bots/api#inputmedia)
79
+ """Base object `InputMedia`, see the [documentation](https://core.telegram.org/bots/api#inputmedia).
80
80
 
81
81
  This object represents the content of a media message to be sent. It should be one of
82
82
  - InputMediaAnimation
@@ -88,7 +88,7 @@ class InputMedia(Model):
88
88
 
89
89
 
90
90
  class InlineQueryResult(Model):
91
- """Base object `InlineQueryResult`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresult)
91
+ """Base object `InlineQueryResult`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresult).
92
92
 
93
93
  This object represents one result of an inline query. Telegram clients currently support results of the following 20 types:
94
94
  - InlineQueryResultCachedAudio
@@ -116,7 +116,7 @@ class InlineQueryResult(Model):
116
116
 
117
117
 
118
118
  class ChatMember(Model):
119
- """Base object `ChatMember`, see the [documentation](https://core.telegram.org/bots/api#chatmember)
119
+ """Base object `ChatMember`, see the [documentation](https://core.telegram.org/bots/api#chatmember).
120
120
 
121
121
  This object contains information about one member of a chat. Currently, the following 6 types of chat members are supported:
122
122
  - ChatMemberOwner
@@ -129,7 +129,7 @@ class ChatMember(Model):
129
129
 
130
130
 
131
131
  class ChatBoostSource(Model):
132
- """Base object `ChatBoostSource`, see the [documentation](https://core.telegram.org/bots/api#chatboostsource)
132
+ """Base object `ChatBoostSource`, see the [documentation](https://core.telegram.org/bots/api#chatboostsource).
133
133
 
134
134
  This object describes the source of a chat boost. It can be one of
135
135
  - ChatBoostSourcePremium
@@ -139,7 +139,7 @@ class ChatBoostSource(Model):
139
139
 
140
140
 
141
141
  class BotCommandScope(Model):
142
- """Base object `BotCommandScope`, see the [documentation](https://core.telegram.org/bots/api#botcommandscope)
142
+ """Base object `BotCommandScope`, see the [documentation](https://core.telegram.org/bots/api#botcommandscope).
143
143
 
144
144
  This object represents the scope to which bot commands are applied. Currently, the following 7 scopes are supported:
145
145
  - BotCommandScopeDefault
@@ -153,7 +153,7 @@ class BotCommandScope(Model):
153
153
 
154
154
 
155
155
  class Update(Model):
156
- """Object `Update`, see the [documentation](https://core.telegram.org/bots/api#update)
156
+ """Object `Update`, see the [documentation](https://core.telegram.org/bots/api#update).
157
157
 
158
158
  This object represents an incoming update.
159
159
  At most one of the optional parameters can be present in any given update.
@@ -184,6 +184,19 @@ class Update(Model):
184
184
  This update may at times be triggered by changes to message fields that are
185
185
  either unavailable or not actively used by your bot."""
186
186
 
187
+ business_connection: Option["BusinessConnection"] = Nothing
188
+ """Optional. The bot was connected to or disconnected from a business account,
189
+ or a user edited an existing connection with the bot."""
190
+
191
+ business_message: Option["Message"] = Nothing
192
+ """Optional. New non-service message from a connected business account."""
193
+
194
+ edited_business_message: Option["Message"] = Nothing
195
+ """Optional. New version of a message from a connected business account."""
196
+
197
+ deleted_business_messages: Option["BusinessMessagesDeleted"] = Nothing
198
+ """Optional. Messages were deleted from a connected business account."""
199
+
187
200
  message_reaction: Option["MessageReactionUpdated"] = Nothing
188
201
  """Optional. A reaction to a message was changed by a user. The bot must be an
189
202
  administrator in the chat and must explicitly specify `message_reaction`
@@ -261,7 +274,7 @@ class Update(Model):
261
274
 
262
275
 
263
276
  class WebhookInfo(Model):
264
- """Object `WebhookInfo`, see the [documentation](https://core.telegram.org/bots/api#webhookinfo)
277
+ """Object `WebhookInfo`, see the [documentation](https://core.telegram.org/bots/api#webhookinfo).
265
278
 
266
279
  Describes the current status of a webhook.
267
280
  """
@@ -300,7 +313,7 @@ class WebhookInfo(Model):
300
313
 
301
314
 
302
315
  class User(Model):
303
- """Object `User`, see the [documentation](https://core.telegram.org/bots/api#user)
316
+ """Object `User`, see the [documentation](https://core.telegram.org/bots/api#user).
304
317
 
305
318
  This object represents a Telegram user or bot.
306
319
  """
@@ -342,6 +355,10 @@ class User(Model):
342
355
  supports_inline_queries: Option[bool] = Nothing
343
356
  """Optional. True, if the bot supports inline queries. Returned only in getMe."""
344
357
 
358
+ can_connect_to_business: Option[bool] = Nothing
359
+ """Optional. True, if the bot can be connected to a Telegram Business account
360
+ to receive its messages. Returned only in getMe."""
361
+
345
362
  @property
346
363
  def default_accent_color(self) -> DefaultAccentColor:
347
364
  """User's or bot's accent color (non-premium)."""
@@ -356,7 +373,7 @@ class User(Model):
356
373
 
357
374
 
358
375
  class Chat(Model):
359
- """Object `Chat`, see the [documentation](https://core.telegram.org/bots/api#chat)
376
+ """Object `Chat`, see the [documentation](https://core.telegram.org/bots/api#chat).
360
377
 
361
378
  This object represents a chat.
362
379
  """
@@ -392,6 +409,26 @@ class Chat(Model):
392
409
  """Optional. If non-empty, the list of all active chat usernames; for private
393
410
  chats, supergroups and channels. Returned only in getChat."""
394
411
 
412
+ birthdate: Option["Birthdate"] = Nothing
413
+ """Optional. For private chats, the date of birth of the user. Returned only
414
+ in getChat."""
415
+
416
+ business_intro: Option["BusinessIntro"] = Nothing
417
+ """Optional. For private chats with business accounts, the intro of the business.
418
+ Returned only in getChat."""
419
+
420
+ business_location: Option["BusinessLocation"] = Nothing
421
+ """Optional. For private chats with business accounts, the location of the
422
+ business. Returned only in getChat."""
423
+
424
+ business_opening_hours: Option["BusinessOpeningHours"] = Nothing
425
+ """Optional. For private chats with business accounts, the opening hours
426
+ of the business. Returned only in getChat."""
427
+
428
+ personal_chat: Option["Chat"] = Nothing
429
+ """Optional. For private chats, the personal channel of the user. Returned
430
+ only in getChat."""
431
+
395
432
  available_reactions: Option[
396
433
  list[Variative["ReactionTypeEmoji", "ReactionTypeCustomEmoji"]]
397
434
  ] = Nothing
@@ -522,7 +559,7 @@ class Chat(Model):
522
559
 
523
560
 
524
561
  class Message(MaybeInaccessibleMessage):
525
- """Object `Message`, see the [documentation](https://core.telegram.org/bots/api#message)
562
+ """Object `Message`, see the [documentation](https://core.telegram.org/bots/api#message).
526
563
 
527
564
  This object represents a message.
528
565
  """
@@ -558,6 +595,17 @@ class Message(MaybeInaccessibleMessage):
558
595
  """Optional. If the sender of the message boosted the chat, the number of boosts
559
596
  added by the user."""
560
597
 
598
+ sender_business_bot: Option["User"] = Nothing
599
+ """Optional. The bot that actually sent the message on behalf of the business
600
+ account. Available only for outgoing messages sent on behalf of the connected
601
+ business account."""
602
+
603
+ business_connection_id: Option[str] = Nothing
604
+ """Optional. Unique identifier of the business connection from which the
605
+ message was received. If non-empty, the message belongs to a chat of the
606
+ corresponding business account that is independent from any potential
607
+ bot chat which might share the same identifier."""
608
+
561
609
  forward_origin: Option[
562
610
  Variative[
563
611
  "MessageOriginUser",
@@ -600,6 +648,10 @@ class Message(MaybeInaccessibleMessage):
600
648
  has_protected_content: Option[bool] = Nothing
601
649
  """Optional. True, if the message can't be forwarded."""
602
650
 
651
+ is_from_offline: Option[bool] = Nothing
652
+ """Optional. True, if the message was sent by an implicit action, for example,
653
+ as an away or a greeting business message, or as a scheduled message."""
654
+
603
655
  media_group_id: Option[str] = Nothing
604
656
  """Optional. The unique identifier of a media message group this message belongs
605
657
  to."""
@@ -860,7 +912,7 @@ class Message(MaybeInaccessibleMessage):
860
912
 
861
913
 
862
914
  class MessageId(Model):
863
- """Object `MessageId`, see the [documentation](https://core.telegram.org/bots/api#messageid)
915
+ """Object `MessageId`, see the [documentation](https://core.telegram.org/bots/api#messageid).
864
916
 
865
917
  This object represents a unique message identifier.
866
918
  """
@@ -870,7 +922,7 @@ class MessageId(Model):
870
922
 
871
923
 
872
924
  class InaccessibleMessage(MaybeInaccessibleMessage):
873
- """Object `InaccessibleMessage`, see the [documentation](https://core.telegram.org/bots/api#inaccessiblemessage)
925
+ """Object `InaccessibleMessage`, see the [documentation](https://core.telegram.org/bots/api#inaccessiblemessage).
874
926
 
875
927
  This object describes a message that was deleted or is otherwise inaccessible to the bot.
876
928
  """
@@ -887,7 +939,7 @@ class InaccessibleMessage(MaybeInaccessibleMessage):
887
939
 
888
940
 
889
941
  class MessageEntity(Model):
890
- """Object `MessageEntity`, see the [documentation](https://core.telegram.org/bots/api#messageentity)
942
+ """Object `MessageEntity`, see the [documentation](https://core.telegram.org/bots/api#messageentity).
891
943
 
892
944
  This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.
893
945
  """
@@ -925,7 +977,7 @@ class MessageEntity(Model):
925
977
 
926
978
 
927
979
  class TextQuote(Model):
928
- """Object `TextQuote`, see the [documentation](https://core.telegram.org/bots/api#textquote)
980
+ """Object `TextQuote`, see the [documentation](https://core.telegram.org/bots/api#textquote).
929
981
 
930
982
  This object contains information about the quoted part of a message that is replied to by the given message.
931
983
  """
@@ -948,7 +1000,7 @@ class TextQuote(Model):
948
1000
 
949
1001
 
950
1002
  class ExternalReplyInfo(Model):
951
- """Object `ExternalReplyInfo`, see the [documentation](https://core.telegram.org/bots/api#externalreplyinfo)
1003
+ """Object `ExternalReplyInfo`, see the [documentation](https://core.telegram.org/bots/api#externalreplyinfo).
952
1004
 
953
1005
  This object contains information about a message that is being replied to, which may come from another chat or forum topic.
954
1006
  """
@@ -1034,7 +1086,7 @@ class ExternalReplyInfo(Model):
1034
1086
 
1035
1087
 
1036
1088
  class ReplyParameters(Model):
1037
- """Object `ReplyParameters`, see the [documentation](https://core.telegram.org/bots/api#replyparameters)
1089
+ """Object `ReplyParameters`, see the [documentation](https://core.telegram.org/bots/api#replyparameters).
1038
1090
 
1039
1091
  Describes reply parameters for the message that is being sent.
1040
1092
  """
@@ -1045,12 +1097,13 @@ class ReplyParameters(Model):
1045
1097
 
1046
1098
  chat_id: Option[Variative[int, str]] = Nothing
1047
1099
  """Optional. If the message to be replied to is from a different chat, unique
1048
- identifier for the chat or username of the channel (in the format @channelusername)."""
1100
+ identifier for the chat or username of the channel (in the format @channelusername).
1101
+ Not supported for messages sent on behalf of a business account."""
1049
1102
 
1050
1103
  allow_sending_without_reply: Option[bool] = Nothing
1051
1104
  """Optional. Pass True if the message should be sent even if the specified message
1052
- to be replied to is not found; can be used only for replies in the same chat
1053
- and forum topic."""
1105
+ to be replied to is not found. Always False for replies in another chat or
1106
+ forum topic. Always True for messages sent on behalf of a business account."""
1054
1107
 
1055
1108
  quote: Option[str] = Nothing
1056
1109
  """Optional. Quoted part of the message to be replied to; 0-1024 characters
@@ -1072,7 +1125,7 @@ class ReplyParameters(Model):
1072
1125
 
1073
1126
 
1074
1127
  class MessageOriginUser(MessageOrigin):
1075
- """Object `MessageOriginUser`, see the [documentation](https://core.telegram.org/bots/api#messageoriginuser)
1128
+ """Object `MessageOriginUser`, see the [documentation](https://core.telegram.org/bots/api#messageoriginuser).
1076
1129
 
1077
1130
  The message was originally sent by a known user.
1078
1131
  """
@@ -1088,7 +1141,7 @@ class MessageOriginUser(MessageOrigin):
1088
1141
 
1089
1142
 
1090
1143
  class MessageOriginHiddenUser(MessageOrigin):
1091
- """Object `MessageOriginHiddenUser`, see the [documentation](https://core.telegram.org/bots/api#messageoriginhiddenuser)
1144
+ """Object `MessageOriginHiddenUser`, see the [documentation](https://core.telegram.org/bots/api#messageoriginhiddenuser).
1092
1145
 
1093
1146
  The message was originally sent by an unknown user.
1094
1147
  """
@@ -1104,7 +1157,7 @@ class MessageOriginHiddenUser(MessageOrigin):
1104
1157
 
1105
1158
 
1106
1159
  class MessageOriginChat(MessageOrigin):
1107
- """Object `MessageOriginChat`, see the [documentation](https://core.telegram.org/bots/api#messageoriginchat)
1160
+ """Object `MessageOriginChat`, see the [documentation](https://core.telegram.org/bots/api#messageoriginchat).
1108
1161
 
1109
1162
  The message was originally sent on behalf of a chat to a group chat.
1110
1163
  """
@@ -1124,7 +1177,7 @@ class MessageOriginChat(MessageOrigin):
1124
1177
 
1125
1178
 
1126
1179
  class MessageOriginChannel(MessageOrigin):
1127
- """Object `MessageOriginChannel`, see the [documentation](https://core.telegram.org/bots/api#messageoriginchannel)
1180
+ """Object `MessageOriginChannel`, see the [documentation](https://core.telegram.org/bots/api#messageoriginchannel).
1128
1181
 
1129
1182
  The message was originally sent to a channel chat.
1130
1183
  """
@@ -1146,7 +1199,7 @@ class MessageOriginChannel(MessageOrigin):
1146
1199
 
1147
1200
 
1148
1201
  class PhotoSize(Model):
1149
- """Object `PhotoSize`, see the [documentation](https://core.telegram.org/bots/api#photosize)
1202
+ """Object `PhotoSize`, see the [documentation](https://core.telegram.org/bots/api#photosize).
1150
1203
 
1151
1204
  This object represents one size of a photo or a file / sticker thumbnail.
1152
1205
  """
@@ -1169,7 +1222,7 @@ class PhotoSize(Model):
1169
1222
 
1170
1223
 
1171
1224
  class Animation(Model):
1172
- """Object `Animation`, see the [documentation](https://core.telegram.org/bots/api#animation)
1225
+ """Object `Animation`, see the [documentation](https://core.telegram.org/bots/api#animation).
1173
1226
 
1174
1227
  This object represents an animation file (GIF or H.264/MPEG-4 AVC video without sound).
1175
1228
  """
@@ -1207,7 +1260,7 @@ class Animation(Model):
1207
1260
 
1208
1261
 
1209
1262
  class Audio(Model):
1210
- """Object `Audio`, see the [documentation](https://core.telegram.org/bots/api#audio)
1263
+ """Object `Audio`, see the [documentation](https://core.telegram.org/bots/api#audio).
1211
1264
 
1212
1265
  This object represents an audio file to be treated as music by the Telegram clients.
1213
1266
  """
@@ -1245,7 +1298,7 @@ class Audio(Model):
1245
1298
 
1246
1299
 
1247
1300
  class Document(Model):
1248
- """Object `Document`, see the [documentation](https://core.telegram.org/bots/api#document)
1301
+ """Object `Document`, see the [documentation](https://core.telegram.org/bots/api#document).
1249
1302
 
1250
1303
  This object represents a general file (as opposed to photos, voice messages and audio files).
1251
1304
  """
@@ -1274,7 +1327,7 @@ class Document(Model):
1274
1327
 
1275
1328
 
1276
1329
  class Story(Model):
1277
- """Object `Story`, see the [documentation](https://core.telegram.org/bots/api#story)
1330
+ """Object `Story`, see the [documentation](https://core.telegram.org/bots/api#story).
1278
1331
 
1279
1332
  This object represents a story.
1280
1333
  """
@@ -1287,7 +1340,7 @@ class Story(Model):
1287
1340
 
1288
1341
 
1289
1342
  class Video(Model):
1290
- """Object `Video`, see the [documentation](https://core.telegram.org/bots/api#video)
1343
+ """Object `Video`, see the [documentation](https://core.telegram.org/bots/api#video).
1291
1344
 
1292
1345
  This object represents a video file.
1293
1346
  """
@@ -1325,7 +1378,7 @@ class Video(Model):
1325
1378
 
1326
1379
 
1327
1380
  class VideoNote(Model):
1328
- """Object `VideoNote`, see the [documentation](https://core.telegram.org/bots/api#videonote)
1381
+ """Object `VideoNote`, see the [documentation](https://core.telegram.org/bots/api#videonote).
1329
1382
 
1330
1383
  This object represents a video message (available in Telegram apps as of v.4.0).
1331
1384
  """
@@ -1351,7 +1404,7 @@ class VideoNote(Model):
1351
1404
 
1352
1405
 
1353
1406
  class Voice(Model):
1354
- """Object `Voice`, see the [documentation](https://core.telegram.org/bots/api#voice)
1407
+ """Object `Voice`, see the [documentation](https://core.telegram.org/bots/api#voice).
1355
1408
 
1356
1409
  This object represents a voice note.
1357
1410
  """
@@ -1377,7 +1430,7 @@ class Voice(Model):
1377
1430
 
1378
1431
 
1379
1432
  class Contact(Model):
1380
- """Object `Contact`, see the [documentation](https://core.telegram.org/bots/api#contact)
1433
+ """Object `Contact`, see the [documentation](https://core.telegram.org/bots/api#contact).
1381
1434
 
1382
1435
  This object represents a phone contact.
1383
1436
  """
@@ -1402,7 +1455,7 @@ class Contact(Model):
1402
1455
 
1403
1456
 
1404
1457
  class Dice(Model):
1405
- """Object `Dice`, see the [documentation](https://core.telegram.org/bots/api#dice)
1458
+ """Object `Dice`, see the [documentation](https://core.telegram.org/bots/api#dice).
1406
1459
 
1407
1460
  This object represents an animated emoji that displays a random value.
1408
1461
  """
@@ -1416,7 +1469,7 @@ class Dice(Model):
1416
1469
 
1417
1470
 
1418
1471
  class PollOption(Model):
1419
- """Object `PollOption`, see the [documentation](https://core.telegram.org/bots/api#polloption)
1472
+ """Object `PollOption`, see the [documentation](https://core.telegram.org/bots/api#polloption).
1420
1473
 
1421
1474
  This object contains information about one answer option in a poll.
1422
1475
  """
@@ -1429,7 +1482,7 @@ class PollOption(Model):
1429
1482
 
1430
1483
 
1431
1484
  class PollAnswer(Model):
1432
- """Object `PollAnswer`, see the [documentation](https://core.telegram.org/bots/api#pollanswer)
1485
+ """Object `PollAnswer`, see the [documentation](https://core.telegram.org/bots/api#pollanswer).
1433
1486
 
1434
1487
  This object represents an answer of a user in a non-anonymous poll.
1435
1488
  """
@@ -1450,7 +1503,7 @@ class PollAnswer(Model):
1450
1503
 
1451
1504
 
1452
1505
  class Poll(Model):
1453
- """Object `Poll`, see the [documentation](https://core.telegram.org/bots/api#poll)
1506
+ """Object `Poll`, see the [documentation](https://core.telegram.org/bots/api#poll).
1454
1507
 
1455
1508
  This object contains information about a poll.
1456
1509
  """
@@ -1501,7 +1554,7 @@ class Poll(Model):
1501
1554
 
1502
1555
 
1503
1556
  class Location(Model):
1504
- """Object `Location`, see the [documentation](https://core.telegram.org/bots/api#location)
1557
+ """Object `Location`, see the [documentation](https://core.telegram.org/bots/api#location).
1505
1558
 
1506
1559
  This object represents a point on the map.
1507
1560
  """
@@ -1530,7 +1583,7 @@ class Location(Model):
1530
1583
 
1531
1584
 
1532
1585
  class Venue(Model):
1533
- """Object `Venue`, see the [documentation](https://core.telegram.org/bots/api#venue)
1586
+ """Object `Venue`, see the [documentation](https://core.telegram.org/bots/api#venue).
1534
1587
 
1535
1588
  This object represents a venue.
1536
1589
  """
@@ -1559,7 +1612,7 @@ class Venue(Model):
1559
1612
 
1560
1613
 
1561
1614
  class WebAppData(Model):
1562
- """Object `WebAppData`, see the [documentation](https://core.telegram.org/bots/api#webappdata)
1615
+ """Object `WebAppData`, see the [documentation](https://core.telegram.org/bots/api#webappdata).
1563
1616
 
1564
1617
  Describes data sent from a Web App to the bot.
1565
1618
  """
@@ -1573,7 +1626,7 @@ class WebAppData(Model):
1573
1626
 
1574
1627
 
1575
1628
  class ProximityAlertTriggered(Model):
1576
- """Object `ProximityAlertTriggered`, see the [documentation](https://core.telegram.org/bots/api#proximityalerttriggered)
1629
+ """Object `ProximityAlertTriggered`, see the [documentation](https://core.telegram.org/bots/api#proximityalerttriggered).
1577
1630
 
1578
1631
  This object represents the content of a service message, sent whenever a user in the chat triggers a proximity alert set by another user.
1579
1632
  """
@@ -1589,7 +1642,7 @@ class ProximityAlertTriggered(Model):
1589
1642
 
1590
1643
 
1591
1644
  class MessageAutoDeleteTimerChanged(Model):
1592
- """Object `MessageAutoDeleteTimerChanged`, see the [documentation](https://core.telegram.org/bots/api#messageautodeletetimerchanged)
1645
+ """Object `MessageAutoDeleteTimerChanged`, see the [documentation](https://core.telegram.org/bots/api#messageautodeletetimerchanged).
1593
1646
 
1594
1647
  This object represents a service message about a change in auto-delete timer settings.
1595
1648
  """
@@ -1599,7 +1652,7 @@ class MessageAutoDeleteTimerChanged(Model):
1599
1652
 
1600
1653
 
1601
1654
  class ChatBoostAdded(Model):
1602
- """Object `ChatBoostAdded`, see the [documentation](https://core.telegram.org/bots/api#chatboostadded)
1655
+ """Object `ChatBoostAdded`, see the [documentation](https://core.telegram.org/bots/api#chatboostadded).
1603
1656
 
1604
1657
  This object represents a service message about a user boosting a chat.
1605
1658
  """
@@ -1609,7 +1662,7 @@ class ChatBoostAdded(Model):
1609
1662
 
1610
1663
 
1611
1664
  class ForumTopicCreated(Model):
1612
- """Object `ForumTopicCreated`, see the [documentation](https://core.telegram.org/bots/api#forumtopiccreated)
1665
+ """Object `ForumTopicCreated`, see the [documentation](https://core.telegram.org/bots/api#forumtopiccreated).
1613
1666
 
1614
1667
  This object represents a service message about a new forum topic created in the chat.
1615
1668
  """
@@ -1625,14 +1678,14 @@ class ForumTopicCreated(Model):
1625
1678
 
1626
1679
 
1627
1680
  class ForumTopicClosed(Model):
1628
- """Object `ForumTopicClosed`, see the [documentation](https://core.telegram.org/bots/api#forumtopicclosed)
1681
+ """Object `ForumTopicClosed`, see the [documentation](https://core.telegram.org/bots/api#forumtopicclosed).
1629
1682
 
1630
1683
  This object represents a service message about a forum topic closed in the chat. Currently holds no information.
1631
1684
  """
1632
1685
 
1633
1686
 
1634
1687
  class ForumTopicEdited(Model):
1635
- """Object `ForumTopicEdited`, see the [documentation](https://core.telegram.org/bots/api#forumtopicedited)
1688
+ """Object `ForumTopicEdited`, see the [documentation](https://core.telegram.org/bots/api#forumtopicedited).
1636
1689
 
1637
1690
  This object represents a service message about an edited forum topic.
1638
1691
  """
@@ -1646,28 +1699,56 @@ class ForumTopicEdited(Model):
1646
1699
 
1647
1700
 
1648
1701
  class ForumTopicReopened(Model):
1649
- """Object `ForumTopicReopened`, see the [documentation](https://core.telegram.org/bots/api#forumtopicreopened)
1702
+ """Object `ForumTopicReopened`, see the [documentation](https://core.telegram.org/bots/api#forumtopicreopened).
1650
1703
 
1651
1704
  This object represents a service message about a forum topic reopened in the chat. Currently holds no information.
1652
1705
  """
1653
1706
 
1654
1707
 
1655
1708
  class GeneralForumTopicHidden(Model):
1656
- """Object `GeneralForumTopicHidden`, see the [documentation](https://core.telegram.org/bots/api#generalforumtopichidden)
1709
+ """Object `GeneralForumTopicHidden`, see the [documentation](https://core.telegram.org/bots/api#generalforumtopichidden).
1657
1710
 
1658
1711
  This object represents a service message about General forum topic hidden in the chat. Currently holds no information.
1659
1712
  """
1660
1713
 
1661
1714
 
1662
1715
  class GeneralForumTopicUnhidden(Model):
1663
- """Object `GeneralForumTopicUnhidden`, see the [documentation](https://core.telegram.org/bots/api#generalforumtopicunhidden)
1716
+ """Object `GeneralForumTopicUnhidden`, see the [documentation](https://core.telegram.org/bots/api#generalforumtopicunhidden).
1664
1717
 
1665
1718
  This object represents a service message about General forum topic unhidden in the chat. Currently holds no information.
1666
1719
  """
1667
1720
 
1668
1721
 
1722
+ class SharedUser(Model):
1723
+ """Object `SharedUser`, see the [documentation](https://core.telegram.org/bots/api#shareduser).
1724
+
1725
+ This object contains information about a user that was shared with the bot using a KeyboardButtonRequestUser button.
1726
+ """
1727
+
1728
+ user_id: int
1729
+ """Identifier of the shared user. This number may have more than 32 significant
1730
+ bits and some programming languages may have difficulty/silent defects
1731
+ in interpreting it. But it has at most 52 significant bits, so 64-bit integers
1732
+ or double-precision float types are safe for storing these identifiers.
1733
+ The bot may not have access to the user and could be unable to use this identifier,
1734
+ unless the user is already known to the bot by some other means."""
1735
+
1736
+ first_name: Option[str] = Nothing
1737
+ """Optional. First name of the user, if the name was requested by the bot."""
1738
+
1739
+ last_name: Option[str] = Nothing
1740
+ """Optional. Last name of the user, if the name was requested by the bot."""
1741
+
1742
+ username: Option[str] = Nothing
1743
+ """Optional. Username of the user, if the username was requested by the bot."""
1744
+
1745
+ photo: Option[list["PhotoSize"]] = Nothing
1746
+ """Optional. Available sizes of the chat photo, if the photo was requested
1747
+ by the bot."""
1748
+
1749
+
1669
1750
  class UsersShared(Model):
1670
- """Object `UsersShared`, see the [documentation](https://core.telegram.org/bots/api#usersshared)
1751
+ """Object `UsersShared`, see the [documentation](https://core.telegram.org/bots/api#usersshared).
1671
1752
 
1672
1753
  This object contains information about the users whose identifiers were shared with the bot using a KeyboardButtonRequestUsers button.
1673
1754
  """
@@ -1675,19 +1756,14 @@ class UsersShared(Model):
1675
1756
  request_id: int
1676
1757
  """Identifier of the request."""
1677
1758
 
1678
- user_ids: list[int]
1679
- """Identifiers of the shared users. These numbers may have more than 32 significant
1680
- bits and some programming languages may have difficulty/silent defects
1681
- in interpreting them. But they have at most 52 significant bits, so 64-bit
1682
- integers or double-precision float types are safe for storing these identifiers.
1683
- The bot may not have access to the users and could be unable to use these identifiers,
1684
- unless the users are already known to the bot by some other means."""
1759
+ users: list["SharedUser"]
1760
+ """Information about users shared with the bot."""
1685
1761
 
1686
1762
 
1687
1763
  class ChatShared(Model):
1688
- """Object `ChatShared`, see the [documentation](https://core.telegram.org/bots/api#chatshared)
1764
+ """Object `ChatShared`, see the [documentation](https://core.telegram.org/bots/api#chatshared).
1689
1765
 
1690
- This object contains information about the chat whose identifier was shared with the bot using a KeyboardButtonRequestChat button.
1766
+ This object contains information about a chat that was shared with the bot using a KeyboardButtonRequestChat button.
1691
1767
  """
1692
1768
 
1693
1769
  request_id: int
@@ -1701,9 +1777,20 @@ class ChatShared(Model):
1701
1777
  bot may not have access to the chat and could be unable to use this identifier,
1702
1778
  unless the chat is already known to the bot by some other means."""
1703
1779
 
1780
+ title: Option[str] = Nothing
1781
+ """Optional. Title of the chat, if the title was requested by the bot."""
1782
+
1783
+ username: Option[str] = Nothing
1784
+ """Optional. Username of the chat, if the username was requested by the bot
1785
+ and available."""
1786
+
1787
+ photo: Option[list["PhotoSize"]] = Nothing
1788
+ """Optional. Available sizes of the chat photo, if the photo was requested
1789
+ by the bot."""
1790
+
1704
1791
 
1705
1792
  class WriteAccessAllowed(Model):
1706
- """Object `WriteAccessAllowed`, see the [documentation](https://core.telegram.org/bots/api#writeaccessallowed)
1793
+ """Object `WriteAccessAllowed`, see the [documentation](https://core.telegram.org/bots/api#writeaccessallowed).
1707
1794
 
1708
1795
  This object represents a service message about a user allowing a bot to write messages after adding it to the attachment menu, launching a Web App from a link, or accepting an explicit request from a Web App sent by the method requestWriteAccess.
1709
1796
  """
@@ -1722,7 +1809,7 @@ class WriteAccessAllowed(Model):
1722
1809
 
1723
1810
 
1724
1811
  class VideoChatScheduled(Model):
1725
- """Object `VideoChatScheduled`, see the [documentation](https://core.telegram.org/bots/api#videochatscheduled)
1812
+ """Object `VideoChatScheduled`, see the [documentation](https://core.telegram.org/bots/api#videochatscheduled).
1726
1813
 
1727
1814
  This object represents a service message about a video chat scheduled in the chat.
1728
1815
  """
@@ -1733,14 +1820,14 @@ class VideoChatScheduled(Model):
1733
1820
 
1734
1821
 
1735
1822
  class VideoChatStarted(Model):
1736
- """Object `VideoChatStarted`, see the [documentation](https://core.telegram.org/bots/api#videochatstarted)
1823
+ """Object `VideoChatStarted`, see the [documentation](https://core.telegram.org/bots/api#videochatstarted).
1737
1824
 
1738
1825
  This object represents a service message about a video chat started in the chat. Currently holds no information.
1739
1826
  """
1740
1827
 
1741
1828
 
1742
1829
  class VideoChatEnded(Model):
1743
- """Object `VideoChatEnded`, see the [documentation](https://core.telegram.org/bots/api#videochatended)
1830
+ """Object `VideoChatEnded`, see the [documentation](https://core.telegram.org/bots/api#videochatended).
1744
1831
 
1745
1832
  This object represents a service message about a video chat ended in the chat.
1746
1833
  """
@@ -1750,7 +1837,7 @@ class VideoChatEnded(Model):
1750
1837
 
1751
1838
 
1752
1839
  class VideoChatParticipantsInvited(Model):
1753
- """Object `VideoChatParticipantsInvited`, see the [documentation](https://core.telegram.org/bots/api#videochatparticipantsinvited)
1840
+ """Object `VideoChatParticipantsInvited`, see the [documentation](https://core.telegram.org/bots/api#videochatparticipantsinvited).
1754
1841
 
1755
1842
  This object represents a service message about new members invited to a video chat.
1756
1843
  """
@@ -1760,14 +1847,14 @@ class VideoChatParticipantsInvited(Model):
1760
1847
 
1761
1848
 
1762
1849
  class GiveawayCreated(Model):
1763
- """Object `GiveawayCreated`, see the [documentation](https://core.telegram.org/bots/api#giveawaycreated)
1850
+ """Object `GiveawayCreated`, see the [documentation](https://core.telegram.org/bots/api#giveawaycreated).
1764
1851
 
1765
1852
  This object represents a service message about the creation of a scheduled giveaway. Currently holds no information.
1766
1853
  """
1767
1854
 
1768
1855
 
1769
1856
  class Giveaway(Model):
1770
- """Object `Giveaway`, see the [documentation](https://core.telegram.org/bots/api#giveaway)
1857
+ """Object `Giveaway`, see the [documentation](https://core.telegram.org/bots/api#giveaway).
1771
1858
 
1772
1859
  This object represents a message about a scheduled giveaway.
1773
1860
  """
@@ -1803,7 +1890,7 @@ class Giveaway(Model):
1803
1890
 
1804
1891
 
1805
1892
  class GiveawayWinners(Model):
1806
- """Object `GiveawayWinners`, see the [documentation](https://core.telegram.org/bots/api#giveawaywinners)
1893
+ """Object `GiveawayWinners`, see the [documentation](https://core.telegram.org/bots/api#giveawaywinners).
1807
1894
 
1808
1895
  This object represents a message about the completion of a giveaway with public winners.
1809
1896
  """
@@ -1847,7 +1934,7 @@ class GiveawayWinners(Model):
1847
1934
 
1848
1935
 
1849
1936
  class GiveawayCompleted(Model):
1850
- """Object `GiveawayCompleted`, see the [documentation](https://core.telegram.org/bots/api#giveawaycompleted)
1937
+ """Object `GiveawayCompleted`, see the [documentation](https://core.telegram.org/bots/api#giveawaycompleted).
1851
1938
 
1852
1939
  This object represents a service message about the completion of a giveaway without public winners.
1853
1940
  """
@@ -1863,7 +1950,7 @@ class GiveawayCompleted(Model):
1863
1950
 
1864
1951
 
1865
1952
  class LinkPreviewOptions(Model):
1866
- """Object `LinkPreviewOptions`, see the [documentation](https://core.telegram.org/bots/api#linkpreviewoptions)
1953
+ """Object `LinkPreviewOptions`, see the [documentation](https://core.telegram.org/bots/api#linkpreviewoptions).
1867
1954
 
1868
1955
  Describes the options used for link preview generation.
1869
1956
  """
@@ -1891,7 +1978,7 @@ class LinkPreviewOptions(Model):
1891
1978
 
1892
1979
 
1893
1980
  class UserProfilePhotos(Model):
1894
- """Object `UserProfilePhotos`, see the [documentation](https://core.telegram.org/bots/api#userprofilephotos)
1981
+ """Object `UserProfilePhotos`, see the [documentation](https://core.telegram.org/bots/api#userprofilephotos).
1895
1982
 
1896
1983
  This object represent a user's profile pictures.
1897
1984
  """
@@ -1904,7 +1991,7 @@ class UserProfilePhotos(Model):
1904
1991
 
1905
1992
 
1906
1993
  class File(Model):
1907
- """Object `File`, see the [documentation](https://core.telegram.org/bots/api#file)
1994
+ """Object `File`, see the [documentation](https://core.telegram.org/bots/api#file).
1908
1995
 
1909
1996
  This object represents a file ready to be downloaded. The file can be downloaded via the link https://api.telegram.org/file/bot<token>/<file_path>. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling getFile.
1910
1997
  """
@@ -1928,7 +2015,7 @@ class File(Model):
1928
2015
 
1929
2016
 
1930
2017
  class WebAppInfo(Model):
1931
- """Object `WebAppInfo`, see the [documentation](https://core.telegram.org/bots/api#webappinfo)
2018
+ """Object `WebAppInfo`, see the [documentation](https://core.telegram.org/bots/api#webappinfo).
1932
2019
 
1933
2020
  Describes a Web App.
1934
2021
  """
@@ -1939,7 +2026,7 @@ class WebAppInfo(Model):
1939
2026
 
1940
2027
 
1941
2028
  class ReplyKeyboardMarkup(Model):
1942
- """Object `ReplyKeyboardMarkup`, see the [documentation](https://core.telegram.org/bots/api#replykeyboardmarkup)
2029
+ """Object `ReplyKeyboardMarkup`, see the [documentation](https://core.telegram.org/bots/api#replykeyboardmarkup).
1943
2030
 
1944
2031
  This object represents a custom keyboard with reply options (see Introduction to bots for details and examples).
1945
2032
  """
@@ -1984,7 +2071,7 @@ class ReplyKeyboardMarkup(Model):
1984
2071
 
1985
2072
 
1986
2073
  class KeyboardButton(Model):
1987
- """Object `KeyboardButton`, see the [documentation](https://core.telegram.org/bots/api#keyboardbutton)
2074
+ """Object `KeyboardButton`, see the [documentation](https://core.telegram.org/bots/api#keyboardbutton).
1988
2075
 
1989
2076
  This object represents one button of the reply keyboard. For simple text buttons, String can be used instead of this object to specify the button text. The optional fields web_app, request_users, request_chat, request_contact, request_location, and request_poll are mutually exclusive.
1990
2077
  Note: request_users and request_chat options will only work in Telegram versions released after 3 February, 2023. Older clients will display unsupported message.
@@ -2023,9 +2110,9 @@ class KeyboardButton(Model):
2023
2110
 
2024
2111
 
2025
2112
  class KeyboardButtonRequestUsers(Model):
2026
- """Object `KeyboardButtonRequestUsers`, see the [documentation](https://core.telegram.org/bots/api#keyboardbuttonrequestusers)
2113
+ """Object `KeyboardButtonRequestUsers`, see the [documentation](https://core.telegram.org/bots/api#keyboardbuttonrequestusers).
2027
2114
 
2028
- This object defines the criteria used to request suitable users. The identifiers of the selected users will be shared with the bot when the corresponding button is pressed. More about requesting users: https://core.telegram.org/bots/features#chat-and-user-selection
2115
+ This object defines the criteria used to request suitable users. Information about the selected users will be shared with the bot when the corresponding button is pressed. More about requesting users: https://core.telegram.org/bots/features#chat-and-user-selection
2029
2116
  """
2030
2117
 
2031
2118
  request_id: int
@@ -2044,11 +2131,20 @@ class KeyboardButtonRequestUsers(Model):
2044
2131
  """Optional. The maximum number of users to be selected; 1-10. Defaults to
2045
2132
  1."""
2046
2133
 
2134
+ request_name: Option[bool] = Nothing
2135
+ """Optional. Pass True to request the users' first and last name."""
2136
+
2137
+ request_username: Option[bool] = Nothing
2138
+ """Optional. Pass True to request the users' username."""
2139
+
2140
+ request_photo: Option[bool] = Nothing
2141
+ """Optional. Pass True to request the users' photo."""
2142
+
2047
2143
 
2048
2144
  class KeyboardButtonRequestChat(Model):
2049
- """Object `KeyboardButtonRequestChat`, see the [documentation](https://core.telegram.org/bots/api#keyboardbuttonrequestchat)
2145
+ """Object `KeyboardButtonRequestChat`, see the [documentation](https://core.telegram.org/bots/api#keyboardbuttonrequestchat).
2050
2146
 
2051
- This object defines the criteria used to request a suitable chat. The identifier of the selected chat will be shared with the bot when the corresponding button is pressed. More about requesting chats: https://core.telegram.org/bots/features#chat-and-user-selection
2147
+ This object defines the criteria used to request a suitable chat. Information about the selected chat will be shared with the bot when the corresponding button is pressed. The bot will be granted requested rights in the сhat if appropriate More about requesting chats: https://core.telegram.org/bots/features#chat-and-user-selection
2052
2148
  """
2053
2149
 
2054
2150
  request_id: int
@@ -2086,9 +2182,18 @@ class KeyboardButtonRequestChat(Model):
2086
2182
  """Optional. Pass True to request a chat with the bot as a member. Otherwise,
2087
2183
  no additional restrictions are applied."""
2088
2184
 
2185
+ request_title: Option[bool] = Nothing
2186
+ """Optional. Pass True to request the chat's title."""
2187
+
2188
+ request_username: Option[bool] = Nothing
2189
+ """Optional. Pass True to request the chat's username."""
2190
+
2191
+ request_photo: Option[bool] = Nothing
2192
+ """Optional. Pass True to request the chat's photo."""
2193
+
2089
2194
 
2090
2195
  class KeyboardButtonPollType(Model):
2091
- """Object `KeyboardButtonPollType`, see the [documentation](https://core.telegram.org/bots/api#keyboardbuttonpolltype)
2196
+ """Object `KeyboardButtonPollType`, see the [documentation](https://core.telegram.org/bots/api#keyboardbuttonpolltype).
2092
2197
 
2093
2198
  This object represents type of a poll, which is allowed to be created and sent when the corresponding button is pressed.
2094
2199
  """
@@ -2100,7 +2205,7 @@ class KeyboardButtonPollType(Model):
2100
2205
 
2101
2206
 
2102
2207
  class ReplyKeyboardRemove(Model):
2103
- """Object `ReplyKeyboardRemove`, see the [documentation](https://core.telegram.org/bots/api#replykeyboardremove)
2208
+ """Object `ReplyKeyboardRemove`, see the [documentation](https://core.telegram.org/bots/api#replykeyboardremove).
2104
2209
 
2105
2210
  Upon receiving a message with this object, Telegram clients will remove the current custom keyboard and display the default letter-keyboard. By default, custom keyboards are displayed until a new keyboard is sent by a bot. An exception is made for one-time keyboards that are hidden immediately after the user presses a button (see ReplyKeyboardMarkup).
2106
2211
  """
@@ -2121,7 +2226,7 @@ class ReplyKeyboardRemove(Model):
2121
2226
 
2122
2227
 
2123
2228
  class InlineKeyboardMarkup(Model):
2124
- """Object `InlineKeyboardMarkup`, see the [documentation](https://core.telegram.org/bots/api#inlinekeyboardmarkup)
2229
+ """Object `InlineKeyboardMarkup`, see the [documentation](https://core.telegram.org/bots/api#inlinekeyboardmarkup).
2125
2230
 
2126
2231
  This object represents an inline keyboard that appears right next to the message it belongs to.
2127
2232
  """
@@ -2132,7 +2237,7 @@ class InlineKeyboardMarkup(Model):
2132
2237
 
2133
2238
 
2134
2239
  class InlineKeyboardButton(Model):
2135
- """Object `InlineKeyboardButton`, see the [documentation](https://core.telegram.org/bots/api#inlinekeyboardbutton)
2240
+ """Object `InlineKeyboardButton`, see the [documentation](https://core.telegram.org/bots/api#inlinekeyboardbutton).
2136
2241
 
2137
2242
  This object represents one button of an inline keyboard. You must use exactly one of the optional fields.
2138
2243
  """
@@ -2189,7 +2294,7 @@ class InlineKeyboardButton(Model):
2189
2294
 
2190
2295
 
2191
2296
  class LoginUrl(Model):
2192
- """Object `LoginUrl`, see the [documentation](https://core.telegram.org/bots/api#loginurl)
2297
+ """Object `LoginUrl`, see the [documentation](https://core.telegram.org/bots/api#loginurl).
2193
2298
 
2194
2299
  This object represents a parameter of the inline keyboard button used to automatically authorize a user. Serves as a great replacement for the Telegram Login Widget when the user is coming from Telegram. All the user needs to do is tap/click a button and confirm that they want to log in:
2195
2300
  Telegram apps support these buttons as of version 5.7.
@@ -2218,7 +2323,7 @@ class LoginUrl(Model):
2218
2323
 
2219
2324
 
2220
2325
  class SwitchInlineQueryChosenChat(Model):
2221
- """Object `SwitchInlineQueryChosenChat`, see the [documentation](https://core.telegram.org/bots/api#switchinlinequerychosenchat)
2326
+ """Object `SwitchInlineQueryChosenChat`, see the [documentation](https://core.telegram.org/bots/api#switchinlinequerychosenchat).
2222
2327
 
2223
2328
  This object represents an inline button that switches the current user to inline mode in a chosen chat, with an optional default inline query.
2224
2329
  """
@@ -2241,7 +2346,7 @@ class SwitchInlineQueryChosenChat(Model):
2241
2346
 
2242
2347
 
2243
2348
  class CallbackQuery(Model):
2244
- """Object `CallbackQuery`, see the [documentation](https://core.telegram.org/bots/api#callbackquery)
2349
+ """Object `CallbackQuery`, see the [documentation](https://core.telegram.org/bots/api#callbackquery).
2245
2350
 
2246
2351
  This object represents an incoming callback query from a callback button in an inline keyboard. If the button that originated the query was attached to a message sent by the bot, the field message will be present. If the button was attached to a message sent via the bot (in inline mode), the field inline_message_id will be present. Exactly one of the fields data or game_short_name will be present.
2247
2352
  """
@@ -2274,7 +2379,7 @@ class CallbackQuery(Model):
2274
2379
 
2275
2380
 
2276
2381
  class ForceReply(Model):
2277
- """Object `ForceReply`, see the [documentation](https://core.telegram.org/bots/api#forcereply)
2382
+ """Object `ForceReply`, see the [documentation](https://core.telegram.org/bots/api#forcereply).
2278
2383
 
2279
2384
  Upon receiving a message with this object, Telegram clients will display a reply interface to the user (act as if the user has selected the bot's message and tapped 'Reply'). This can be extremely useful if you want to create user-friendly step-by-step interfaces without having to sacrifice privacy mode.
2280
2385
  """
@@ -2295,7 +2400,7 @@ class ForceReply(Model):
2295
2400
 
2296
2401
 
2297
2402
  class ChatPhoto(Model):
2298
- """Object `ChatPhoto`, see the [documentation](https://core.telegram.org/bots/api#chatphoto)
2403
+ """Object `ChatPhoto`, see the [documentation](https://core.telegram.org/bots/api#chatphoto).
2299
2404
 
2300
2405
  This object represents a chat photo.
2301
2406
  """
@@ -2320,7 +2425,7 @@ class ChatPhoto(Model):
2320
2425
 
2321
2426
 
2322
2427
  class ChatInviteLink(Model):
2323
- """Object `ChatInviteLink`, see the [documentation](https://core.telegram.org/bots/api#chatinvitelink)
2428
+ """Object `ChatInviteLink`, see the [documentation](https://core.telegram.org/bots/api#chatinvitelink).
2324
2429
 
2325
2430
  Represents an invite link for a chat.
2326
2431
  """
@@ -2357,7 +2462,7 @@ class ChatInviteLink(Model):
2357
2462
 
2358
2463
 
2359
2464
  class ChatAdministratorRights(Model):
2360
- """Object `ChatAdministratorRights`, see the [documentation](https://core.telegram.org/bots/api#chatadministratorrights)
2465
+ """Object `ChatAdministratorRights`, see the [documentation](https://core.telegram.org/bots/api#chatadministratorrights).
2361
2466
 
2362
2467
  Represents the rights of an administrator in a chat.
2363
2468
  """
@@ -2418,7 +2523,7 @@ class ChatAdministratorRights(Model):
2418
2523
 
2419
2524
 
2420
2525
  class ChatMemberUpdated(Model):
2421
- """Object `ChatMemberUpdated`, see the [documentation](https://core.telegram.org/bots/api#chatmemberupdated)
2526
+ """Object `ChatMemberUpdated`, see the [documentation](https://core.telegram.org/bots/api#chatmemberupdated).
2422
2527
 
2423
2528
  This object represents changes in the status of a chat member.
2424
2529
  """
@@ -2461,7 +2566,7 @@ class ChatMemberUpdated(Model):
2461
2566
 
2462
2567
 
2463
2568
  class ChatMemberOwner(ChatMember):
2464
- """Object `ChatMemberOwner`, see the [documentation](https://core.telegram.org/bots/api#chatmemberowner)
2569
+ """Object `ChatMemberOwner`, see the [documentation](https://core.telegram.org/bots/api#chatmemberowner).
2465
2570
 
2466
2571
  Represents a chat member that owns the chat and has all administrator privileges.
2467
2572
  """
@@ -2480,7 +2585,7 @@ class ChatMemberOwner(ChatMember):
2480
2585
 
2481
2586
 
2482
2587
  class ChatMemberAdministrator(ChatMember):
2483
- """Object `ChatMemberAdministrator`, see the [documentation](https://core.telegram.org/bots/api#chatmemberadministrator)
2588
+ """Object `ChatMemberAdministrator`, see the [documentation](https://core.telegram.org/bots/api#chatmemberadministrator).
2484
2589
 
2485
2590
  Represents a chat member that has some additional privileges.
2486
2591
  """
@@ -2553,7 +2658,7 @@ class ChatMemberAdministrator(ChatMember):
2553
2658
 
2554
2659
 
2555
2660
  class ChatMemberMember(ChatMember):
2556
- """Object `ChatMemberMember`, see the [documentation](https://core.telegram.org/bots/api#chatmembermember)
2661
+ """Object `ChatMemberMember`, see the [documentation](https://core.telegram.org/bots/api#chatmembermember).
2557
2662
 
2558
2663
  Represents a chat member that has no additional privileges or restrictions.
2559
2664
  """
@@ -2566,7 +2671,7 @@ class ChatMemberMember(ChatMember):
2566
2671
 
2567
2672
 
2568
2673
  class ChatMemberRestricted(ChatMember):
2569
- """Object `ChatMemberRestricted`, see the [documentation](https://core.telegram.org/bots/api#chatmemberrestricted)
2674
+ """Object `ChatMemberRestricted`, see the [documentation](https://core.telegram.org/bots/api#chatmemberrestricted).
2570
2675
 
2571
2676
  Represents a chat member that is under certain restrictions in the chat. Supergroups only.
2572
2677
  """
@@ -2630,7 +2735,7 @@ class ChatMemberRestricted(ChatMember):
2630
2735
 
2631
2736
 
2632
2737
  class ChatMemberLeft(ChatMember):
2633
- """Object `ChatMemberLeft`, see the [documentation](https://core.telegram.org/bots/api#chatmemberleft)
2738
+ """Object `ChatMemberLeft`, see the [documentation](https://core.telegram.org/bots/api#chatmemberleft).
2634
2739
 
2635
2740
  Represents a chat member that isn't currently a member of the chat, but may join it themselves.
2636
2741
  """
@@ -2643,7 +2748,7 @@ class ChatMemberLeft(ChatMember):
2643
2748
 
2644
2749
 
2645
2750
  class ChatMemberBanned(ChatMember):
2646
- """Object `ChatMemberBanned`, see the [documentation](https://core.telegram.org/bots/api#chatmemberbanned)
2751
+ """Object `ChatMemberBanned`, see the [documentation](https://core.telegram.org/bots/api#chatmemberbanned).
2647
2752
 
2648
2753
  Represents a chat member that was banned in the chat and can't return to the chat or view chat messages.
2649
2754
  """
@@ -2660,7 +2765,7 @@ class ChatMemberBanned(ChatMember):
2660
2765
 
2661
2766
 
2662
2767
  class ChatJoinRequest(Model):
2663
- """Object `ChatJoinRequest`, see the [documentation](https://core.telegram.org/bots/api#chatjoinrequest)
2768
+ """Object `ChatJoinRequest`, see the [documentation](https://core.telegram.org/bots/api#chatjoinrequest).
2664
2769
 
2665
2770
  Represents a join request sent to a chat.
2666
2771
  """
@@ -2691,7 +2796,7 @@ class ChatJoinRequest(Model):
2691
2796
 
2692
2797
 
2693
2798
  class ChatPermissions(Model):
2694
- """Object `ChatPermissions`, see the [documentation](https://core.telegram.org/bots/api#chatpermissions)
2799
+ """Object `ChatPermissions`, see the [documentation](https://core.telegram.org/bots/api#chatpermissions).
2695
2800
 
2696
2801
  Describes actions that a non-administrator user is allowed to take in a chat.
2697
2802
  """
@@ -2744,8 +2849,98 @@ class ChatPermissions(Model):
2744
2849
  defaults to the value of can_pin_messages."""
2745
2850
 
2746
2851
 
2852
+ class Birthdate(Model):
2853
+ """Object `Birthdate`, see the [documentation](https://core.telegram.org/bots/api#birthdate).
2854
+
2855
+ No description yet.
2856
+ """
2857
+
2858
+ day: int
2859
+ """Day of the user's birth; 1-31."""
2860
+
2861
+ month: int
2862
+ """Month of the user's birth; 1-12."""
2863
+
2864
+ year: Option[int] = Nothing
2865
+ """Optional. Year of the user's birth."""
2866
+
2867
+ @property
2868
+ def is_birthday(self) -> bool:
2869
+ """True, if today is a user's birthday."""
2870
+
2871
+ now = datetime.now()
2872
+ return now.month == self.month and now.day == self.day
2873
+
2874
+ @property
2875
+ def age(self) -> Option[int]:
2876
+ """Optional. Contains the user's age, if the user has a birth year specified."""
2877
+
2878
+ return self.year.map(
2879
+ lambda year: (
2880
+ (datetime.now() - datetime(year, self.month, self.day)) // 365
2881
+ ).days
2882
+ )
2883
+
2884
+
2885
+ class BusinessIntro(Model):
2886
+ """Object `BusinessIntro`, see the [documentation](https://core.telegram.org/bots/api#businessintro).
2887
+
2888
+ No description yet.
2889
+ """
2890
+
2891
+ title: Option[str] = Nothing
2892
+ """Optional. Title text of the business intro."""
2893
+
2894
+ message: Option[str] = Nothing
2895
+ """Optional. Message text of the business intro."""
2896
+
2897
+ sticker: Option["Sticker"] = Nothing
2898
+ """Optional. Sticker of the business intro."""
2899
+
2900
+
2901
+ class BusinessLocation(Model):
2902
+ """Object `BusinessLocation`, see the [documentation](https://core.telegram.org/bots/api#businesslocation).
2903
+
2904
+ No description yet.
2905
+ """
2906
+
2907
+ address: str
2908
+ """Address of the business."""
2909
+
2910
+ location: Option["Location"] = Nothing
2911
+ """Optional. Location of the business."""
2912
+
2913
+
2914
+ class BusinessOpeningHoursInterval(Model):
2915
+ """Object `BusinessOpeningHoursInterval`, see the [documentation](https://core.telegram.org/bots/api#businessopeninghoursinterval).
2916
+
2917
+ No description yet.
2918
+ """
2919
+
2920
+ opening_minute: int
2921
+ """The minute's sequence number in a week, starting on Monday, marking the
2922
+ start of the time interval during which the business is open; 0 - 7 * 24 * 60."""
2923
+
2924
+ closing_minute: int
2925
+ """The minute's sequence number in a week, starting on Monday, marking the
2926
+ end of the time interval during which the business is open; 0 - 8 * 24 * 60."""
2927
+
2928
+
2929
+ class BusinessOpeningHours(Model):
2930
+ """Object `BusinessOpeningHours`, see the [documentation](https://core.telegram.org/bots/api#businessopeninghours).
2931
+
2932
+ No description yet.
2933
+ """
2934
+
2935
+ time_zone_name: str
2936
+ """Unique name of the time zone for which the opening hours are defined."""
2937
+
2938
+ opening_hours: list["BusinessOpeningHoursInterval"]
2939
+ """List of time intervals describing business opening hours."""
2940
+
2941
+
2747
2942
  class ChatLocation(Model):
2748
- """Object `ChatLocation`, see the [documentation](https://core.telegram.org/bots/api#chatlocation)
2943
+ """Object `ChatLocation`, see the [documentation](https://core.telegram.org/bots/api#chatlocation).
2749
2944
 
2750
2945
  Represents a location to which a chat is connected.
2751
2946
  """
@@ -2758,7 +2953,7 @@ class ChatLocation(Model):
2758
2953
 
2759
2954
 
2760
2955
  class ReactionTypeEmoji(ReactionType):
2761
- """Object `ReactionTypeEmoji`, see the [documentation](https://core.telegram.org/bots/api#reactiontypeemoji)
2956
+ """Object `ReactionTypeEmoji`, see the [documentation](https://core.telegram.org/bots/api#reactiontypeemoji).
2762
2957
 
2763
2958
  The reaction is based on an emoji.
2764
2959
  """
@@ -2776,7 +2971,7 @@ class ReactionTypeEmoji(ReactionType):
2776
2971
 
2777
2972
 
2778
2973
  class ReactionTypeCustomEmoji(ReactionType):
2779
- """Object `ReactionTypeCustomEmoji`, see the [documentation](https://core.telegram.org/bots/api#reactiontypecustomemoji)
2974
+ """Object `ReactionTypeCustomEmoji`, see the [documentation](https://core.telegram.org/bots/api#reactiontypecustomemoji).
2780
2975
 
2781
2976
  The reaction is based on a custom emoji.
2782
2977
  """
@@ -2789,7 +2984,7 @@ class ReactionTypeCustomEmoji(ReactionType):
2789
2984
 
2790
2985
 
2791
2986
  class ReactionCount(Model):
2792
- """Object `ReactionCount`, see the [documentation](https://core.telegram.org/bots/api#reactioncount)
2987
+ """Object `ReactionCount`, see the [documentation](https://core.telegram.org/bots/api#reactioncount).
2793
2988
 
2794
2989
  Represents a reaction added to a message along with the number of times it was added.
2795
2990
  """
@@ -2802,7 +2997,7 @@ class ReactionCount(Model):
2802
2997
 
2803
2998
 
2804
2999
  class MessageReactionUpdated(Model):
2805
- """Object `MessageReactionUpdated`, see the [documentation](https://core.telegram.org/bots/api#messagereactionupdated)
3000
+ """Object `MessageReactionUpdated`, see the [documentation](https://core.telegram.org/bots/api#messagereactionupdated).
2806
3001
 
2807
3002
  This object represents a change of a reaction on a message performed by a user.
2808
3003
  """
@@ -2831,7 +3026,7 @@ class MessageReactionUpdated(Model):
2831
3026
 
2832
3027
 
2833
3028
  class MessageReactionCountUpdated(Model):
2834
- """Object `MessageReactionCountUpdated`, see the [documentation](https://core.telegram.org/bots/api#messagereactioncountupdated)
3029
+ """Object `MessageReactionCountUpdated`, see the [documentation](https://core.telegram.org/bots/api#messagereactioncountupdated).
2835
3030
 
2836
3031
  This object represents reaction changes on a message with anonymous reactions.
2837
3032
  """
@@ -2850,7 +3045,7 @@ class MessageReactionCountUpdated(Model):
2850
3045
 
2851
3046
 
2852
3047
  class ForumTopic(Model):
2853
- """Object `ForumTopic`, see the [documentation](https://core.telegram.org/bots/api#forumtopic)
3048
+ """Object `ForumTopic`, see the [documentation](https://core.telegram.org/bots/api#forumtopic).
2854
3049
 
2855
3050
  This object represents a forum topic.
2856
3051
  """
@@ -2869,7 +3064,7 @@ class ForumTopic(Model):
2869
3064
 
2870
3065
 
2871
3066
  class BotCommand(Model):
2872
- """Object `BotCommand`, see the [documentation](https://core.telegram.org/bots/api#botcommand)
3067
+ """Object `BotCommand`, see the [documentation](https://core.telegram.org/bots/api#botcommand).
2873
3068
 
2874
3069
  This object represents a bot command.
2875
3070
  """
@@ -2883,7 +3078,7 @@ class BotCommand(Model):
2883
3078
 
2884
3079
 
2885
3080
  class BotCommandScopeDefault(BotCommandScope):
2886
- """Object `BotCommandScopeDefault`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopedefault)
3081
+ """Object `BotCommandScopeDefault`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopedefault).
2887
3082
 
2888
3083
  Represents the default scope of bot commands. Default commands are used if no commands with a narrower scope are specified for the user.
2889
3084
  """
@@ -2893,7 +3088,7 @@ class BotCommandScopeDefault(BotCommandScope):
2893
3088
 
2894
3089
 
2895
3090
  class BotCommandScopeAllPrivateChats(BotCommandScope):
2896
- """Object `BotCommandScopeAllPrivateChats`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopeallprivatechats)
3091
+ """Object `BotCommandScopeAllPrivateChats`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopeallprivatechats).
2897
3092
 
2898
3093
  Represents the scope of bot commands, covering all private chats.
2899
3094
  """
@@ -2903,7 +3098,7 @@ class BotCommandScopeAllPrivateChats(BotCommandScope):
2903
3098
 
2904
3099
 
2905
3100
  class BotCommandScopeAllGroupChats(BotCommandScope):
2906
- """Object `BotCommandScopeAllGroupChats`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopeallgroupchats)
3101
+ """Object `BotCommandScopeAllGroupChats`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopeallgroupchats).
2907
3102
 
2908
3103
  Represents the scope of bot commands, covering all group and supergroup chats.
2909
3104
  """
@@ -2913,7 +3108,7 @@ class BotCommandScopeAllGroupChats(BotCommandScope):
2913
3108
 
2914
3109
 
2915
3110
  class BotCommandScopeAllChatAdministrators(BotCommandScope):
2916
- """Object `BotCommandScopeAllChatAdministrators`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopeallchatadministrators)
3111
+ """Object `BotCommandScopeAllChatAdministrators`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopeallchatadministrators).
2917
3112
 
2918
3113
  Represents the scope of bot commands, covering all group and supergroup chat administrators.
2919
3114
  """
@@ -2923,7 +3118,7 @@ class BotCommandScopeAllChatAdministrators(BotCommandScope):
2923
3118
 
2924
3119
 
2925
3120
  class BotCommandScopeChat(BotCommandScope):
2926
- """Object `BotCommandScopeChat`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopechat)
3121
+ """Object `BotCommandScopeChat`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopechat).
2927
3122
 
2928
3123
  Represents the scope of bot commands, covering a specific chat.
2929
3124
  """
@@ -2937,7 +3132,7 @@ class BotCommandScopeChat(BotCommandScope):
2937
3132
 
2938
3133
 
2939
3134
  class BotCommandScopeChatAdministrators(BotCommandScope):
2940
- """Object `BotCommandScopeChatAdministrators`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopechatadministrators)
3135
+ """Object `BotCommandScopeChatAdministrators`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopechatadministrators).
2941
3136
 
2942
3137
  Represents the scope of bot commands, covering all administrators of a specific group or supergroup chat.
2943
3138
  """
@@ -2951,7 +3146,7 @@ class BotCommandScopeChatAdministrators(BotCommandScope):
2951
3146
 
2952
3147
 
2953
3148
  class BotCommandScopeChatMember(BotCommandScope):
2954
- """Object `BotCommandScopeChatMember`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopechatmember)
3149
+ """Object `BotCommandScopeChatMember`, see the [documentation](https://core.telegram.org/bots/api#botcommandscopechatmember).
2955
3150
 
2956
3151
  Represents the scope of bot commands, covering a specific member of a group or supergroup chat.
2957
3152
  """
@@ -2968,7 +3163,7 @@ class BotCommandScopeChatMember(BotCommandScope):
2968
3163
 
2969
3164
 
2970
3165
  class BotName(Model):
2971
- """Object `BotName`, see the [documentation](https://core.telegram.org/bots/api#botname)
3166
+ """Object `BotName`, see the [documentation](https://core.telegram.org/bots/api#botname).
2972
3167
 
2973
3168
  This object represents the bot's name.
2974
3169
  """
@@ -2978,7 +3173,7 @@ class BotName(Model):
2978
3173
 
2979
3174
 
2980
3175
  class BotDescription(Model):
2981
- """Object `BotDescription`, see the [documentation](https://core.telegram.org/bots/api#botdescription)
3176
+ """Object `BotDescription`, see the [documentation](https://core.telegram.org/bots/api#botdescription).
2982
3177
 
2983
3178
  This object represents the bot's description.
2984
3179
  """
@@ -2988,7 +3183,7 @@ class BotDescription(Model):
2988
3183
 
2989
3184
 
2990
3185
  class BotShortDescription(Model):
2991
- """Object `BotShortDescription`, see the [documentation](https://core.telegram.org/bots/api#botshortdescription)
3186
+ """Object `BotShortDescription`, see the [documentation](https://core.telegram.org/bots/api#botshortdescription).
2992
3187
 
2993
3188
  This object represents the bot's short description.
2994
3189
  """
@@ -2998,7 +3193,7 @@ class BotShortDescription(Model):
2998
3193
 
2999
3194
 
3000
3195
  class MenuButtonCommands(MenuButton):
3001
- """Object `MenuButtonCommands`, see the [documentation](https://core.telegram.org/bots/api#menubuttoncommands)
3196
+ """Object `MenuButtonCommands`, see the [documentation](https://core.telegram.org/bots/api#menubuttoncommands).
3002
3197
 
3003
3198
  Represents a menu button, which opens the bot's list of commands.
3004
3199
  """
@@ -3008,7 +3203,7 @@ class MenuButtonCommands(MenuButton):
3008
3203
 
3009
3204
 
3010
3205
  class MenuButtonWebApp(MenuButton):
3011
- """Object `MenuButtonWebApp`, see the [documentation](https://core.telegram.org/bots/api#menubuttonwebapp)
3206
+ """Object `MenuButtonWebApp`, see the [documentation](https://core.telegram.org/bots/api#menubuttonwebapp).
3012
3207
 
3013
3208
  Represents a menu button, which launches a Web App.
3014
3209
  """
@@ -3026,7 +3221,7 @@ class MenuButtonWebApp(MenuButton):
3026
3221
 
3027
3222
 
3028
3223
  class MenuButtonDefault(MenuButton):
3029
- """Object `MenuButtonDefault`, see the [documentation](https://core.telegram.org/bots/api#menubuttondefault)
3224
+ """Object `MenuButtonDefault`, see the [documentation](https://core.telegram.org/bots/api#menubuttondefault).
3030
3225
 
3031
3226
  Describes that no specific value for the menu button was set.
3032
3227
  """
@@ -3036,7 +3231,7 @@ class MenuButtonDefault(MenuButton):
3036
3231
 
3037
3232
 
3038
3233
  class ChatBoostSourcePremium(ChatBoostSource):
3039
- """Object `ChatBoostSourcePremium`, see the [documentation](https://core.telegram.org/bots/api#chatboostsourcepremium)
3234
+ """Object `ChatBoostSourcePremium`, see the [documentation](https://core.telegram.org/bots/api#chatboostsourcepremium).
3040
3235
 
3041
3236
  The boost was obtained by subscribing to Telegram Premium or by gifting a Telegram Premium subscription to another user.
3042
3237
  """
@@ -3049,7 +3244,7 @@ class ChatBoostSourcePremium(ChatBoostSource):
3049
3244
 
3050
3245
 
3051
3246
  class ChatBoostSourceGiftCode(ChatBoostSource):
3052
- """Object `ChatBoostSourceGiftCode`, see the [documentation](https://core.telegram.org/bots/api#chatboostsourcegiftcode)
3247
+ """Object `ChatBoostSourceGiftCode`, see the [documentation](https://core.telegram.org/bots/api#chatboostsourcegiftcode).
3053
3248
 
3054
3249
  The boost was obtained by the creation of Telegram Premium gift codes to boost a chat. Each such code boosts the chat 4 times for the duration of the corresponding Telegram Premium subscription.
3055
3250
  """
@@ -3062,7 +3257,7 @@ class ChatBoostSourceGiftCode(ChatBoostSource):
3062
3257
 
3063
3258
 
3064
3259
  class ChatBoostSourceGiveaway(ChatBoostSource):
3065
- """Object `ChatBoostSourceGiveaway`, see the [documentation](https://core.telegram.org/bots/api#chatboostsourcegiveaway)
3260
+ """Object `ChatBoostSourceGiveaway`, see the [documentation](https://core.telegram.org/bots/api#chatboostsourcegiveaway).
3066
3261
 
3067
3262
  The boost was obtained by the creation of a Telegram Premium giveaway. This boosts the chat 4 times for the duration of the corresponding Telegram Premium subscription.
3068
3263
  """
@@ -3083,7 +3278,7 @@ class ChatBoostSourceGiveaway(ChatBoostSource):
3083
3278
 
3084
3279
 
3085
3280
  class ChatBoost(Model):
3086
- """Object `ChatBoost`, see the [documentation](https://core.telegram.org/bots/api#chatboost)
3281
+ """Object `ChatBoost`, see the [documentation](https://core.telegram.org/bots/api#chatboost).
3087
3282
 
3088
3283
  This object contains information about a chat boost.
3089
3284
  """
@@ -3105,7 +3300,7 @@ class ChatBoost(Model):
3105
3300
 
3106
3301
 
3107
3302
  class ChatBoostUpdated(Model):
3108
- """Object `ChatBoostUpdated`, see the [documentation](https://core.telegram.org/bots/api#chatboostupdated)
3303
+ """Object `ChatBoostUpdated`, see the [documentation](https://core.telegram.org/bots/api#chatboostupdated).
3109
3304
 
3110
3305
  This object represents a boost added to a chat or changed.
3111
3306
  """
@@ -3118,7 +3313,7 @@ class ChatBoostUpdated(Model):
3118
3313
 
3119
3314
 
3120
3315
  class ChatBoostRemoved(Model):
3121
- """Object `ChatBoostRemoved`, see the [documentation](https://core.telegram.org/bots/api#chatboostremoved)
3316
+ """Object `ChatBoostRemoved`, see the [documentation](https://core.telegram.org/bots/api#chatboostremoved).
3122
3317
 
3123
3318
  This object represents a boost removed from a chat.
3124
3319
  """
@@ -3139,7 +3334,7 @@ class ChatBoostRemoved(Model):
3139
3334
 
3140
3335
 
3141
3336
  class UserChatBoosts(Model):
3142
- """Object `UserChatBoosts`, see the [documentation](https://core.telegram.org/bots/api#userchatboosts)
3337
+ """Object `UserChatBoosts`, see the [documentation](https://core.telegram.org/bots/api#userchatboosts).
3143
3338
 
3144
3339
  This object represents a list of boosts added to a chat by a user.
3145
3340
  """
@@ -3148,8 +3343,56 @@ class UserChatBoosts(Model):
3148
3343
  """The list of boosts added to the chat by the user."""
3149
3344
 
3150
3345
 
3346
+ class BusinessConnection(Model):
3347
+ """Object `BusinessConnection`, see the [documentation](https://core.telegram.org/bots/api#businessconnection).
3348
+
3349
+ Describes the connection of the bot with a business account.
3350
+ """
3351
+
3352
+ id: str
3353
+ """Unique identifier of the business connection."""
3354
+
3355
+ user: "User"
3356
+ """Business account user that created the business connection."""
3357
+
3358
+ user_chat_id: int
3359
+ """Identifier of a private chat with the user who created the business connection.
3360
+ This number may have more than 32 significant bits and some programming
3361
+ languages may have difficulty/silent defects in interpreting it. But
3362
+ it has at most 52 significant bits, so a 64-bit integer or double-precision
3363
+ float type are safe for storing this identifier."""
3364
+
3365
+ date: datetime
3366
+ """Date the connection was established in Unix time."""
3367
+
3368
+ can_reply: bool
3369
+ """True, if the bot can act on behalf of the business account in chats that were
3370
+ active in the last 24 hours."""
3371
+
3372
+ is_enabled: bool
3373
+ """True, if the connection is active."""
3374
+
3375
+
3376
+ class BusinessMessagesDeleted(Model):
3377
+ """Object `BusinessMessagesDeleted`, see the [documentation](https://core.telegram.org/bots/api#businessmessagesdeleted).
3378
+
3379
+ This object is received when messages are deleted from a connected business account.
3380
+ """
3381
+
3382
+ business_connection_id: str
3383
+ """Unique identifier of the business connection."""
3384
+
3385
+ chat: "Chat"
3386
+ """Information about a chat in the business account. The bot may not have access
3387
+ to the chat or the corresponding user."""
3388
+
3389
+ message_ids: list[int]
3390
+ """A JSON-serialized list of identifiers of deleted messages in the chat of
3391
+ the business account."""
3392
+
3393
+
3151
3394
  class ResponseParameters(Model):
3152
- """Object `ResponseParameters`, see the [documentation](https://core.telegram.org/bots/api#responseparameters)
3395
+ """Object `ResponseParameters`, see the [documentation](https://core.telegram.org/bots/api#responseparameters).
3153
3396
 
3154
3397
  Describes why a request was unsuccessful.
3155
3398
  """
@@ -3167,7 +3410,7 @@ class ResponseParameters(Model):
3167
3410
 
3168
3411
 
3169
3412
  class InputMediaPhoto(InputMedia):
3170
- """Object `InputMediaPhoto`, see the [documentation](https://core.telegram.org/bots/api#inputmediaphoto)
3413
+ """Object `InputMediaPhoto`, see the [documentation](https://core.telegram.org/bots/api#inputmediaphoto).
3171
3414
 
3172
3415
  Represents a photo to be sent.
3173
3416
  """
@@ -3198,7 +3441,7 @@ class InputMediaPhoto(InputMedia):
3198
3441
 
3199
3442
 
3200
3443
  class InputMediaVideo(InputMedia):
3201
- """Object `InputMediaVideo`, see the [documentation](https://core.telegram.org/bots/api#inputmediavideo)
3444
+ """Object `InputMediaVideo`, see the [documentation](https://core.telegram.org/bots/api#inputmediavideo).
3202
3445
 
3203
3446
  Represents a video to be sent.
3204
3447
  """
@@ -3250,7 +3493,7 @@ class InputMediaVideo(InputMedia):
3250
3493
 
3251
3494
 
3252
3495
  class InputMediaAnimation(InputMedia):
3253
- """Object `InputMediaAnimation`, see the [documentation](https://core.telegram.org/bots/api#inputmediaanimation)
3496
+ """Object `InputMediaAnimation`, see the [documentation](https://core.telegram.org/bots/api#inputmediaanimation).
3254
3497
 
3255
3498
  Represents an animation file (GIF or H.264/MPEG-4 AVC video without sound) to be sent.
3256
3499
  """
@@ -3299,7 +3542,7 @@ class InputMediaAnimation(InputMedia):
3299
3542
 
3300
3543
 
3301
3544
  class InputMediaAudio(InputMedia):
3302
- """Object `InputMediaAudio`, see the [documentation](https://core.telegram.org/bots/api#inputmediaaudio)
3545
+ """Object `InputMediaAudio`, see the [documentation](https://core.telegram.org/bots/api#inputmediaaudio).
3303
3546
 
3304
3547
  Represents an audio file to be treated as music to be sent.
3305
3548
  """
@@ -3345,7 +3588,7 @@ class InputMediaAudio(InputMedia):
3345
3588
 
3346
3589
 
3347
3590
  class InputMediaDocument(InputMedia):
3348
- """Object `InputMediaDocument`, see the [documentation](https://core.telegram.org/bots/api#inputmediadocument)
3591
+ """Object `InputMediaDocument`, see the [documentation](https://core.telegram.org/bots/api#inputmediadocument).
3349
3592
 
3350
3593
  Represents a general file to be sent.
3351
3594
  """
@@ -3387,7 +3630,7 @@ class InputMediaDocument(InputMedia):
3387
3630
 
3388
3631
 
3389
3632
  class InputFile(typing.NamedTuple):
3390
- """NamedTuple object `InputFile`, see the [documentation](https://core.telegram.org/bots/api#inputfile)
3633
+ """NamedTuple object `InputFile`, see the [documentation](https://core.telegram.org/bots/api#inputfile).
3391
3634
 
3392
3635
  This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser.
3393
3636
  """
@@ -3400,7 +3643,7 @@ class InputFile(typing.NamedTuple):
3400
3643
 
3401
3644
 
3402
3645
  class Sticker(Model):
3403
- """Object `Sticker`, see the [documentation](https://core.telegram.org/bots/api#sticker)
3646
+ """Object `Sticker`, see the [documentation](https://core.telegram.org/bots/api#sticker).
3404
3647
 
3405
3648
  This object represents a sticker.
3406
3649
  """
@@ -3457,7 +3700,7 @@ class Sticker(Model):
3457
3700
 
3458
3701
 
3459
3702
  class StickerSet(Model):
3460
- """Object `StickerSet`, see the [documentation](https://core.telegram.org/bots/api#stickerset)
3703
+ """Object `StickerSet`, see the [documentation](https://core.telegram.org/bots/api#stickerset).
3461
3704
 
3462
3705
  This object represents a sticker set.
3463
3706
  """
@@ -3471,12 +3714,6 @@ class StickerSet(Model):
3471
3714
  sticker_type: typing.Literal["regular", "mask", "custom_emoji"]
3472
3715
  """Type of stickers in the set, currently one of `regular`, `mask`, `custom_emoji`."""
3473
3716
 
3474
- is_animated: bool
3475
- """True, if the sticker set contains animated stickers."""
3476
-
3477
- is_video: bool
3478
- """True, if the sticker set contains video stickers."""
3479
-
3480
3717
  stickers: list["Sticker"]
3481
3718
  """List of all set stickers."""
3482
3719
 
@@ -3485,7 +3722,7 @@ class StickerSet(Model):
3485
3722
 
3486
3723
 
3487
3724
  class MaskPosition(Model):
3488
- """Object `MaskPosition`, see the [documentation](https://core.telegram.org/bots/api#maskposition)
3725
+ """Object `MaskPosition`, see the [documentation](https://core.telegram.org/bots/api#maskposition).
3489
3726
 
3490
3727
  This object describes the position on faces where a mask should be placed by default.
3491
3728
  """
@@ -3509,7 +3746,7 @@ class MaskPosition(Model):
3509
3746
 
3510
3747
 
3511
3748
  class InputSticker(Model):
3512
- """Object `InputSticker`, see the [documentation](https://core.telegram.org/bots/api#inputsticker)
3749
+ """Object `InputSticker`, see the [documentation](https://core.telegram.org/bots/api#inputsticker).
3513
3750
 
3514
3751
  This object describes a sticker to be added to a sticker set.
3515
3752
  """
@@ -3522,6 +3759,10 @@ class InputSticker(Model):
3522
3759
  under <file_attach_name> name. Animated and video stickers can't be uploaded
3523
3760
  via HTTP URL. More information on Sending Files: https://core.telegram.org/bots/api#sending-files."""
3524
3761
 
3762
+ format: str
3763
+ """Format of the added sticker, must be one of `static` for a .WEBP or .PNG image,
3764
+ `animated` for a .TGS animation, `video` for a WEBM video."""
3765
+
3525
3766
  emoji_list: list[str]
3526
3767
  """List of 1-20 emoji associated with the sticker."""
3527
3768
 
@@ -3535,7 +3776,7 @@ class InputSticker(Model):
3535
3776
 
3536
3777
 
3537
3778
  class InlineQuery(Model):
3538
- """Object `InlineQuery`, see the [documentation](https://core.telegram.org/bots/api#inlinequery)
3779
+ """Object `InlineQuery`, see the [documentation](https://core.telegram.org/bots/api#inlinequery).
3539
3780
 
3540
3781
  This object represents an incoming inline query. When the user sends an empty query, your bot could return some default or trending results.
3541
3782
  """
@@ -3564,7 +3805,7 @@ class InlineQuery(Model):
3564
3805
 
3565
3806
 
3566
3807
  class InlineQueryResultsButton(Model):
3567
- """Object `InlineQueryResultsButton`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultsbutton)
3808
+ """Object `InlineQueryResultsButton`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultsbutton).
3568
3809
 
3569
3810
  This object represents a button to be shown above inline query results. You must use exactly one of the optional fields.
3570
3811
  """
@@ -3591,7 +3832,7 @@ class InlineQueryResultsButton(Model):
3591
3832
 
3592
3833
 
3593
3834
  class InlineQueryResultArticle(InlineQueryResult):
3594
- """Object `InlineQueryResultArticle`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultarticle)
3835
+ """Object `InlineQueryResultArticle`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultarticle).
3595
3836
 
3596
3837
  Represents a link to an article or web page.
3597
3838
  """
@@ -3637,7 +3878,7 @@ class InlineQueryResultArticle(InlineQueryResult):
3637
3878
 
3638
3879
 
3639
3880
  class InlineQueryResultPhoto(InlineQueryResult):
3640
- """Object `InlineQueryResultPhoto`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultphoto)
3881
+ """Object `InlineQueryResultPhoto`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultphoto).
3641
3882
 
3642
3883
  Represents a link to a photo. By default, this photo will be sent by the user with optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the photo.
3643
3884
  """
@@ -3695,7 +3936,7 @@ class InlineQueryResultPhoto(InlineQueryResult):
3695
3936
 
3696
3937
 
3697
3938
  class InlineQueryResultGif(InlineQueryResult):
3698
- """Object `InlineQueryResultGif`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultgif)
3939
+ """Object `InlineQueryResultGif`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultgif).
3699
3940
 
3700
3941
  Represents a link to an animated GIF file. By default, this animated GIF file will be sent by the user with optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the animation.
3701
3942
  """
@@ -3758,7 +3999,7 @@ class InlineQueryResultGif(InlineQueryResult):
3758
3999
 
3759
4000
 
3760
4001
  class InlineQueryResultMpeg4Gif(InlineQueryResult):
3761
- """Object `InlineQueryResultMpeg4Gif`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultmpeg4gif)
4002
+ """Object `InlineQueryResultMpeg4Gif`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultmpeg4gif).
3762
4003
 
3763
4004
  Represents a link to a video animation (H.264/MPEG-4 AVC video without sound). By default, this animated MPEG-4 file will be sent by the user with optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the animation.
3764
4005
  """
@@ -3821,7 +4062,7 @@ class InlineQueryResultMpeg4Gif(InlineQueryResult):
3821
4062
 
3822
4063
 
3823
4064
  class InlineQueryResultVideo(InlineQueryResult):
3824
- """Object `InlineQueryResultVideo`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultvideo)
4065
+ """Object `InlineQueryResultVideo`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultvideo).
3825
4066
 
3826
4067
  Represents a link to a page containing an embedded video player or a video file. By default, this video file will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the video.
3827
4068
  """
@@ -3886,7 +4127,7 @@ class InlineQueryResultVideo(InlineQueryResult):
3886
4127
 
3887
4128
 
3888
4129
  class InlineQueryResultAudio(InlineQueryResult):
3889
- """Object `InlineQueryResultAudio`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultaudio)
4130
+ """Object `InlineQueryResultAudio`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultaudio).
3890
4131
 
3891
4132
  Represents a link to an MP3 audio file. By default, this audio file will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the audio.
3892
4133
  """
@@ -3936,7 +4177,7 @@ class InlineQueryResultAudio(InlineQueryResult):
3936
4177
 
3937
4178
 
3938
4179
  class InlineQueryResultVoice(InlineQueryResult):
3939
- """Object `InlineQueryResultVoice`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultvoice)
4180
+ """Object `InlineQueryResultVoice`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultvoice).
3940
4181
 
3941
4182
  Represents a link to a voice recording in an .OGG container encoded with OPUS. By default, this voice recording will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the the voice message.
3942
4183
  """
@@ -3983,7 +4224,7 @@ class InlineQueryResultVoice(InlineQueryResult):
3983
4224
 
3984
4225
 
3985
4226
  class InlineQueryResultDocument(InlineQueryResult):
3986
- """Object `InlineQueryResultDocument`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultdocument)
4227
+ """Object `InlineQueryResultDocument`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultdocument).
3987
4228
 
3988
4229
  Represents a link to a file. By default, this file will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the file. Currently, only .PDF and .ZIP files can be sent using this method.
3989
4230
  """
@@ -4043,7 +4284,7 @@ class InlineQueryResultDocument(InlineQueryResult):
4043
4284
 
4044
4285
 
4045
4286
  class InlineQueryResultLocation(InlineQueryResult):
4046
- """Object `InlineQueryResultLocation`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultlocation)
4287
+ """Object `InlineQueryResultLocation`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultlocation).
4047
4288
 
4048
4289
  Represents a location on a map. By default, the location will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the location.
4049
4290
  """
@@ -4105,7 +4346,7 @@ class InlineQueryResultLocation(InlineQueryResult):
4105
4346
 
4106
4347
 
4107
4348
  class InlineQueryResultVenue(InlineQueryResult):
4108
- """Object `InlineQueryResultVenue`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultvenue)
4349
+ """Object `InlineQueryResultVenue`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultvenue).
4109
4350
 
4110
4351
  Represents a venue. By default, the venue will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the venue.
4111
4352
  """
@@ -4166,7 +4407,7 @@ class InlineQueryResultVenue(InlineQueryResult):
4166
4407
 
4167
4408
 
4168
4409
  class InlineQueryResultContact(InlineQueryResult):
4169
- """Object `InlineQueryResultContact`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcontact)
4410
+ """Object `InlineQueryResultContact`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcontact).
4170
4411
 
4171
4412
  Represents a contact with a phone number. By default, this contact will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the contact.
4172
4413
  """
@@ -4215,7 +4456,7 @@ class InlineQueryResultContact(InlineQueryResult):
4215
4456
 
4216
4457
 
4217
4458
  class InlineQueryResultGame(InlineQueryResult):
4218
- """Object `InlineQueryResultGame`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultgame)
4459
+ """Object `InlineQueryResultGame`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultgame).
4219
4460
 
4220
4461
  Represents a Game.
4221
4462
  """
@@ -4234,7 +4475,7 @@ class InlineQueryResultGame(InlineQueryResult):
4234
4475
 
4235
4476
 
4236
4477
  class InlineQueryResultCachedPhoto(InlineQueryResult):
4237
- """Object `InlineQueryResultCachedPhoto`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedphoto)
4478
+ """Object `InlineQueryResultCachedPhoto`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedphoto).
4238
4479
 
4239
4480
  Represents a link to a photo stored on the Telegram servers. By default, this photo will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the photo.
4240
4481
  """
@@ -4282,7 +4523,7 @@ class InlineQueryResultCachedPhoto(InlineQueryResult):
4282
4523
 
4283
4524
 
4284
4525
  class InlineQueryResultCachedGif(InlineQueryResult):
4285
- """Object `InlineQueryResultCachedGif`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedgif)
4526
+ """Object `InlineQueryResultCachedGif`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedgif).
4286
4527
 
4287
4528
  Represents a link to an animated GIF file stored on the Telegram servers. By default, this animated GIF file will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with specified content instead of the animation.
4288
4529
  """
@@ -4327,7 +4568,7 @@ class InlineQueryResultCachedGif(InlineQueryResult):
4327
4568
 
4328
4569
 
4329
4570
  class InlineQueryResultCachedMpeg4Gif(InlineQueryResult):
4330
- """Object `InlineQueryResultCachedMpeg4Gif`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedmpeg4gif)
4571
+ """Object `InlineQueryResultCachedMpeg4Gif`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedmpeg4gif).
4331
4572
 
4332
4573
  Represents a link to a video animation (H.264/MPEG-4 AVC video without sound) stored on the Telegram servers. By default, this animated MPEG-4 file will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the animation.
4333
4574
  """
@@ -4372,7 +4613,7 @@ class InlineQueryResultCachedMpeg4Gif(InlineQueryResult):
4372
4613
 
4373
4614
 
4374
4615
  class InlineQueryResultCachedSticker(InlineQueryResult):
4375
- """Object `InlineQueryResultCachedSticker`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedsticker)
4616
+ """Object `InlineQueryResultCachedSticker`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedsticker).
4376
4617
 
4377
4618
  Represents a link to a sticker stored on the Telegram servers. By default, this sticker will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the sticker.
4378
4619
  """
@@ -4402,7 +4643,7 @@ class InlineQueryResultCachedSticker(InlineQueryResult):
4402
4643
 
4403
4644
 
4404
4645
  class InlineQueryResultCachedDocument(InlineQueryResult):
4405
- """Object `InlineQueryResultCachedDocument`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcacheddocument)
4646
+ """Object `InlineQueryResultCachedDocument`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcacheddocument).
4406
4647
 
4407
4648
  Represents a link to a file stored on the Telegram servers. By default, this file will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the file.
4408
4649
  """
@@ -4450,7 +4691,7 @@ class InlineQueryResultCachedDocument(InlineQueryResult):
4450
4691
 
4451
4692
 
4452
4693
  class InlineQueryResultCachedVideo(InlineQueryResult):
4453
- """Object `InlineQueryResultCachedVideo`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedvideo)
4694
+ """Object `InlineQueryResultCachedVideo`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedvideo).
4454
4695
 
4455
4696
  Represents a link to a video file stored on the Telegram servers. By default, this video file will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the video.
4456
4697
  """
@@ -4498,7 +4739,7 @@ class InlineQueryResultCachedVideo(InlineQueryResult):
4498
4739
 
4499
4740
 
4500
4741
  class InlineQueryResultCachedVoice(InlineQueryResult):
4501
- """Object `InlineQueryResultCachedVoice`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedvoice)
4742
+ """Object `InlineQueryResultCachedVoice`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedvoice).
4502
4743
 
4503
4744
  Represents a link to a voice message stored on the Telegram servers. By default, this voice message will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the voice message.
4504
4745
  """
@@ -4542,7 +4783,7 @@ class InlineQueryResultCachedVoice(InlineQueryResult):
4542
4783
 
4543
4784
 
4544
4785
  class InlineQueryResultCachedAudio(InlineQueryResult):
4545
- """Object `InlineQueryResultCachedAudio`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedaudio)
4786
+ """Object `InlineQueryResultCachedAudio`, see the [documentation](https://core.telegram.org/bots/api#inlinequeryresultcachedaudio).
4546
4787
 
4547
4788
  Represents a link to an MP3 audio file stored on the Telegram servers. By default, this audio file will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the audio.
4548
4789
  """
@@ -4583,7 +4824,7 @@ class InlineQueryResultCachedAudio(InlineQueryResult):
4583
4824
 
4584
4825
 
4585
4826
  class InputTextMessageContent(InputMessageContent):
4586
- """Object `InputTextMessageContent`, see the [documentation](https://core.telegram.org/bots/api#inputtextmessagecontent)
4827
+ """Object `InputTextMessageContent`, see the [documentation](https://core.telegram.org/bots/api#inputtextmessagecontent).
4587
4828
 
4588
4829
  Represents the content of a text message to be sent as the result of an inline query.
4589
4830
  """
@@ -4604,7 +4845,7 @@ class InputTextMessageContent(InputMessageContent):
4604
4845
 
4605
4846
 
4606
4847
  class InputLocationMessageContent(InputMessageContent):
4607
- """Object `InputLocationMessageContent`, see the [documentation](https://core.telegram.org/bots/api#inputlocationmessagecontent)
4848
+ """Object `InputLocationMessageContent`, see the [documentation](https://core.telegram.org/bots/api#inputlocationmessagecontent).
4608
4849
 
4609
4850
  Represents the content of a location message to be sent as the result of an inline query.
4610
4851
  """
@@ -4634,7 +4875,7 @@ class InputLocationMessageContent(InputMessageContent):
4634
4875
 
4635
4876
 
4636
4877
  class InputVenueMessageContent(InputMessageContent):
4637
- """Object `InputVenueMessageContent`, see the [documentation](https://core.telegram.org/bots/api#inputvenuemessagecontent)
4878
+ """Object `InputVenueMessageContent`, see the [documentation](https://core.telegram.org/bots/api#inputvenuemessagecontent).
4638
4879
 
4639
4880
  Represents the content of a venue message to be sent as the result of an inline query.
4640
4881
  """
@@ -4666,7 +4907,7 @@ class InputVenueMessageContent(InputMessageContent):
4666
4907
 
4667
4908
 
4668
4909
  class InputContactMessageContent(InputMessageContent):
4669
- """Object `InputContactMessageContent`, see the [documentation](https://core.telegram.org/bots/api#inputcontactmessagecontent)
4910
+ """Object `InputContactMessageContent`, see the [documentation](https://core.telegram.org/bots/api#inputcontactmessagecontent).
4670
4911
 
4671
4912
  Represents the content of a contact message to be sent as the result of an inline query.
4672
4913
  """
@@ -4686,7 +4927,7 @@ class InputContactMessageContent(InputMessageContent):
4686
4927
 
4687
4928
 
4688
4929
  class InputInvoiceMessageContent(InputMessageContent):
4689
- """Object `InputInvoiceMessageContent`, see the [documentation](https://core.telegram.org/bots/api#inputinvoicemessagecontent)
4930
+ """Object `InputInvoiceMessageContent`, see the [documentation](https://core.telegram.org/bots/api#inputinvoicemessagecontent).
4690
4931
 
4691
4932
  Represents the content of an invoice message to be sent as the result of an inline query.
4692
4933
  """
@@ -4768,7 +5009,7 @@ class InputInvoiceMessageContent(InputMessageContent):
4768
5009
 
4769
5010
 
4770
5011
  class ChosenInlineResult(Model):
4771
- """Object `ChosenInlineResult`, see the [documentation](https://core.telegram.org/bots/api#choseninlineresult)
5012
+ """Object `ChosenInlineResult`, see the [documentation](https://core.telegram.org/bots/api#choseninlineresult).
4772
5013
 
4773
5014
  Represents a result of an inline query that was chosen by the user and sent to their chat partner.
4774
5015
  Note: It is necessary to enable inline feedback via @BotFather in order to receive these objects in updates.
@@ -4793,7 +5034,7 @@ class ChosenInlineResult(Model):
4793
5034
 
4794
5035
 
4795
5036
  class SentWebAppMessage(Model):
4796
- """Object `SentWebAppMessage`, see the [documentation](https://core.telegram.org/bots/api#sentwebappmessage)
5037
+ """Object `SentWebAppMessage`, see the [documentation](https://core.telegram.org/bots/api#sentwebappmessage).
4797
5038
 
4798
5039
  Describes an inline message sent by a Web App on behalf of a user.
4799
5040
  """
@@ -4804,7 +5045,7 @@ class SentWebAppMessage(Model):
4804
5045
 
4805
5046
 
4806
5047
  class LabeledPrice(Model):
4807
- """Object `LabeledPrice`, see the [documentation](https://core.telegram.org/bots/api#labeledprice)
5048
+ """Object `LabeledPrice`, see the [documentation](https://core.telegram.org/bots/api#labeledprice).
4808
5049
 
4809
5050
  This object represents a portion of the price for goods or services.
4810
5051
  """
@@ -4820,7 +5061,7 @@ class LabeledPrice(Model):
4820
5061
 
4821
5062
 
4822
5063
  class Invoice(Model):
4823
- """Object `Invoice`, see the [documentation](https://core.telegram.org/bots/api#invoice)
5064
+ """Object `Invoice`, see the [documentation](https://core.telegram.org/bots/api#invoice).
4824
5065
 
4825
5066
  This object contains basic information about an invoice.
4826
5067
  """
@@ -4845,7 +5086,7 @@ class Invoice(Model):
4845
5086
 
4846
5087
 
4847
5088
  class ShippingAddress(Model):
4848
- """Object `ShippingAddress`, see the [documentation](https://core.telegram.org/bots/api#shippingaddress)
5089
+ """Object `ShippingAddress`, see the [documentation](https://core.telegram.org/bots/api#shippingaddress).
4849
5090
 
4850
5091
  This object represents a shipping address.
4851
5092
  """
@@ -4870,7 +5111,7 @@ class ShippingAddress(Model):
4870
5111
 
4871
5112
 
4872
5113
  class OrderInfo(Model):
4873
- """Object `OrderInfo`, see the [documentation](https://core.telegram.org/bots/api#orderinfo)
5114
+ """Object `OrderInfo`, see the [documentation](https://core.telegram.org/bots/api#orderinfo).
4874
5115
 
4875
5116
  This object represents information about an order.
4876
5117
  """
@@ -4889,7 +5130,7 @@ class OrderInfo(Model):
4889
5130
 
4890
5131
 
4891
5132
  class ShippingOption(Model):
4892
- """Object `ShippingOption`, see the [documentation](https://core.telegram.org/bots/api#shippingoption)
5133
+ """Object `ShippingOption`, see the [documentation](https://core.telegram.org/bots/api#shippingoption).
4893
5134
 
4894
5135
  This object represents one shipping option.
4895
5136
  """
@@ -4905,7 +5146,7 @@ class ShippingOption(Model):
4905
5146
 
4906
5147
 
4907
5148
  class SuccessfulPayment(Model):
4908
- """Object `SuccessfulPayment`, see the [documentation](https://core.telegram.org/bots/api#successfulpayment)
5149
+ """Object `SuccessfulPayment`, see the [documentation](https://core.telegram.org/bots/api#successfulpayment).
4909
5150
 
4910
5151
  This object contains basic information about a successful payment.
4911
5152
  """
@@ -4936,7 +5177,7 @@ class SuccessfulPayment(Model):
4936
5177
 
4937
5178
 
4938
5179
  class ShippingQuery(Model):
4939
- """Object `ShippingQuery`, see the [documentation](https://core.telegram.org/bots/api#shippingquery)
5180
+ """Object `ShippingQuery`, see the [documentation](https://core.telegram.org/bots/api#shippingquery).
4940
5181
 
4941
5182
  This object contains information about an incoming shipping query.
4942
5183
  """
@@ -4955,7 +5196,7 @@ class ShippingQuery(Model):
4955
5196
 
4956
5197
 
4957
5198
  class PreCheckoutQuery(Model):
4958
- """Object `PreCheckoutQuery`, see the [documentation](https://core.telegram.org/bots/api#precheckoutquery)
5199
+ """Object `PreCheckoutQuery`, see the [documentation](https://core.telegram.org/bots/api#precheckoutquery).
4959
5200
 
4960
5201
  This object contains information about an incoming pre-checkout query.
4961
5202
  """
@@ -4986,7 +5227,7 @@ class PreCheckoutQuery(Model):
4986
5227
 
4987
5228
 
4988
5229
  class PassportData(Model):
4989
- """Object `PassportData`, see the [documentation](https://core.telegram.org/bots/api#passportdata)
5230
+ """Object `PassportData`, see the [documentation](https://core.telegram.org/bots/api#passportdata).
4990
5231
 
4991
5232
  Describes Telegram Passport data shared with the bot by the user.
4992
5233
  """
@@ -5000,7 +5241,7 @@ class PassportData(Model):
5000
5241
 
5001
5242
 
5002
5243
  class PassportFile(Model):
5003
- """Object `PassportFile`, see the [documentation](https://core.telegram.org/bots/api#passportfile)
5244
+ """Object `PassportFile`, see the [documentation](https://core.telegram.org/bots/api#passportfile).
5004
5245
 
5005
5246
  This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.
5006
5247
  """
@@ -5020,7 +5261,7 @@ class PassportFile(Model):
5020
5261
 
5021
5262
 
5022
5263
  class EncryptedPassportElement(Model):
5023
- """Object `EncryptedPassportElement`, see the [documentation](https://core.telegram.org/bots/api#encryptedpassportelement)
5264
+ """Object `EncryptedPassportElement`, see the [documentation](https://core.telegram.org/bots/api#encryptedpassportelement).
5024
5265
 
5025
5266
  Describes documents or other Telegram Passport elements shared with the bot by the user.
5026
5267
  """
@@ -5079,7 +5320,7 @@ class EncryptedPassportElement(Model):
5079
5320
 
5080
5321
 
5081
5322
  class EncryptedCredentials(Model):
5082
- """Object `EncryptedCredentials`, see the [documentation](https://core.telegram.org/bots/api#encryptedcredentials)
5323
+ """Object `EncryptedCredentials`, see the [documentation](https://core.telegram.org/bots/api#encryptedcredentials).
5083
5324
 
5084
5325
  Describes data required for decrypting and authenticating EncryptedPassportElement. See the Telegram Passport Documentation for a complete description of the data decryption and authentication processes.
5085
5326
  """
@@ -5098,7 +5339,7 @@ class EncryptedCredentials(Model):
5098
5339
 
5099
5340
 
5100
5341
  class PassportElementErrorDataField(PassportElementError):
5101
- """Object `PassportElementErrorDataField`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrordatafield)
5342
+ """Object `PassportElementErrorDataField`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrordatafield).
5102
5343
 
5103
5344
  Represents an issue in one of the data fields that was provided by the user. The error is considered resolved when the field's value changes.
5104
5345
  """
@@ -5128,7 +5369,7 @@ class PassportElementErrorDataField(PassportElementError):
5128
5369
 
5129
5370
 
5130
5371
  class PassportElementErrorFrontSide(PassportElementError):
5131
- """Object `PassportElementErrorFrontSide`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrorfrontside)
5372
+ """Object `PassportElementErrorFrontSide`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrorfrontside).
5132
5373
 
5133
5374
  Represents an issue with the front side of a document. The error is considered resolved when the file with the front side of the document changes.
5134
5375
  """
@@ -5153,7 +5394,7 @@ class PassportElementErrorFrontSide(PassportElementError):
5153
5394
 
5154
5395
 
5155
5396
  class PassportElementErrorReverseSide(PassportElementError):
5156
- """Object `PassportElementErrorReverseSide`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrorreverseside)
5397
+ """Object `PassportElementErrorReverseSide`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrorreverseside).
5157
5398
 
5158
5399
  Represents an issue with the reverse side of a document. The error is considered resolved when the file with reverse side of the document changes.
5159
5400
  """
@@ -5173,7 +5414,7 @@ class PassportElementErrorReverseSide(PassportElementError):
5173
5414
 
5174
5415
 
5175
5416
  class PassportElementErrorSelfie(PassportElementError):
5176
- """Object `PassportElementErrorSelfie`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrorselfie)
5417
+ """Object `PassportElementErrorSelfie`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrorselfie).
5177
5418
 
5178
5419
  Represents an issue with the selfie with a document. The error is considered resolved when the file with the selfie changes.
5179
5420
  """
@@ -5198,7 +5439,7 @@ class PassportElementErrorSelfie(PassportElementError):
5198
5439
 
5199
5440
 
5200
5441
  class PassportElementErrorFile(PassportElementError):
5201
- """Object `PassportElementErrorFile`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrorfile)
5442
+ """Object `PassportElementErrorFile`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrorfile).
5202
5443
 
5203
5444
  Represents an issue with a document scan. The error is considered resolved when the file with the document scan changes.
5204
5445
  """
@@ -5225,7 +5466,7 @@ class PassportElementErrorFile(PassportElementError):
5225
5466
 
5226
5467
 
5227
5468
  class PassportElementErrorFiles(PassportElementError):
5228
- """Object `PassportElementErrorFiles`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrorfiles)
5469
+ """Object `PassportElementErrorFiles`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrorfiles).
5229
5470
 
5230
5471
  Represents an issue with a list of scans. The error is considered resolved when the list of files containing the scans changes.
5231
5472
  """
@@ -5252,7 +5493,7 @@ class PassportElementErrorFiles(PassportElementError):
5252
5493
 
5253
5494
 
5254
5495
  class PassportElementErrorTranslationFile(PassportElementError):
5255
- """Object `PassportElementErrorTranslationFile`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrortranslationfile)
5496
+ """Object `PassportElementErrorTranslationFile`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrortranslationfile).
5256
5497
 
5257
5498
  Represents an issue with one of the files that constitute the translation of a document. The error is considered resolved when the file changes.
5258
5499
  """
@@ -5284,7 +5525,7 @@ class PassportElementErrorTranslationFile(PassportElementError):
5284
5525
 
5285
5526
 
5286
5527
  class PassportElementErrorTranslationFiles(PassportElementError):
5287
- """Object `PassportElementErrorTranslationFiles`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrortranslationfiles)
5528
+ """Object `PassportElementErrorTranslationFiles`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrortranslationfiles).
5288
5529
 
5289
5530
  Represents an issue with the translated version of a document. The error is considered resolved when a file with the document translation change.
5290
5531
  """
@@ -5316,7 +5557,7 @@ class PassportElementErrorTranslationFiles(PassportElementError):
5316
5557
 
5317
5558
 
5318
5559
  class PassportElementErrorUnspecified(PassportElementError):
5319
- """Object `PassportElementErrorUnspecified`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrorunspecified)
5560
+ """Object `PassportElementErrorUnspecified`, see the [documentation](https://core.telegram.org/bots/api#passportelementerrorunspecified).
5320
5561
 
5321
5562
  Represents an issue in an unspecified place. The error is considered resolved when new data is added.
5322
5563
  """
@@ -5335,7 +5576,7 @@ class PassportElementErrorUnspecified(PassportElementError):
5335
5576
 
5336
5577
 
5337
5578
  class Game(Model):
5338
- """Object `Game`, see the [documentation](https://core.telegram.org/bots/api#game)
5579
+ """Object `Game`, see the [documentation](https://core.telegram.org/bots/api#game).
5339
5580
 
5340
5581
  This object represents a game. Use BotFather to create and edit games, their short names will act as unique identifiers.
5341
5582
  """
@@ -5365,14 +5606,14 @@ class Game(Model):
5365
5606
 
5366
5607
 
5367
5608
  class CallbackGame(Model):
5368
- """Object `CallbackGame`, see the [documentation](https://core.telegram.org/bots/api#callbackgame)
5609
+ """Object `CallbackGame`, see the [documentation](https://core.telegram.org/bots/api#callbackgame).
5369
5610
 
5370
5611
  A placeholder, currently holds no information. Use BotFather to set up your game.
5371
5612
  """
5372
5613
 
5373
5614
 
5374
5615
  class GameHighScore(Model):
5375
- """Object `GameHighScore`, see the [documentation](https://core.telegram.org/bots/api#gamehighscore)
5616
+ """Object `GameHighScore`, see the [documentation](https://core.telegram.org/bots/api#gamehighscore).
5376
5617
 
5377
5618
  This object represents one row of the high scores table for a game.
5378
5619
  """