python/aiogram
1
0
Fork 0
mirror of https://github.com/aiogram/aiogram.git synced 2025-12-06 16:15:51 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Added support for Bot API 7.0 (#1387)

Browse source 
* Added support for Bot API 7.0

* Fixed available tests

* Fixed text decorations

* Bot API 7.0 tests for ForwardMessages

* Bot API 7.0 tests for CopyMessages

* Bot API 7.0 tests for DeleteMessages

* Bot API 7.0 tests for GetUserChatBoosts

* Bot API 7.0 tests for SetMessageReaction

* Fixed custom_emoji attribute name

* Fixed tests

* Test parsing CallbackQuery message (inaccessible and accessible)

* Added changes description

* Bot API 7.0 tests for dispatcher handle update message_reaction

* Bot API 7.0 tests for dispatcher handle update message_reaction_count

* Bot API 7.0 tests for dispatcher handle update chat_boost

* Bot API 7.0 tests for dispatcher handle update removed_chat_boost

* fix tests: update ReactionTypeCustomEmoji custom_emoji -> custom_emoji_id

* micro fix Markdown V2 blockquote

* add tests for Markdown tools

* fix markdown test apply single entity

* add tests coverage for Message.react

* check that all messages and content types are covered for Message.content_type

* sort imports in tests (run `make reformat lint`)

* update Giveaway objects Unix time field to DateTime type

* Update Message.content_type property

* upgrade tests for message content_types and sent_copy

* Update Giveaway type generation config

* Update GiveawayWinners and PassportFile types generation configs

---------

Co-authored-by: Suren Khorenyan <surenkhorenyan@gmail.com>
This commit is contained in:
Alex Root Junior 2023-12-31 01:40:44 +02:00 • committed by GitHub
parent 756cfeba0a
commit 6795b3de05
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
244 changed files with 9401 additions and 1715 deletions
Download patch file Download diff file Expand all files Collapse all files

2
.apiversion
View file

@ -1 +1 @@
6.9
7.0

12
.butcher/enums/ChatBoostSourceType.yml Normal file
View file

@ -0,0 +1,12 @@
name: ChatBoostSourceType
description: |
This object represents a type of chat boost source.
Source: https://core.telegram.org/bots/api#chatboostsource
multi_parse:
attribute: source
regexp: "'([a-z_]+)'"
entities:
- ChatBoostSourcePremium
- ChatBoostSourceGiftCode
- ChatBoostSourceGiveaway

4
.butcher/enums/ContentType.yml
View file

@ -31,3 +31,7 @@ extract:
- caption
- caption_entities
- reply_to_message
- quote
- forward_origin
- external_reply
- link_preview_options

13
.butcher/enums/MessageOriginType.yml Normal file
View file

@ -0,0 +1,13 @@
name: MessageOriginType
description: |
This object represents origin of a message.
Source: https://core.telegram.org/bots/api#messageorigin
multi_parse:
attribute: type
regexp: "'([a-z_]+)'"
entities:
- MessageOriginUser
- MessageOriginHiddenUser
- MessageOriginChat
- MessageOriginChannel

11
.butcher/enums/ReactionTypeType.yml Normal file
View file

@ -0,0 +1,11 @@
name: ReactionTypeType
description: |
This object represents reaction type.
Source: https://core.telegram.org/bots/api#reactiontype
multi_parse:
attribute: type
regexp: "'([a-z_]+)'"
entities:
- ReactionTypeEmoji
- ReactionTypeCustomEmoji

48
.butcher/methods/copyMessage/entity.json
View file

@ -7,9 +7,9 @@
"object": {
"anchor": "copymessage",
"name": "copyMessage",
"description": "Use this method to copy messages of any kind. Service messages and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success.",
"html_description": "<p>Use this method to copy messages of any kind. Service messages and invoice messages can't be copied. A quiz <a href=\"#poll\">poll</a> can be copied only if the value of the field <em>correct_option_id</em> is known to the bot. The method is analogous to the method <a href=\"#forwardmessage\">forwardMessage</a>, but the copied message doesn't have a link to the original message. Returns the <a href=\"#messageid\">MessageId</a> of the sent message on success.</p>",
"rst_description": "Use this method to copy messages of any kind. Service messages and invoice messages can't be copied. A quiz :class:`aiogram.methods.poll.Poll` can be copied only if the value of the field *correct_option_id* is known to the bot. The method is analogous to the method :class:`aiogram.methods.forward_message.ForwardMessage`, but the copied message doesn't have a link to the original message. Returns the :class:`aiogram.types.message_id.MessageId` of the sent message on success.",
"description": "Use this method to copy messages of any kind. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success.",
"html_description": "<p>Use this method to copy messages of any kind. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz <a href=\"#poll\">poll</a> can be copied only if the value of the field <em>correct_option_id</em> is known to the bot. The method is analogous to the method <a href=\"#forwardmessage\">forwardMessage</a>, but the copied message doesn't have a link to the original message. Returns the <a href=\"#messageid\">MessageId</a> of the sent message on success.</p>",
"rst_description": "Use this method to copy messages of any kind. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz :class:`aiogram.methods.poll.Poll` can be copied only if the value of the field *correct_option_id* is known to the bot. The method is analogous to the method :class:`aiogram.methods.forward_message.ForwardMessage`, but the copied message doesn't have a link to the original message. Returns the :class:`aiogram.types.message_id.MessageId` of the sent message on success.",
"annotations": [
{
"type": "Integer or String",
@ -84,20 +84,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -106,6 +98,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

73
.butcher/methods/copyMessages/entity.json Normal file
View file

@ -0,0 +1,73 @@
{
"meta": {},
"group": {
"title": "Available methods",
"anchor": "available-methods"
},
"object": {
"anchor": "copymessages",
"name": "copyMessages",
"description": "Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned.",
"html_description": "<p>Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz <a href=\"#poll\">poll</a> can be copied only if the value of the field <em>correct_option_id</em> is known to the bot. The method is analogous to the method <a href=\"#forwardmessages\">forwardMessages</a>, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of <a href=\"#messageid\">MessageId</a> of the sent messages is returned.</p>",
"rst_description": "Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz :class:`aiogram.methods.poll.Poll` can be copied only if the value of the field *correct_option_id* is known to the bot. The method is analogous to the method :class:`aiogram.methods.forward_messages.ForwardMessages`, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of :class:`aiogram.types.message_id.MessageId` of the sent messages is returned.",
"annotations": [
{
"type": "Integer or String",
"required": true,
"description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)",
"html_description": "<td>Unique identifier for the target chat or username of the target channel (in the format <code>@channelusername</code>)</td>",
"rst_description": "Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)\n",
"name": "chat_id"
},
{
"type": "Integer",
"required": false,
"description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only",
"html_description": "<td>Unique identifier for the target message thread (topic) of the forum; for forum supergroups only</td>",
"rst_description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only\n",
"name": "message_thread_id"
},
{
"type": "Integer or String",
"required": true,
"description": "Unique identifier for the chat where the original messages were sent (or channel username in the format @channelusername)",
"html_description": "<td>Unique identifier for the chat where the original messages were sent (or channel username in the format <code>@channelusername</code>)</td>",
"rst_description": "Unique identifier for the chat where the original messages were sent (or channel username in the format :code:`@channelusername`)\n",
"name": "from_chat_id"
},
{
"type": "Array of Integer",
"required": true,
"description": "Identifiers of 1-100 messages in the chat from_chat_id to copy. The identifiers must be specified in a strictly increasing order.",
"html_description": "<td>Identifiers of 1-100 messages in the chat <em>from_chat_id</em> to copy. The identifiers must be specified in a strictly increasing order.</td>",
"rst_description": "Identifiers of 1-100 messages in the chat *from_chat_id* to copy. The identifiers must be specified in a strictly increasing order.\n",
"name": "message_ids"
},
{
"type": "Boolean",
"required": false,
"description": "Sends the messages silently. Users will receive a notification with no sound.",
"html_description": "<td>Sends the messages <a href=\"https://telegram.org/blog/channels-2-0#silent-messages\">silently</a>. Users will receive a notification with no sound.</td>",
"rst_description": "Sends the messages `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.\n",
"name": "disable_notification"
},
{
"type": "Boolean",
"required": false,
"description": "Protects the contents of the sent messages from forwarding and saving",
"html_description": "<td>Protects the contents of the sent messages from forwarding and saving</td>",
"rst_description": "Protects the contents of the sent messages from forwarding and saving\n",
"name": "protect_content"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True to copy the messages without their captions",
"html_description": "<td>Pass <em>True</em> to copy the messages without their captions</td>",
"rst_description": "Pass :code:`True` to copy the messages without their captions\n",
"name": "remove_caption"
}
],
"category": "methods"
}
}

33
.butcher/methods/deleteMessages/entity.json Normal file
View file

@ -0,0 +1,33 @@
{
"meta": {},
"group": {
"title": "Updating messages",
"anchor": "updating-messages"
},
"object": {
"anchor": "deletemessages",
"name": "deleteMessages",
"description": "Use this method to delete multiple messages simultaneously. If some of the specified messages can't be found, they are skipped. Returns True on success.",
"html_description": "<p>Use this method to delete multiple messages simultaneously. If some of the specified messages can't be found, they are skipped. Returns <em>True</em> on success.</p>",
"rst_description": "Use this method to delete multiple messages simultaneously. If some of the specified messages can't be found, they are skipped. Returns :code:`True` on success.",
"annotations": [
{
"type": "Integer or String",
"required": true,
"description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)",
"html_description": "<td>Unique identifier for the target chat or username of the target channel (in the format <code>@channelusername</code>)</td>",
"rst_description": "Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)\n",
"name": "chat_id"
},
{
"type": "Array of Integer",
"required": true,
"description": "Identifiers of 1-100 messages to delete. See deleteMessage for limitations on which messages can be deleted",
"html_description": "<td>Identifiers of 1-100 messages to delete. See <a href=\"#deletemessage\">deleteMessage</a> for limitations on which messages can be deleted</td>",
"rst_description": "Identifiers of 1-100 messages to delete. See :class:`aiogram.methods.delete_message.DeleteMessage` for limitations on which messages can be deleted\n",
"name": "message_ids"
}
],
"category": "methods"
}
}

22
.butcher/methods/editMessageText/entity.json
View file

@ -60,12 +60,12 @@
"name": "entities"
},
{
"type": "Boolean",
"type": "LinkPreviewOptions",
"required": false,
"description": "Disables link previews for links in this message",
"html_description": "<td>Disables link previews for links in this message</td>",
"rst_description": "Disables link previews for links in this message\n",
"name": "disable_web_page_preview"
"description": "Link preview generation options for the message",
"html_description": "<td>Link preview generation options for the message</td>",
"rst_description": "Link preview generation options for the message\n",
"name": "link_preview_options"
},
{
"type": "InlineKeyboardMarkup",
@ -74,6 +74,18 @@
"html_description": "<td>A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>.</td>",
"rst_description": "A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Disables link previews for links in this message",
"html_description": "<td>Disables link previews for links in this message</td>",
"rst_description": "Disables link previews for links in this message\n",
"name": "disable_web_page_preview",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

6
.butcher/methods/forwardMessage/entity.json
View file

@ -7,9 +7,9 @@
"object": {
"anchor": "forwardmessage",
"name": "forwardMessage",
"description": "Use this method to forward messages of any kind. Service messages can't be forwarded. On success, the sent Message is returned.",
"html_description": "<p>Use this method to forward messages of any kind. Service messages can't be forwarded. On success, the sent <a href=\"#message\">Message</a> is returned.</p>",
"rst_description": "Use this method to forward messages of any kind. Service messages can't be forwarded. On success, the sent :class:`aiogram.types.message.Message` is returned.",
"description": "Use this method to forward messages of any kind. Service messages and messages with protected content can't be forwarded. On success, the sent Message is returned.",
"html_description": "<p>Use this method to forward messages of any kind. Service messages and messages with protected content can't be forwarded. On success, the sent <a href=\"#message\">Message</a> is returned.</p>",
"rst_description": "Use this method to forward messages of any kind. Service messages and messages with protected content can't be forwarded. On success, the sent :class:`aiogram.types.message.Message` is returned.",
"annotations": [
{
"type": "Integer or String",

65
.butcher/methods/forwardMessages/entity.json Normal file
View file

@ -0,0 +1,65 @@
{
"meta": {},
"group": {
"title": "Available methods",
"anchor": "available-methods"
},
"object": {
"anchor": "forwardmessages",
"name": "forwardMessages",
"description": "Use this method to forward multiple messages of any kind. If some of the specified messages can't be found or forwarded, they are skipped. Service messages and messages with protected content can't be forwarded. Album grouping is kept for forwarded messages. On success, an array of MessageId of the sent messages is returned.",
"html_description": "<p>Use this method to forward multiple messages of any kind. If some of the specified messages can't be found or forwarded, they are skipped. Service messages and messages with protected content can't be forwarded. Album grouping is kept for forwarded messages. On success, an array of <a href=\"#messageid\">MessageId</a> of the sent messages is returned.</p>",
"rst_description": "Use this method to forward multiple messages of any kind. If some of the specified messages can't be found or forwarded, they are skipped. Service messages and messages with protected content can't be forwarded. Album grouping is kept for forwarded messages. On success, an array of :class:`aiogram.types.message_id.MessageId` of the sent messages is returned.",
"annotations": [
{
"type": "Integer or String",
"required": true,
"description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)",
"html_description": "<td>Unique identifier for the target chat or username of the target channel (in the format <code>@channelusername</code>)</td>",
"rst_description": "Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)\n",
"name": "chat_id"
},
{
"type": "Integer",
"required": false,
"description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only",
"html_description": "<td>Unique identifier for the target message thread (topic) of the forum; for forum supergroups only</td>",
"rst_description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only\n",
"name": "message_thread_id"
},
{
"type": "Integer or String",
"required": true,
"description": "Unique identifier for the chat where the original messages were sent (or channel username in the format @channelusername)",
"html_description": "<td>Unique identifier for the chat where the original messages were sent (or channel username in the format <code>@channelusername</code>)</td>",
"rst_description": "Unique identifier for the chat where the original messages were sent (or channel username in the format :code:`@channelusername`)\n",
"name": "from_chat_id"
},
{
"type": "Array of Integer",
"required": true,
"description": "Identifiers of 1-100 messages in the chat from_chat_id to forward. The identifiers must be specified in a strictly increasing order.",
"html_description": "<td>Identifiers of 1-100 messages in the chat <em>from_chat_id</em> to forward. The identifiers must be specified in a strictly increasing order.</td>",
"rst_description": "Identifiers of 1-100 messages in the chat *from_chat_id* to forward. The identifiers must be specified in a strictly increasing order.\n",
"name": "message_ids"
},
{
"type": "Boolean",
"required": false,
"description": "Sends the messages silently. Users will receive a notification with no sound.",
"html_description": "<td>Sends the messages <a href=\"https://telegram.org/blog/channels-2-0#silent-messages\">silently</a>. Users will receive a notification with no sound.</td>",
"rst_description": "Sends the messages `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.\n",
"name": "disable_notification"
},
{
"type": "Boolean",
"required": false,
"description": "Protects the contents of the forwarded messages from forwarding and saving",
"html_description": "<td>Protects the contents of the forwarded messages from forwarding and saving</td>",
"rst_description": "Protects the contents of the forwarded messages from forwarding and saving\n",
"name": "protect_content"
}
],
"category": "methods"
}
}

6
.butcher/methods/getChat/entity.json
View file

@ -7,9 +7,9 @@
"object": {
"anchor": "getchat",
"name": "getChat",
"description": "Use this method to get up to date information about the chat (current name of the user for one-on-one conversations, current username of a user, group or channel, etc.). Returns a Chat object on success.",
"html_description": "<p>Use this method to get up to date information about the chat (current name of the user for one-on-one conversations, current username of a user, group or channel, etc.). Returns a <a href=\"#chat\">Chat</a> object on success.</p>",
"rst_description": "Use this method to get up to date information about the chat (current name of the user for one-on-one conversations, current username of a user, group or channel, etc.). Returns a :class:`aiogram.types.chat.Chat` object on success.",
"description": "Use this method to get up to date information about the chat. Returns a Chat object on success.",
"html_description": "<p>Use this method to get up to date information about the chat. Returns a <a href=\"#chat\">Chat</a> object on success.</p>",
"rst_description": "Use this method to get up to date information about the chat. Returns a :class:`aiogram.types.chat.Chat` object on success.",
"annotations": [
{
"type": "Integer or String",

6
.butcher/methods/getUpdates/entity.json
View file

@ -38,9 +38,9 @@
{
"type": "Array of String",
"required": false,
"description": "A JSON-serialized list of the update types you want your bot to receive. For example, specify [\"message\", \"edited_channel_post\", \"callback_query\"] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all update types except chat_member (default). If not specified, the previous setting will be used.\n\nPlease note that this parameter doesn't affect updates created before the call to the getUpdates, so unwanted updates may be received for a short period of time.",
"html_description": "<td>A JSON-serialized list of the update types you want your bot to receive. For example, specify <code>[\"message\", \"edited_channel_post\", \"callback_query\"]</code> to only receive updates of these types. See <a href=\"#update\">Update</a> for a complete list of available update types. Specify an empty list to receive all update types except <em>chat_member</em> (default). If not specified, the previous setting will be used.<br/>\n<br/>\nPlease note that this parameter doesn't affect updates created before the call to the getUpdates, so unwanted updates may be received for a short period of time.</td>",
"rst_description": "A JSON-serialized list of the update types you want your bot to receive. For example, specify :code:`[\"message\", \"edited_channel_post\", \"callback_query\"]` to only receive updates of these types. See :class:`aiogram.types.update.Update` for a complete list of available update types. Specify an empty list to receive all update types except *chat_member* (default). If not specified, the previous setting will be used.\n\n\n\nPlease note that this parameter doesn't affect updates created before the call to the getUpdates, so unwanted updates may be received for a short period of time.\n",
"description": "A JSON-serialized list of the update types you want your bot to receive. For example, specify [\"message\", \"edited_channel_post\", \"callback_query\"] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all update types except chat_member, message_reaction, and message_reaction_count (default). If not specified, the previous setting will be used.\n\nPlease note that this parameter doesn't affect updates created before the call to the getUpdates, so unwanted updates may be received for a short period of time.",
"html_description": "<td>A JSON-serialized list of the update types you want your bot to receive. For example, specify <code>[\"message\", \"edited_channel_post\", \"callback_query\"]</code> to only receive updates of these types. See <a href=\"#update\">Update</a> for a complete list of available update types. Specify an empty list to receive all update types except <em>chat_member</em>, <em>message_reaction</em>, and <em>message_reaction_count</em> (default). If not specified, the previous setting will be used.<br/>\n<br/>\nPlease note that this parameter doesn't affect updates created before the call to the getUpdates, so unwanted updates may be received for a short period of time.</td>",
"rst_description": "A JSON-serialized list of the update types you want your bot to receive. For example, specify :code:`[\"message\", \"edited_channel_post\", \"callback_query\"]` to only receive updates of these types. See :class:`aiogram.types.update.Update` for a complete list of available update types. Specify an empty list to receive all update types except *chat_member*, *message_reaction*, and *message_reaction_count* (default). If not specified, the previous setting will be used.\n\n\n\nPlease note that this parameter doesn't affect updates created before the call to the getUpdates, so unwanted updates may be received for a short period of time.\n",
"name": "allowed_updates"
}
],

33
.butcher/methods/getUserChatBoosts/entity.json Normal file
View file

@ -0,0 +1,33 @@
{
"meta": {},
"group": {
"title": "Available methods",
"anchor": "available-methods"
},
"object": {
"anchor": "getuserchatboosts",
"name": "getUserChatBoosts",
"description": "Use this method to get the list of boosts added to a chat by a user. Requires administrator rights in the chat. Returns a UserChatBoosts object.",
"html_description": "<p>Use this method to get the list of boosts added to a chat by a user. Requires administrator rights in the chat. Returns a <a href=\"#userchatboosts\">UserChatBoosts</a> object.</p>",
"rst_description": "Use this method to get the list of boosts added to a chat by a user. Requires administrator rights in the chat. Returns a :class:`aiogram.types.user_chat_boosts.UserChatBoosts` object.",
"annotations": [
{
"type": "Integer or String",
"required": true,
"description": "Unique identifier for the chat or username of the channel (in the format @channelusername)",
"html_description": "<td>Unique identifier for the chat or username of the channel (in the format <code>@channelusername</code>)</td>",
"rst_description": "Unique identifier for the chat or username of the channel (in the format :code:`@channelusername`)\n",
"name": "chat_id"
},
{
"type": "Integer",
"required": true,
"description": "Unique identifier of the target user",
"html_description": "<td>Unique identifier of the target user</td>",
"rst_description": "Unique identifier of the target user\n",
"name": "user_id"
}
],
"category": "methods"
}
}

42
.butcher/methods/sendAnimation/entity.json
View file

@ -116,20 +116,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -138,6 +130,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendAudio/entity.json
View file

@ -108,20 +108,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -130,6 +122,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendContact/entity.json
View file

@ -76,20 +76,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -98,6 +90,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendDice/entity.json
View file

@ -52,20 +52,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -74,6 +66,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendDocument/entity.json
View file

@ -92,20 +92,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -114,6 +106,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendGame/entity.json
View file

@ -52,20 +52,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup",
@ -74,6 +66,30 @@
"html_description": "<td>A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game.</td>",
"rst_description": "A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendInvoice/entity.json
View file

@ -212,20 +212,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup",
@ -234,6 +226,30 @@
"html_description": "<td>A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>. If empty, one 'Pay <code>total price</code>' button will be shown. If not empty, the first button must be a Pay button.</td>",
"rst_description": "A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_. If empty, one 'Pay :code:`total price`' button will be shown. If not empty, the first button must be a Pay button.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendLocation/entity.json
View file

@ -92,20 +92,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -114,6 +106,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

28
.butcher/methods/sendMediaGroup/entity.json
View file

@ -52,12 +52,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the messages are a reply, ID of the original message",
"html_description": "<td>If the messages are a reply, ID of the original message</td>",
"rst_description": "If the messages are a reply, ID of the original message\n",
"name": "reply_to_message_id"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "Boolean",
@ -65,7 +65,23 @@
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the messages are a reply, ID of the original message",
"html_description": "<td>If the messages are a reply, ID of the original message</td>",
"rst_description": "If the messages are a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

64
.butcher/methods/sendMessage/entity.json
View file

@ -52,12 +52,12 @@
"name": "entities"
},
{
"type": "Boolean",
"type": "LinkPreviewOptions",
"required": false,
"description": "Disables link previews for links in this message",
"html_description": "<td>Disables link previews for links in this message</td>",
"rst_description": "Disables link previews for links in this message\n",
"name": "disable_web_page_preview"
"description": "Link preview generation options for the message",
"html_description": "<td>Link preview generation options for the message</td>",
"rst_description": "Link preview generation options for the message\n",
"name": "link_preview_options"
},
{
"type": "Boolean",
@ -76,20 +76,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -98,6 +90,42 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Boolean",
"required": false,
"description": "Disables link previews for links in this message",
"html_description": "<td>Disables link previews for links in this message</td>",
"rst_description": "Disables link previews for links in this message\n",
"name": "disable_web_page_preview",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendPhoto/entity.json
View file

@ -84,20 +84,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -106,6 +98,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendPoll/entity.json
View file

@ -140,20 +140,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -162,6 +154,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendSticker/entity.json
View file

@ -60,20 +60,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -82,6 +74,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendVenue/entity.json
View file

@ -108,20 +108,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -130,6 +122,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendVideo/entity.json
View file

@ -124,20 +124,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -146,6 +138,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendVideoNote/entity.json
View file

@ -76,20 +76,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -98,6 +90,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

42
.butcher/methods/sendVoice/entity.json
View file

@ -84,20 +84,12 @@
"name": "protect_content"
},
{
"type": "Integer",
"type": "ReplyParameters",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply"
"description": "Description of the message to reply to",
"html_description": "<td>Description of the message to reply to</td>",
"rst_description": "Description of the message to reply to\n",
"name": "reply_parameters"
},
{
"type": "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply",
@ -106,6 +98,30 @@
"html_description": "<td>Additional interface options. A JSON-serialized object for an <a href=\"/bots/features#inline-keyboards\">inline keyboard</a>, <a href=\"/bots/features#keyboards\">custom reply keyboard</a>, instructions to remove reply keyboard or to force a reply from the user.</td>",
"rst_description": "Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.\n",
"name": "reply_markup"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True if the message should be sent even if the specified replied-to message is not found",
"html_description": "<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>",
"rst_description": "Pass :code:`True` if the message should be sent even if the specified replied-to message is not found\n",
"name": "allow_sending_without_reply",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"required": false,
"description": "If the message is a reply, ID of the original message",
"html_description": "<td>If the message is a reply, ID of the original message</td>",
"rst_description": "If the message is a reply, ID of the original message\n",
"name": "reply_to_message_id",
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "methods"

49
.butcher/methods/setMessageReaction/entity.json Normal file
View file

@ -0,0 +1,49 @@
{
"meta": {},
"group": {
"title": "Available methods",
"anchor": "available-methods"
},
"object": {
"anchor": "setmessagereaction",
"name": "setMessageReaction",
"description": "Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. In albums, bots must react to the first message. Returns True on success.",
"html_description": "<p>Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. In albums, bots must react to the first message. Returns <em>True</em> on success.</p>",
"rst_description": "Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. In albums, bots must react to the first message. Returns :code:`True` on success.",
"annotations": [
{
"type": "Integer or String",
"required": true,
"description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)",
"html_description": "<td>Unique identifier for the target chat or username of the target channel (in the format <code>@channelusername</code>)</td>",
"rst_description": "Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)\n",
"name": "chat_id"
},
{
"type": "Integer",
"required": true,
"description": "Identifier of the target message",
"html_description": "<td>Identifier of the target message</td>",
"rst_description": "Identifier of the target message\n",
"name": "message_id"
},
{
"type": "Array of ReactionType",
"required": false,
"description": "New list of reaction types to set on the message. Currently, as non-premium users, bots can set up to one reaction per message. A custom emoji reaction can be used if it is either already present on the message or explicitly allowed by chat administrators.",
"html_description": "<td>New list of reaction types to set on the message. Currently, as non-premium users, bots can set up to one reaction per message. A custom emoji reaction can be used if it is either already present on the message or explicitly allowed by chat administrators.</td>",
"rst_description": "New list of reaction types to set on the message. Currently, as non-premium users, bots can set up to one reaction per message. A custom emoji reaction can be used if it is either already present on the message or explicitly allowed by chat administrators.\n",
"name": "reaction"
},
{
"type": "Boolean",
"required": false,
"description": "Pass True to set the reaction with a big animation",
"html_description": "<td>Pass <em>True</em> to set the reaction with a big animation</td>",
"rst_description": "Pass :code:`True` to set the reaction with a big animation\n",
"name": "is_big"
}
],
"category": "methods"
}
}

6
.butcher/methods/setWebhook/entity.json
View file

@ -46,9 +46,9 @@
{
"type": "Array of String",
"required": false,
"description": "A JSON-serialized list of the update types you want your bot to receive. For example, specify [\"message\", \"edited_channel_post\", \"callback_query\"] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all update types except chat_member (default). If not specified, the previous setting will be used.\nPlease note that this parameter doesn't affect updates created before the call to the setWebhook, so unwanted updates may be received for a short period of time.",
"html_description": "<td>A JSON-serialized list of the update types you want your bot to receive. For example, specify <code>[\"message\", \"edited_channel_post\", \"callback_query\"]</code> to only receive updates of these types. See <a href=\"#update\">Update</a> for a complete list of available update types. Specify an empty list to receive all update types except <em>chat_member</em> (default). If not specified, the previous setting will be used.<br/>\nPlease note that this parameter doesn't affect updates created before the call to the setWebhook, so unwanted updates may be received for a short period of time.</td>",
"rst_description": "A JSON-serialized list of the update types you want your bot to receive. For example, specify :code:`[\"message\", \"edited_channel_post\", \"callback_query\"]` to only receive updates of these types. See :class:`aiogram.types.update.Update` for a complete list of available update types. Specify an empty list to receive all update types except *chat_member* (default). If not specified, the previous setting will be used.\n\nPlease note that this parameter doesn't affect updates created before the call to the setWebhook, so unwanted updates may be received for a short period of time.\n",
"description": "A JSON-serialized list of the update types you want your bot to receive. For example, specify [\"message\", \"edited_channel_post\", \"callback_query\"] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all update types except chat_member, message_reaction, and message_reaction_count (default). If not specified, the previous setting will be used.\nPlease note that this parameter doesn't affect updates created before the call to the setWebhook, so unwanted updates may be received for a short period of time.",
"html_description": "<td>A JSON-serialized list of the update types you want your bot to receive. For example, specify <code>[\"message\", \"edited_channel_post\", \"callback_query\"]</code> to only receive updates of these types. See <a href=\"#update\">Update</a> for a complete list of available update types. Specify an empty list to receive all update types except <em>chat_member</em>, <em>message_reaction</em>, and <em>message_reaction_count</em> (default). If not specified, the previous setting will be used.<br/>\nPlease note that this parameter doesn't affect updates created before the call to the setWebhook, so unwanted updates may be received for a short period of time.</td>",
"rst_description": "A JSON-serialized list of the update types you want your bot to receive. For example, specify :code:`[\"message\", \"edited_channel_post\", \"callback_query\"]` to only receive updates of these types. See :class:`aiogram.types.update.Update` for a complete list of available update types. Specify an empty list to receive all update types except *chat_member*, *message_reaction*, and *message_reaction_count* (default). If not specified, the previous setting will be used.\n\nPlease note that this parameter doesn't affect updates created before the call to the setWebhook, so unwanted updates may be received for a short period of time.\n",
"name": "allowed_updates"
},
{

2279
.butcher/schema/schema.json
View file

File diff suppressed because one or more lines are too long

8
.butcher/types/CallbackQuery/entity.json
View file

@ -28,10 +28,10 @@
"required": true
},
{
"type": "Message",
"description": "Message with the callback button that originated the query. Note that message content and message date will not be available if the message is too old",
"html_description": "<td><em>Optional</em>. Message with the callback button that originated the query. Note that message content and message date will not be available if the message is too old</td>",
"rst_description": "*Optional*. Message with the callback button that originated the query. Note that message content and message date will not be available if the message is too old\n",
"type": "MaybeInaccessibleMessage",
"description": "Message sent by the bot with the callback button that originated the query",
"html_description": "<td><em>Optional</em>. Message sent by the bot with the callback button that originated the query</td>",
"rst_description": "*Optional*. Message sent by the bot with the callback button that originated the query\n",
"name": "message",
"required": false
},

60
.butcher/types/Chat/entity.json
View file

@ -83,19 +83,59 @@
"name": "active_usernames",
"required": false
},
{
"type": "Array of ReactionType",
"description": "List of available reactions allowed in the chat. If omitted, then all emoji reactions are allowed. Returned only in getChat.",
"html_description": "<td><em>Optional</em>. List of available reactions allowed in the chat. If omitted, then all <a href=\"#reactiontypeemoji\">emoji reactions</a> are allowed. Returned only in <a href=\"#getchat\">getChat</a>.</td>",
"rst_description": "*Optional*. List of available reactions allowed in the chat. If omitted, then all `emoji reactions <https://core.telegram.org/bots/api#reactiontypeemoji>`_ are allowed. Returned only in :class:`aiogram.methods.get_chat.GetChat`.\n",
"name": "available_reactions",
"required": false
},
{
"type": "Integer",
"description": "Identifier of the accent color for the chat name and backgrounds of the chat photo, reply header, and link preview. See accent colors for more details. Returned only in getChat. Always returned in getChat.",
"html_description": "<td><em>Optional</em>. Identifier of the accent color for the chat name and backgrounds of the chat photo, reply header, and link preview. See <a href=\"#accent-colors\">accent colors</a> for more details. Returned only in <a href=\"#getchat\">getChat</a>. Always returned in <a href=\"#getchat\">getChat</a>.</td>",
"rst_description": "*Optional*. Identifier of the accent color for the chat name and backgrounds of the chat photo, reply header, and link preview. See `accent colors <https://core.telegram.org/bots/api#accent-colors>`_ for more details. Returned only in :class:`aiogram.methods.get_chat.GetChat`. Always returned in :class:`aiogram.methods.get_chat.GetChat`.\n",
"name": "accent_color_id",
"required": false
},
{
"type": "String",
"description": "Custom emoji identifier of emoji status of the other party in a private chat. Returned only in getChat.",
"html_description": "<td><em>Optional</em>. Custom emoji identifier of emoji status of the other party in a private chat. Returned only in <a href=\"#getchat\">getChat</a>.</td>",
"rst_description": "*Optional*. Custom emoji identifier of emoji status of the other party in a private chat. Returned only in :class:`aiogram.methods.get_chat.GetChat`.\n",
"description": "Custom emoji identifier of emoji chosen by the chat for the reply header and link preview background. Returned only in getChat.",
"html_description": "<td><em>Optional</em>. Custom emoji identifier of emoji chosen by the chat for the reply header and link preview background. Returned only in <a href=\"#getchat\">getChat</a>.</td>",
"rst_description": "*Optional*. Custom emoji identifier of emoji chosen by the chat for the reply header and link preview background. Returned only in :class:`aiogram.methods.get_chat.GetChat`.\n",
"name": "background_custom_emoji_id",
"required": false
},
{
"type": "Integer",
"description": "Identifier of the accent color for the chat's profile background. See profile accent colors for more details. Returned only in getChat.",
"html_description": "<td><em>Optional</em>. Identifier of the accent color for the chat's profile background. See <a href=\"#profile-accent-colors\">profile accent colors</a> for more details. Returned only in <a href=\"#getchat\">getChat</a>.</td>",
"rst_description": "*Optional*. Identifier of the accent color for the chat's profile background. See `profile accent colors <https://core.telegram.org/bots/api#profile-accent-colors>`_ for more details. Returned only in :class:`aiogram.methods.get_chat.GetChat`.\n",
"name": "profile_accent_color_id",
"required": false
},
{
"type": "String",
"description": "Custom emoji identifier of the emoji chosen by the chat for its profile background. Returned only in getChat.",
"html_description": "<td><em>Optional</em>. Custom emoji identifier of the emoji chosen by the chat for its profile background. Returned only in <a href=\"#getchat\">getChat</a>.</td>",
"rst_description": "*Optional*. Custom emoji identifier of the emoji chosen by the chat for its profile background. Returned only in :class:`aiogram.methods.get_chat.GetChat`.\n",
"name": "profile_background_custom_emoji_id",
"required": false
},
{
"type": "String",
"description": "Custom emoji identifier of the emoji status of the chat or the other party in a private chat. Returned only in getChat.",
"html_description": "<td><em>Optional</em>. Custom emoji identifier of the emoji status of the chat or the other party in a private chat. Returned only in <a href=\"#getchat\">getChat</a>.</td>",
"rst_description": "*Optional*. Custom emoji identifier of the emoji status of the chat or the other party in a private chat. Returned only in :class:`aiogram.methods.get_chat.GetChat`.\n",
"name": "emoji_status_custom_emoji_id",
"required": false
},
{
"type": "Integer",
"description": "Expiration date of the emoji status of the other party in a private chat in Unix time, if any. Returned only in getChat.",
"html_description": "<td><em>Optional</em>. Expiration date of the emoji status of the other party in a private chat in Unix time, if any. Returned only in <a href=\"#getchat\">getChat</a>.</td>",
"rst_description": "*Optional*. Expiration date of the emoji status of the other party in a private chat in Unix time, if any. Returned only in :class:`aiogram.methods.get_chat.GetChat`.\n",
"description": "Expiration date of the emoji status of the chat or the other party in a private chat, in Unix time, if any. Returned only in getChat.",
"html_description": "<td><em>Optional</em>. Expiration date of the emoji status of the chat or the other party in a private chat, in Unix time, if any. Returned only in <a href=\"#getchat\">getChat</a>.</td>",
"rst_description": "*Optional*. Expiration date of the emoji status of the chat or the other party in a private chat, in Unix time, if any. Returned only in :class:`aiogram.methods.get_chat.GetChat`.\n",
"name": "emoji_status_expiration_date",
"required": false
},
@ -211,6 +251,14 @@
"name": "has_protected_content",
"required": false
},
{
"type": "True",
"description": "True, if new chat members will have access to old messages; available only to chat administrators. Returned only in getChat.",
"html_description": "<td><em>Optional</em>. <em>True</em>, if new chat members will have access to old messages; available only to chat administrators. Returned only in <a href=\"#getchat\">getChat</a>.</td>",
"rst_description": "*Optional*. :code:`True`, if new chat members will have access to old messages; available only to chat administrators. Returned only in :class:`aiogram.methods.get_chat.GetChat`.\n",
"name": "has_visible_history",
"required": false
},
{
"type": "String",
"description": "For supergroups, name of group sticker set. Returned only in getChat.",

49
.butcher/types/ChatBoost/entity.json Normal file
View file

@ -0,0 +1,49 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "chatboost",
"name": "ChatBoost",
"description": "This object contains information about a chat boost.",
"html_description": "<p>This object contains information about a chat boost.</p>",
"rst_description": "This object contains information about a chat boost.",
"annotations": [
{
"type": "String",
"description": "Unique identifier of the boost",
"html_description": "<td>Unique identifier of the boost</td>",
"rst_description": "Unique identifier of the boost\n",
"name": "boost_id",
"required": true
},
{
"type": "Integer",
"description": "Point in time (Unix timestamp) when the chat was boosted",
"html_description": "<td>Point in time (Unix timestamp) when the chat was boosted</td>",
"rst_description": "Point in time (Unix timestamp) when the chat was boosted\n",
"name": "add_date",
"required": true
},
{
"type": "Integer",
"description": "Point in time (Unix timestamp) when the boost will automatically expire, unless the booster's Telegram Premium subscription is prolonged",
"html_description": "<td>Point in time (Unix timestamp) when the boost will automatically expire, unless the booster's Telegram Premium subscription is prolonged</td>",
"rst_description": "Point in time (Unix timestamp) when the boost will automatically expire, unless the booster's Telegram Premium subscription is prolonged\n",
"name": "expiration_date",
"required": true
},
{
"type": "ChatBoostSource",
"description": "Source of the added boost",
"html_description": "<td>Source of the added boost</td>",
"rst_description": "Source of the added boost\n",
"name": "source",
"required": true
}
],
"category": "types"
}
}

9
.butcher/types/ChatBoost/replace.yml Normal file
View file

@ -0,0 +1,9 @@
annotations:
add_date:
parsed_type:
type: std
name: DateTime
expiration_date:
parsed_type:
type: std
name: DateTime

49
.butcher/types/ChatBoostRemoved/entity.json Normal file
View file

@ -0,0 +1,49 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "chatboostremoved",
"name": "ChatBoostRemoved",
"description": "This object represents a boost removed from a chat.",
"html_description": "<p>This object represents a boost removed from a chat.</p>",
"rst_description": "This object represents a boost removed from a chat.",
"annotations": [
{
"type": "Chat",
"description": "Chat which was boosted",
"html_description": "<td>Chat which was boosted</td>",
"rst_description": "Chat which was boosted\n",
"name": "chat",
"required": true
},
{
"type": "String",
"description": "Unique identifier of the boost",
"html_description": "<td>Unique identifier of the boost</td>",
"rst_description": "Unique identifier of the boost\n",
"name": "boost_id",
"required": true
},
{
"type": "Integer",
"description": "Point in time (Unix timestamp) when the boost was removed",
"html_description": "<td>Point in time (Unix timestamp) when the boost was removed</td>",
"rst_description": "Point in time (Unix timestamp) when the boost was removed\n",
"name": "remove_date",
"required": true
},
{
"type": "ChatBoostSource",
"description": "Source of the removed boost",
"html_description": "<td>Source of the removed boost</td>",
"rst_description": "Source of the removed boost\n",
"name": "source",
"required": true
}
],
"category": "types"
}
}

5
.butcher/types/ChatBoostRemoved/replace.yml Normal file
View file

@ -0,0 +1,5 @@
annotations:
remove_date:
parsed_type:
type: std
name: DateTime

16
.butcher/types/ChatBoostSource/entity.json Normal file
View file

@ -0,0 +1,16 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "chatboostsource",
"name": "ChatBoostSource",
"description": "This object describes the source of a chat boost. It can be one of\n - ChatBoostSourcePremium\n - ChatBoostSourceGiftCode\n - ChatBoostSourceGiveaway",
"html_description": "<p>This object describes the source of a chat boost. It can be one of</p><ul>\n<li><a href=\"#chatboostsourcepremium\">ChatBoostSourcePremium</a></li>\n<li><a href=\"#chatboostsourcegiftcode\">ChatBoostSourceGiftCode</a></li>\n<li><a href=\"#chatboostsourcegiveaway\">ChatBoostSourceGiveaway</a></li>\n</ul>",
"rst_description": "This object describes the source of a chat boost. It can be one of\n\n - :class:`aiogram.types.chat_boost_source_premium.ChatBoostSourcePremium`\n - :class:`aiogram.types.chat_boost_source_gift_code.ChatBoostSourceGiftCode`\n - :class:`aiogram.types.chat_boost_source_giveaway.ChatBoostSourceGiveaway`",
"annotations": [],
"category": "types"
}
}

1
.butcher/types/ChatBoostSource/subtypes.yml Normal file
View file

@ -0,0 +1 @@
discriminator: "source"

33
.butcher/types/ChatBoostSourceGiftCode/entity.json Normal file
View file

@ -0,0 +1,33 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "chatboostsourcegiftcode",
"name": "ChatBoostSourceGiftCode",
"description": "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.",
"html_description": "<p>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.</p>",
"rst_description": "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.",
"annotations": [
{
"type": "String",
"description": "Source of the boost, always 'gift_code'",
"html_description": "<td>Source of the boost, always &#8220;gift_code&#8221;</td>",
"rst_description": "Source of the boost, always 'gift_code'\n",
"name": "source",
"required": true
},
{
"type": "User",
"description": "User for which the gift code was created",
"html_description": "<td>User for which the gift code was created</td>",
"rst_description": "User for which the gift code was created\n",
"name": "user",
"required": true
}
],
"category": "types"
}
}

49
.butcher/types/ChatBoostSourceGiveaway/entity.json Normal file
View file

@ -0,0 +1,49 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "chatboostsourcegiveaway",
"name": "ChatBoostSourceGiveaway",
"description": "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.",
"html_description": "<p>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.</p>",
"rst_description": "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.",
"annotations": [
{
"type": "String",
"description": "Source of the boost, always 'giveaway'",
"html_description": "<td>Source of the boost, always &#8220;giveaway&#8221;</td>",
"rst_description": "Source of the boost, always 'giveaway'\n",
"name": "source",
"required": true
},
{
"type": "Integer",
"description": "Identifier of a message in the chat with the giveaway; the message could have been deleted already. May be 0 if the message isn't sent yet.",
"html_description": "<td>Identifier of a message in the chat with the giveaway; the message could have been deleted already. May be 0 if the message isn't sent yet.</td>",
"rst_description": "Identifier of a message in the chat with the giveaway; the message could have been deleted already. May be 0 if the message isn't sent yet.\n",
"name": "giveaway_message_id",
"required": true
},
{
"type": "User",
"description": "User that won the prize in the giveaway if any",
"html_description": "<td><em>Optional</em>. User that won the prize in the giveaway if any</td>",
"rst_description": "*Optional*. User that won the prize in the giveaway if any\n",
"name": "user",
"required": false
},
{
"type": "True",
"description": "True, if the giveaway was completed, but there was no user to win the prize",
"html_description": "<td><em>Optional</em>. True, if the giveaway was completed, but there was no user to win the prize</td>",
"rst_description": "*Optional*. True, if the giveaway was completed, but there was no user to win the prize\n",
"name": "is_unclaimed",
"required": false
}
],
"category": "types"
}
}

33
.butcher/types/ChatBoostSourcePremium/entity.json Normal file
View file

@ -0,0 +1,33 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "chatboostsourcepremium",
"name": "ChatBoostSourcePremium",
"description": "The boost was obtained by subscribing to Telegram Premium or by gifting a Telegram Premium subscription to another user.",
"html_description": "<p>The boost was obtained by subscribing to Telegram Premium or by gifting a Telegram Premium subscription to another user.</p>",
"rst_description": "The boost was obtained by subscribing to Telegram Premium or by gifting a Telegram Premium subscription to another user.",
"annotations": [
{
"type": "String",
"description": "Source of the boost, always 'premium'",
"html_description": "<td>Source of the boost, always &#8220;premium&#8221;</td>",
"rst_description": "Source of the boost, always 'premium'\n",
"name": "source",
"required": true
},
{
"type": "User",
"description": "User that boosted the chat",
"html_description": "<td>User that boosted the chat</td>",
"rst_description": "User that boosted the chat\n",
"name": "user",
"required": true
}
],
"category": "types"
}
}

33
.butcher/types/ChatBoostUpdated/entity.json Normal file
View file

@ -0,0 +1,33 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "chatboostupdated",
"name": "ChatBoostUpdated",
"description": "This object represents a boost added to a chat or changed.",
"html_description": "<p>This object represents a boost added to a chat or changed.</p>",
"rst_description": "This object represents a boost added to a chat or changed.",
"annotations": [
{
"type": "Chat",
"description": "Chat which was boosted",
"html_description": "<td>Chat which was boosted</td>",
"rst_description": "Chat which was boosted\n",
"name": "chat",
"required": true
},
{
"type": "ChatBoost",
"description": "Infomation about the chat boost",
"html_description": "<td>Infomation about the chat boost</td>",
"rst_description": "Infomation about the chat boost\n",
"name": "boost",
"required": true
}
],
"category": "types"
}
}

6
.butcher/types/ChatMemberRestricted/entity.json
View file

@ -37,9 +37,9 @@
},
{
"type": "Boolean",
"description": "True, if the user is allowed to send text messages, contacts, invoices, locations and venues",
"html_description": "<td><em>True</em>, if the user is allowed to send text messages, contacts, invoices, locations and venues</td>",
"rst_description": ":code:`True`, if the user is allowed to send text messages, contacts, invoices, locations and venues\n",
"description": "True, if the user is allowed to send text messages, contacts, giveaways, giveaway winners, invoices, locations and venues",
"html_description": "<td><em>True</em>, if the user is allowed to send text messages, contacts, giveaways, giveaway winners, invoices, locations and venues</td>",
"rst_description": ":code:`True`, if the user is allowed to send text messages, contacts, giveaways, giveaway winners, invoices, locations and venues\n",
"name": "can_send_messages",
"required": true
},

6
.butcher/types/ChatPermissions/entity.json
View file

@ -13,9 +13,9 @@
"annotations": [
{
"type": "Boolean",
"description": "True, if the user is allowed to send text messages, contacts, invoices, locations and venues",
"html_description": "<td><em>Optional</em>. <em>True</em>, if the user is allowed to send text messages, contacts, invoices, locations and venues</td>",
"rst_description": "*Optional*. :code:`True`, if the user is allowed to send text messages, contacts, invoices, locations and venues\n",
"description": "True, if the user is allowed to send text messages, contacts, giveaways, giveaway winners, invoices, locations and venues",
"html_description": "<td><em>Optional</em>. <em>True</em>, if the user is allowed to send text messages, contacts, giveaways, giveaway winners, invoices, locations and venues</td>",
"rst_description": "*Optional*. :code:`True`, if the user is allowed to send text messages, contacts, giveaways, giveaway winners, invoices, locations and venues\n",
"name": "can_send_messages",
"required": false
},

201
.butcher/types/ExternalReplyInfo/entity.json Normal file
View file

@ -0,0 +1,201 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "externalreplyinfo",
"name": "ExternalReplyInfo",
"description": "This object contains information about a message that is being replied to, which may come from another chat or forum topic.",
"html_description": "<p>This object contains information about a message that is being replied to, which may come from another chat or forum topic.</p>",
"rst_description": "This object contains information about a message that is being replied to, which may come from another chat or forum topic.",
"annotations": [
{
"type": "MessageOrigin",
"description": "Origin of the message replied to by the given message",
"html_description": "<td>Origin of the message replied to by the given message</td>",
"rst_description": "Origin of the message replied to by the given message\n",
"name": "origin",
"required": true
},
{
"type": "Chat",
"description": "Chat the original message belongs to. Available only if the chat is a supergroup or a channel.",
"html_description": "<td><em>Optional</em>. Chat the original message belongs to. Available only if the chat is a supergroup or a channel.</td>",
"rst_description": "*Optional*. Chat the original message belongs to. Available only if the chat is a supergroup or a channel.\n",
"name": "chat",
"required": false
},
{
"type": "Integer",
"description": "Unique message identifier inside the original chat. Available only if the original chat is a supergroup or a channel.",
"html_description": "<td><em>Optional</em>. Unique message identifier inside the original chat. Available only if the original chat is a supergroup or a channel.</td>",
"rst_description": "*Optional*. Unique message identifier inside the original chat. Available only if the original chat is a supergroup or a channel.\n",
"name": "message_id",
"required": false
},
{
"type": "LinkPreviewOptions",
"description": "Options used for link preview generation for the original message, if it is a text message",
"html_description": "<td><em>Optional</em>. Options used for link preview generation for the original message, if it is a text message</td>",
"rst_description": "*Optional*. Options used for link preview generation for the original message, if it is a text message\n",
"name": "link_preview_options",
"required": false
},
{
"type": "Animation",
"description": "Message is an animation, information about the animation",
"html_description": "<td><em>Optional</em>. Message is an animation, information about the animation</td>",
"rst_description": "*Optional*. Message is an animation, information about the animation\n",
"name": "animation",
"required": false
},
{
"type": "Audio",
"description": "Message is an audio file, information about the file",
"html_description": "<td><em>Optional</em>. Message is an audio file, information about the file</td>",
"rst_description": "*Optional*. Message is an audio file, information about the file\n",
"name": "audio",
"required": false
},
{
"type": "Document",
"description": "Message is a general file, information about the file",
"html_description": "<td><em>Optional</em>. Message is a general file, information about the file</td>",
"rst_description": "*Optional*. Message is a general file, information about the file\n",
"name": "document",
"required": false
},
{
"type": "Array of PhotoSize",
"description": "Message is a photo, available sizes of the photo",
"html_description": "<td><em>Optional</em>. Message is a photo, available sizes of the photo</td>",
"rst_description": "*Optional*. Message is a photo, available sizes of the photo\n",
"name": "photo",
"required": false
},
{
"type": "Sticker",
"description": "Message is a sticker, information about the sticker",
"html_description": "<td><em>Optional</em>. Message is a sticker, information about the sticker</td>",
"rst_description": "*Optional*. Message is a sticker, information about the sticker\n",
"name": "sticker",
"required": false
},
{
"type": "Story",
"description": "Message is a forwarded story",
"html_description": "<td><em>Optional</em>. Message is a forwarded story</td>",
"rst_description": "*Optional*. Message is a forwarded story\n",
"name": "story",
"required": false
},
{
"type": "Video",
"description": "Message is a video, information about the video",
"html_description": "<td><em>Optional</em>. Message is a video, information about the video</td>",
"rst_description": "*Optional*. Message is a video, information about the video\n",
"name": "video",
"required": false
},
{
"type": "VideoNote",
"description": "Message is a video note, information about the video message",
"html_description": "<td><em>Optional</em>. Message is a <a href=\"https://telegram.org/blog/video-messages-and-telescope\">video note</a>, information about the video message</td>",
"rst_description": "*Optional*. Message is a `video note <https://telegram.org/blog/video-messages-and-telescope>`_, information about the video message\n",
"name": "video_note",
"required": false
},
{
"type": "Voice",
"description": "Message is a voice message, information about the file",
"html_description": "<td><em>Optional</em>. Message is a voice message, information about the file</td>",
"rst_description": "*Optional*. Message is a voice message, information about the file\n",
"name": "voice",
"required": false
},
{
"type": "True",
"description": "True, if the message media is covered by a spoiler animation",
"html_description": "<td><em>Optional</em>. <em>True</em>, if the message media is covered by a spoiler animation</td>",
"rst_description": "*Optional*. :code:`True`, if the message media is covered by a spoiler animation\n",
"name": "has_media_spoiler",
"required": false
},
{
"type": "Contact",
"description": "Message is a shared contact, information about the contact",
"html_description": "<td><em>Optional</em>. Message is a shared contact, information about the contact</td>",
"rst_description": "*Optional*. Message is a shared contact, information about the contact\n",
"name": "contact",
"required": false
},
{
"type": "Dice",
"description": "Message is a dice with random value",
"html_description": "<td><em>Optional</em>. Message is a dice with random value</td>",
"rst_description": "*Optional*. Message is a dice with random value\n",
"name": "dice",
"required": false
},
{
"type": "Game",
"description": "Message is a game, information about the game.",
"html_description": "<td><em>Optional</em>. Message is a game, information about the game. <a href=\"#games\">More about games &#187;</a></td>",
"rst_description": "*Optional*. Message is a game, information about the game. `More about games » <https://core.telegram.org/bots/api#games>`_\n",
"name": "game",
"required": false
},
{
"type": "Giveaway",
"description": "Message is a scheduled giveaway, information about the giveaway",
"html_description": "<td><em>Optional</em>. Message is a scheduled giveaway, information about the giveaway</td>",
"rst_description": "*Optional*. Message is a scheduled giveaway, information about the giveaway\n",
"name": "giveaway",
"required": false
},
{
"type": "GiveawayWinners",
"description": "A giveaway with public winners was completed",
"html_description": "<td><em>Optional</em>. A giveaway with public winners was completed</td>",
"rst_description": "*Optional*. A giveaway with public winners was completed\n",
"name": "giveaway_winners",
"required": false
},
{
"type": "Invoice",
"description": "Message is an invoice for a payment, information about the invoice.",
"html_description": "<td><em>Optional</em>. Message is an invoice for a <a href=\"#payments\">payment</a>, information about the invoice. <a href=\"#payments\">More about payments &#187;</a></td>",
"rst_description": "*Optional*. Message is an invoice for a `payment <https://core.telegram.org/bots/api#payments>`_, information about the invoice. `More about payments » <https://core.telegram.org/bots/api#payments>`_\n",
"name": "invoice",
"required": false
},
{
"type": "Location",
"description": "Message is a shared location, information about the location",
"html_description": "<td><em>Optional</em>. Message is a shared location, information about the location</td>",
"rst_description": "*Optional*. Message is a shared location, information about the location\n",
"name": "location",
"required": false
},
{
"type": "Poll",
"description": "Message is a native poll, information about the poll",
"html_description": "<td><em>Optional</em>. Message is a native poll, information about the poll</td>",
"rst_description": "*Optional*. Message is a native poll, information about the poll\n",
"name": "poll",
"required": false
},
{
"type": "Venue",
"description": "Message is a venue, information about the venue",
"html_description": "<td><em>Optional</em>. Message is a venue, information about the venue</td>",
"rst_description": "*Optional*. Message is a venue, information about the venue\n",
"name": "venue",
"required": false
}
],
"category": "types"
}
}

81
.butcher/types/Giveaway/entity.json Normal file
View file

@ -0,0 +1,81 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "giveaway",
"name": "Giveaway",
"description": "This object represents a message about a scheduled giveaway.",
"html_description": "<p>This object represents a message about a scheduled giveaway.</p>",
"rst_description": "This object represents a message about a scheduled giveaway.",
"annotations": [
{
"type": "Array of Chat",
"description": "The list of chats which the user must join to participate in the giveaway",
"html_description": "<td>The list of chats which the user must join to participate in the giveaway</td>",
"rst_description": "The list of chats which the user must join to participate in the giveaway\n",
"name": "chats",
"required": true
},
{
"type": "Integer",
"description": "Point in time (Unix timestamp) when winners of the giveaway will be selected",
"html_description": "<td>Point in time (Unix timestamp) when winners of the giveaway will be selected</td>",
"rst_description": "Point in time (Unix timestamp) when winners of the giveaway will be selected\n",
"name": "winners_selection_date",
"required": true
},
{
"type": "Integer",
"description": "The number of users which are supposed to be selected as winners of the giveaway",
"html_description": "<td>The number of users which are supposed to be selected as winners of the giveaway</td>",
"rst_description": "The number of users which are supposed to be selected as winners of the giveaway\n",
"name": "winner_count",
"required": true
},
{
"type": "True",
"description": "True, if only users who join the chats after the giveaway started should be eligible to win",
"html_description": "<td><em>Optional</em>. <em>True</em>, if only users who join the chats after the giveaway started should be eligible to win</td>",
"rst_description": "*Optional*. :code:`True`, if only users who join the chats after the giveaway started should be eligible to win\n",
"name": "only_new_members",
"required": false
},
{
"type": "True",
"description": "True, if the list of giveaway winners will be visible to everyone",
"html_description": "<td><em>Optional</em>. <em>True</em>, if the list of giveaway winners will be visible to everyone</td>",
"rst_description": "*Optional*. :code:`True`, if the list of giveaway winners will be visible to everyone\n",
"name": "has_public_winners",
"required": false
},
{
"type": "String",
"description": "Description of additional giveaway prize",
"html_description": "<td><em>Optional</em>. Description of additional giveaway prize</td>",
"rst_description": "*Optional*. Description of additional giveaway prize\n",
"name": "prize_description",
"required": false
},
{
"type": "Array of String",
"description": "A list of two-letter ISO 3166-1 alpha-2 country codes indicating the countries from which eligible users for the giveaway must come. If empty, then all users can participate in the giveaway. Users with a phone number that was bought on Fragment can always participate in giveaways.",
"html_description": "<td><em>Optional</em>. A list of two-letter <a href=\"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2\">ISO 3166-1 alpha-2</a> country codes indicating the countries from which eligible users for the giveaway must come. If empty, then all users can participate in the giveaway. Users with a phone number that was bought on Fragment can always participate in giveaways.</td>",
"rst_description": "*Optional*. A list of two-letter `ISO 3166-1 alpha-2 <https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2>`_ country codes indicating the countries from which eligible users for the giveaway must come. If empty, then all users can participate in the giveaway. Users with a phone number that was bought on Fragment can always participate in giveaways.\n",
"name": "country_codes",
"required": false
},
{
"type": "Integer",
"description": "The number of months the Telegram Premium subscription won from the giveaway will be active for",
"html_description": "<td><em>Optional</em>. The number of months the Telegram Premium subscription won from the giveaway will be active for</td>",
"rst_description": "*Optional*. The number of months the Telegram Premium subscription won from the giveaway will be active for\n",
"name": "premium_subscription_month_count",
"required": false
}
],
"category": "types"
}
}

5
.butcher/types/Giveaway/replace.yml Normal file
View file

@ -0,0 +1,5 @@
annotations:
winners_selection_date:
parsed_type:
type: std
name: DateTime

41
.butcher/types/GiveawayCompleted/entity.json Normal file
View file

@ -0,0 +1,41 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "giveawaycompleted",
"name": "GiveawayCompleted",
"description": "This object represents a service message about the completion of a giveaway without public winners.",
"html_description": "<p>This object represents a service message about the completion of a giveaway without public winners.</p>",
"rst_description": "This object represents a service message about the completion of a giveaway without public winners.",
"annotations": [
{
"type": "Integer",
"description": "Number of winners in the giveaway",
"html_description": "<td>Number of winners in the giveaway</td>",
"rst_description": "Number of winners in the giveaway\n",
"name": "winner_count",
"required": true
},
{
"type": "Integer",
"description": "Number of undistributed prizes",
"html_description": "<td><em>Optional</em>. Number of undistributed prizes</td>",
"rst_description": "*Optional*. Number of undistributed prizes\n",
"name": "unclaimed_prize_count",
"required": false
},
{
"type": "Message",
"description": "Message with the giveaway that was completed, if it wasn't deleted",
"html_description": "<td><em>Optional</em>. Message with the giveaway that was completed, if it wasn't deleted</td>",
"rst_description": "*Optional*. Message with the giveaway that was completed, if it wasn't deleted\n",
"name": "giveaway_message",
"required": false
}
],
"category": "types"
}
}

16
.butcher/types/GiveawayCreated/entity.json Normal file
View file

@ -0,0 +1,16 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "giveawaycreated",
"name": "GiveawayCreated",
"description": "This object represents a service message about the creation of a scheduled giveaway. Currently holds no information.",
"html_description": "<p>This object represents a service message about the creation of a scheduled giveaway. Currently holds no information.</p>",
"rst_description": "This object represents a service message about the creation of a scheduled giveaway. Currently holds no information.",
"annotations": [],
"category": "types"
}
}

105
.butcher/types/GiveawayWinners/entity.json Normal file
View file

@ -0,0 +1,105 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "giveawaywinners",
"name": "GiveawayWinners",
"description": "This object represents a message about the completion of a giveaway with public winners.",
"html_description": "<p>This object represents a message about the completion of a giveaway with public winners.</p>",
"rst_description": "This object represents a message about the completion of a giveaway with public winners.",
"annotations": [
{
"type": "Chat",
"description": "The chat that created the giveaway",
"html_description": "<td>The chat that created the giveaway</td>",
"rst_description": "The chat that created the giveaway\n",
"name": "chat",
"required": true
},
{
"type": "Integer",
"description": "Identifier of the messsage with the giveaway in the chat",
"html_description": "<td>Identifier of the messsage with the giveaway in the chat</td>",
"rst_description": "Identifier of the messsage with the giveaway in the chat\n",
"name": "giveaway_message_id",
"required": true
},
{
"type": "Integer",
"description": "Point in time (Unix timestamp) when winners of the giveaway were selected",
"html_description": "<td>Point in time (Unix timestamp) when winners of the giveaway were selected</td>",
"rst_description": "Point in time (Unix timestamp) when winners of the giveaway were selected\n",
"name": "winners_selection_date",
"required": true
},
{
"type": "Integer",
"description": "Total number of winners in the giveaway",
"html_description": "<td>Total number of winners in the giveaway</td>",
"rst_description": "Total number of winners in the giveaway\n",
"name": "winner_count",
"required": true
},
{
"type": "Array of User",
"description": "List of up to 100 winners of the giveaway",
"html_description": "<td>List of up to 100 winners of the giveaway</td>",
"rst_description": "List of up to 100 winners of the giveaway\n",
"name": "winners",
"required": true
},
{
"type": "Integer",
"description": "The number of other chats the user had to join in order to be eligible for the giveaway",
"html_description": "<td><em>Optional</em>. The number of other chats the user had to join in order to be eligible for the giveaway</td>",
"rst_description": "*Optional*. The number of other chats the user had to join in order to be eligible for the giveaway\n",
"name": "additional_chat_count",
"required": false
},
{
"type": "Integer",
"description": "The number of months the Telegram Premium subscription won from the giveaway will be active for",
"html_description": "<td><em>Optional</em>. The number of months the Telegram Premium subscription won from the giveaway will be active for</td>",
"rst_description": "*Optional*. The number of months the Telegram Premium subscription won from the giveaway will be active for\n",
"name": "premium_subscription_month_count",
"required": false
},
{
"type": "Integer",
"description": "Number of undistributed prizes",
"html_description": "<td><em>Optional</em>. Number of undistributed prizes</td>",
"rst_description": "*Optional*. Number of undistributed prizes\n",
"name": "unclaimed_prize_count",
"required": false
},
{
"type": "True",
"description": "True, if only users who had joined the chats after the giveaway started were eligible to win",
"html_description": "<td><em>Optional</em>. <em>True</em>, if only users who had joined the chats after the giveaway started were eligible to win</td>",
"rst_description": "*Optional*. :code:`True`, if only users who had joined the chats after the giveaway started were eligible to win\n",
"name": "only_new_members",
"required": false
},
{
"type": "True",
"description": "True, if the giveaway was canceled because the payment for it was refunded",
"html_description": "<td><em>Optional</em>. <em>True</em>, if the giveaway was canceled because the payment for it was refunded</td>",
"rst_description": "*Optional*. :code:`True`, if the giveaway was canceled because the payment for it was refunded\n",
"name": "was_refunded",
"required": false
},
{
"type": "String",
"description": "Description of additional giveaway prize",
"html_description": "<td><em>Optional</em>. Description of additional giveaway prize</td>",
"rst_description": "*Optional*. Description of additional giveaway prize\n",
"name": "prize_description",
"required": false
}
],
"category": "types"
}
}

5
.butcher/types/GiveawayWinners/replace.yml Normal file
View file

@ -0,0 +1,5 @@
annotations:
winners_selection_date:
parsed_type:
type: std
name: DateTime

41
.butcher/types/InaccessibleMessage/entity.json Normal file
View file

@ -0,0 +1,41 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "inaccessiblemessage",
"name": "InaccessibleMessage",
"description": "This object describes a message that was deleted or is otherwise inaccessible to the bot.",
"html_description": "<p>This object describes a message that was deleted or is otherwise inaccessible to the bot.</p>",
"rst_description": "This object describes a message that was deleted or is otherwise inaccessible to the bot.",
"annotations": [
{
"type": "Chat",
"description": "Chat the message belonged to",
"html_description": "<td>Chat the message belonged to</td>",
"rst_description": "Chat the message belonged to\n",
"name": "chat",
"required": true
},
{
"type": "Integer",
"description": "Unique message identifier inside the chat",
"html_description": "<td>Unique message identifier inside the chat</td>",
"rst_description": "Unique message identifier inside the chat\n",
"name": "message_id",
"required": true
},
{
"type": "Integer",
"description": "Always 0. The field can be used to differentiate regular and inaccessible messages.",
"html_description": "<td>Always 0. The field can be used to differentiate regular and inaccessible messages.</td>",
"rst_description": "Always 0. The field can be used to differentiate regular and inaccessible messages.\n",
"name": "date",
"required": true
}
],
"category": "types"
}
}

7
.butcher/types/InaccessibleMessage/replace.yml Normal file
View file

@ -0,0 +1,7 @@
annotations:
date:
# date:
# type: std
# name: DateTime
const: "0"
# final: true

14
.butcher/types/InputTextMessageContent/entity.json
View file

@ -35,13 +35,25 @@
"name": "entities",
"required": false
},
{
"type": "LinkPreviewOptions",
"description": "Link preview generation options for the message",
"html_description": "<td><em>Optional</em>. Link preview generation options for the message</td>",
"rst_description": "*Optional*. Link preview generation options for the message\n",
"name": "link_preview_options",
"required": false
},
{
"type": "Boolean",
"description": "Disables link previews for links in the sent message",
"html_description": "<td><em>Optional</em>. Disables link previews for links in the sent message</td>",
"rst_description": "*Optional*. Disables link previews for links in the sent message\n",
"name": "disable_web_page_preview",
"required": false
"required": false,
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "types"

28
.butcher/types/KeyboardButton/entity.json
View file

@ -7,9 +7,9 @@
"object": {
"anchor": "keyboardbutton",
"name": "KeyboardButton",
"description": "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_user, request_chat, request_contact, request_location, and request_poll are mutually exclusive.\nNote: request_contact and request_location options will only work in Telegram versions released after 9 April, 2016. Older clients will display unsupported message.\nNote: request_poll option will only work in Telegram versions released after 23 January, 2020. Older clients will display unsupported message.\nNote: web_app option will only work in Telegram versions released after 16 April, 2022. Older clients will display unsupported message.\nNote: request_user and request_chat options will only work in Telegram versions released after 3 February, 2023. Older clients will display unsupported message.",
"html_description": "<p>This object represents one button of the reply keyboard. For simple text buttons, <em>String</em> can be used instead of this object to specify the button text. The optional fields <em>web_app</em>, <em>request_user</em>, <em>request_chat</em>, <em>request_contact</em>, <em>request_location</em>, and <em>request_poll</em> are mutually exclusive.</p><p><strong>Note:</strong> <em>request_contact</em> and <em>request_location</em> options will only work in Telegram versions released after 9 April, 2016. Older clients will display <em>unsupported message</em>.<br/>\n<strong>Note:</strong> <em>request_poll</em> option will only work in Telegram versions released after 23 January, 2020. Older clients will display <em>unsupported message</em>.<br/>\n<strong>Note:</strong> <em>web_app</em> option will only work in Telegram versions released after 16 April, 2022. Older clients will display <em>unsupported message</em>.<br/>\n<strong>Note:</strong> <em>request_user</em> and <em>request_chat</em> options will only work in Telegram versions released after 3 February, 2023. Older clients will display <em>unsupported message</em>.</p>",
"rst_description": "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_user*, *request_chat*, *request_contact*, *request_location*, and *request_poll* are mutually exclusive.\n**Note:** *request_contact* and *request_location* options will only work in Telegram versions released after 9 April, 2016. Older clients will display *unsupported message*.\n\n**Note:** *request_poll* option will only work in Telegram versions released after 23 January, 2020. Older clients will display *unsupported message*.\n\n**Note:** *web_app* option will only work in Telegram versions released after 16 April, 2022. Older clients will display *unsupported message*.\n\n**Note:** *request_user* and *request_chat* options will only work in Telegram versions released after 3 February, 2023. Older clients will display *unsupported message*.",
"description": "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.\nNote: request_contact and request_location options will only work in Telegram versions released after 9 April, 2016. Older clients will display unsupported message.\nNote: request_poll option will only work in Telegram versions released after 23 January, 2020. Older clients will display unsupported message.\nNote: web_app option will only work in Telegram versions released after 16 April, 2022. Older clients will display unsupported message.\nNote: request_users and request_chat options will only work in Telegram versions released after 3 February, 2023. Older clients will display unsupported message.",
"html_description": "<p>This object represents one button of the reply keyboard. For simple text buttons, <em>String</em> can be used instead of this object to specify the button text. The optional fields <em>web_app</em>, <em>request_users</em>, <em>request_chat</em>, <em>request_contact</em>, <em>request_location</em>, and <em>request_poll</em> are mutually exclusive.</p><p><strong>Note:</strong> <em>request_contact</em> and <em>request_location</em> options will only work in Telegram versions released after 9 April, 2016. Older clients will display <em>unsupported message</em>.<br/>\n<strong>Note:</strong> <em>request_poll</em> option will only work in Telegram versions released after 23 January, 2020. Older clients will display <em>unsupported message</em>.<br/>\n<strong>Note:</strong> <em>web_app</em> option will only work in Telegram versions released after 16 April, 2022. Older clients will display <em>unsupported message</em>.<br/>\n<strong>Note:</strong> <em>request_users</em> and <em>request_chat</em> options will only work in Telegram versions released after 3 February, 2023. Older clients will display <em>unsupported message</em>.</p>",
"rst_description": "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.\n**Note:** *request_contact* and *request_location* options will only work in Telegram versions released after 9 April, 2016. Older clients will display *unsupported message*.\n\n**Note:** *request_poll* option will only work in Telegram versions released after 23 January, 2020. Older clients will display *unsupported message*.\n\n**Note:** *web_app* option will only work in Telegram versions released after 16 April, 2022. Older clients will display *unsupported message*.\n\n**Note:** *request_users* and *request_chat* options will only work in Telegram versions released after 3 February, 2023. Older clients will display *unsupported message*.",
"annotations": [
{
"type": "String",
@ -20,11 +20,11 @@
"required": true
},
{
"type": "KeyboardButtonRequestUser",
"description": "If specified, pressing the button will open a list of suitable users. Tapping on any user will send their identifier to the bot in a 'user_shared' service message. Available in private chats only.",
"html_description": "<td><em>Optional.</em> If specified, pressing the button will open a list of suitable users. Tapping on any user will send their identifier to the bot in a &#8220;user_shared&#8221; service message. Available in private chats only.</td>",
"rst_description": "*Optional.* If specified, pressing the button will open a list of suitable users. Tapping on any user will send their identifier to the bot in a 'user_shared' service message. Available in private chats only.\n",
"name": "request_user",
"type": "KeyboardButtonRequestUsers",
"description": "If specified, pressing the button will open a list of suitable users. Identifiers of selected users will be sent to the bot in a 'users_shared' service message. Available in private chats only.",
"html_description": "<td><em>Optional.</em> If specified, pressing the button will open a list of suitable users. Identifiers of selected users will be sent to the bot in a &#8220;users_shared&#8221; service message. Available in private chats only.</td>",
"rst_description": "*Optional.* If specified, pressing the button will open a list of suitable users. Identifiers of selected users will be sent to the bot in a 'users_shared' service message. Available in private chats only.\n",
"name": "request_users",
"required": false
},
{
@ -66,6 +66,18 @@
"rst_description": "*Optional*. If specified, the described `Web App <https://core.telegram.org/bots/webapps>`_ will be launched when the button is pressed. The Web App will be able to send a 'web_app_data' service message. Available in private chats only.\n",
"name": "web_app",
"required": false
},
{
"type": "KeyboardButtonRequestUser",
"description": "If specified, pressing the button will open a list of suitable users. Tapping on any user will send their identifier to the bot in a 'user_shared' service message. Available in private chats only.",
"html_description": "<td><em>Optional.</em> If specified, pressing the button will open a list of suitable users. Tapping on any user will send their identifier to the bot in a &#8220;user_shared&#8221; service message. Available in private chats only.</td>",
"rst_description": "*Optional.* If specified, pressing the button will open a list of suitable users. Tapping on any user will send their identifier to the bot in a 'user_shared' service message. Available in private chats only.\n",
"name": "request_user",
"required": false,
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "types"

7
.butcher/types/KeyboardButtonRequestUser/entity.json
View file

@ -1,5 +1,10 @@
{
"meta": {},
"meta": {
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
"group": {
"title": "Available types",
"anchor": "available-types"

49
.butcher/types/KeyboardButtonRequestUsers/entity.json Normal file
View file

@ -0,0 +1,49 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "keyboardbuttonrequestusers",
"name": "KeyboardButtonRequestUsers",
"description": "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.",
"html_description": "<p>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. <a href=\"/bots/features#chat-and-user-selection\">More about requesting users &#187;</a></p>",
"rst_description": "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>`_",
"annotations": [
{
"type": "Integer",
"description": "Signed 32-bit identifier of the request that will be received back in the UsersShared object. Must be unique within the message",
"html_description": "<td>Signed 32-bit identifier of the request that will be received back in the <a href=\"#usersshared\">UsersShared</a> object. Must be unique within the message</td>",
"rst_description": "Signed 32-bit identifier of the request that will be received back in the :class:`aiogram.types.users_shared.UsersShared` object. Must be unique within the message\n",
"name": "request_id",
"required": true
},
{
"type": "Boolean",
"description": "Pass True to request bots, pass False to request regular users. If not specified, no additional restrictions are applied.",
"html_description": "<td><em>Optional</em>. Pass <em>True</em> to request bots, pass <em>False</em> to request regular users. If not specified, no additional restrictions are applied.</td>",
"rst_description": "*Optional*. Pass :code:`True` to request bots, pass :code:`False` to request regular users. If not specified, no additional restrictions are applied.\n",
"name": "user_is_bot",
"required": false
},
{
"type": "Boolean",
"description": "Pass True to request premium users, pass False to request non-premium users. If not specified, no additional restrictions are applied.",
"html_description": "<td><em>Optional</em>. Pass <em>True</em> to request premium users, pass <em>False</em> to request non-premium users. If not specified, no additional restrictions are applied.</td>",
"rst_description": "*Optional*. Pass :code:`True` to request premium users, pass :code:`False` to request non-premium users. If not specified, no additional restrictions are applied.\n",
"name": "user_is_premium",
"required": false
},
{
"type": "Integer",
"description": "The maximum number of users to be selected; 1-10. Defaults to 1.",
"html_description": "<td><em>Optional</em>. The maximum number of users to be selected; 1-10. Defaults to 1.</td>",
"rst_description": "*Optional*. The maximum number of users to be selected; 1-10. Defaults to 1.\n",
"name": "max_quantity",
"required": false
}
],
"category": "types"
}
}

57
.butcher/types/LinkPreviewOptions/entity.json Normal file
View file

@ -0,0 +1,57 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "linkpreviewoptions",
"name": "LinkPreviewOptions",
"description": "Describes the options used for link preview generation.",
"html_description": "<p>Describes the options used for link preview generation.</p>",
"rst_description": "Describes the options used for link preview generation.",
"annotations": [
{
"type": "Boolean",
"description": "True, if the link preview is disabled",
"html_description": "<td><em>Optional</em>. <em>True</em>, if the link preview is disabled</td>",
"rst_description": "*Optional*. :code:`True`, if the link preview is disabled\n",
"name": "is_disabled",
"required": false
},
{
"type": "String",
"description": "URL to use for the link preview. If empty, then the first URL found in the message text will be used",
"html_description": "<td><em>Optional</em>. URL to use for the link preview. If empty, then the first URL found in the message text will be used</td>",
"rst_description": "*Optional*. URL to use for the link preview. If empty, then the first URL found in the message text will be used\n",
"name": "url",
"required": false
},
{
"type": "Boolean",
"description": "True, if the media in the link preview is suppposed to be shrunk; ignored if the URL isn't explicitly specified or media size change isn't supported for the preview",
"html_description": "<td><em>Optional</em>. <em>True</em>, if the media in the link preview is suppposed to be shrunk; ignored if the URL isn't explicitly specified or media size change isn't supported for the preview</td>",
"rst_description": "*Optional*. :code:`True`, if the media in the link preview is suppposed to be shrunk; ignored if the URL isn't explicitly specified or media size change isn't supported for the preview\n",
"name": "prefer_small_media",
"required": false
},
{
"type": "Boolean",
"description": "True, if the media in the link preview is suppposed to be enlarged; ignored if the URL isn't explicitly specified or media size change isn't supported for the preview",
"html_description": "<td><em>Optional</em>. <em>True</em>, if the media in the link preview is suppposed to be enlarged; ignored if the URL isn't explicitly specified or media size change isn't supported for the preview</td>",
"rst_description": "*Optional*. :code:`True`, if the media in the link preview is suppposed to be enlarged; ignored if the URL isn't explicitly specified or media size change isn't supported for the preview\n",
"name": "prefer_large_media",
"required": false
},
{
"type": "Boolean",
"description": "True, if the link preview must be shown above the message text; otherwise, the link preview will be shown below the message text",
"html_description": "<td><em>Optional</em>. <em>True</em>, if the link preview must be shown above the message text; otherwise, the link preview will be shown below the message text</td>",
"rst_description": "*Optional*. :code:`True`, if the link preview must be shown above the message text; otherwise, the link preview will be shown below the message text\n",
"name": "show_above_text",
"required": false
}
],
"category": "types"
}
}

16
.butcher/types/MaybeInaccessibleMessage/entity.json Normal file
View file

@ -0,0 +1,16 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "maybeinaccessiblemessage",
"name": "MaybeInaccessibleMessage",
"description": "This object describes a message that can be inaccessible to the bot. It can be one of\n - Message\n - InaccessibleMessage",
"html_description": "<p>This object describes a message that can be inaccessible to the bot. It can be one of</p><ul>\n<li><a href=\"#message\">Message</a></li>\n<li><a href=\"#inaccessiblemessage\">InaccessibleMessage</a></li>\n</ul>",
"rst_description": "This object describes a message that can be inaccessible to the bot. It can be one of\n\n - :class:`aiogram.types.message.Message`\n - :class:`aiogram.types.inaccessible_message.InaccessibleMessage`",
"annotations": [],
"category": "types"
}
}

1
.butcher/types/MaybeInaccessibleMessage/subtypes.yml Normal file
View file

@ -0,0 +1 @@
tagged: true

5
.butcher/types/Message/aliases.yml
View file

@ -240,3 +240,8 @@ unpin:
method: unpinChatMessage
code: *assert-chat
fill: *message-target
react:
method: setMessageReaction
code: *assert-chat
fill: *message-target

226
.butcher/types/Message/entity.json
View file

@ -45,66 +45,26 @@
},
{
"type": "Integer",
"description": "Date the message was sent in Unix time",
"html_description": "<td>Date the message was sent in Unix time</td>",
"rst_description": "Date the message was sent in Unix time\n",
"description": "Date the message was sent in Unix time. It is always a positive number, representing a valid date.",
"html_description": "<td>Date the message was sent in Unix time. It is always a positive number, representing a valid date.</td>",
"rst_description": "Date the message was sent in Unix time. It is always a positive number, representing a valid date.\n",
"name": "date",
"required": true
},
{
"type": "Chat",
"description": "Conversation the message belongs to",
"html_description": "<td>Conversation the message belongs to</td>",
"rst_description": "Conversation the message belongs to\n",
"description": "Chat the message belongs to",
"html_description": "<td>Chat the message belongs to</td>",
"rst_description": "Chat the message belongs to\n",
"name": "chat",
"required": true
},
{
"type": "User",
"description": "For forwarded messages, sender of the original message",
"html_description": "<td><em>Optional</em>. For forwarded messages, sender of the original message</td>",
"rst_description": "*Optional*. For forwarded messages, sender of the original message\n",
"name": "forward_from",
"required": false
},
{
"type": "Chat",
"description": "For messages forwarded from channels or from anonymous administrators, information about the original sender chat",
"html_description": "<td><em>Optional</em>. For messages forwarded from channels or from anonymous administrators, information about the original sender chat</td>",
"rst_description": "*Optional*. For messages forwarded from channels or from anonymous administrators, information about the original sender chat\n",
"name": "forward_from_chat",
"required": false
},
{
"type": "Integer",
"description": "For messages forwarded from channels, identifier of the original message in the channel",
"html_description": "<td><em>Optional</em>. For messages forwarded from channels, identifier of the original message in the channel</td>",
"rst_description": "*Optional*. For messages forwarded from channels, identifier of the original message in the channel\n",
"name": "forward_from_message_id",
"required": false
},
{
"type": "String",
"description": "For forwarded messages that were originally sent in channels or by an anonymous chat administrator, signature of the message sender if present",
"html_description": "<td><em>Optional</em>. For forwarded messages that were originally sent in channels or by an anonymous chat administrator, signature of the message sender if present</td>",
"rst_description": "*Optional*. For forwarded messages that were originally sent in channels or by an anonymous chat administrator, signature of the message sender if present\n",
"name": "forward_signature",
"required": false
},
{
"type": "String",
"description": "Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages",
"html_description": "<td><em>Optional</em>. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages</td>",
"rst_description": "*Optional*. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages\n",
"name": "forward_sender_name",
"required": false
},
{
"type": "Integer",
"description": "For forwarded messages, date the original message was sent in Unix time",
"html_description": "<td><em>Optional</em>. For forwarded messages, date the original message was sent in Unix time</td>",
"rst_description": "*Optional*. For forwarded messages, date the original message was sent in Unix time\n",
"name": "forward_date",
"type": "MessageOrigin",
"description": "Information about the original message for forwarded messages",
"html_description": "<td><em>Optional</em>. Information about the original message for forwarded messages</td>",
"rst_description": "*Optional*. Information about the original message for forwarded messages\n",
"name": "forward_origin",
"required": false
},
{
@ -125,12 +85,28 @@
},
{
"type": "Message",
"description": "For replies, the original message. Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply.",
"html_description": "<td><em>Optional</em>. For replies, the original message. Note that the Message object in this field will not contain further <em>reply_to_message</em> fields even if it itself is a reply.</td>",
"rst_description": "*Optional*. For replies, the original message. Note that the Message object in this field will not contain further *reply_to_message* fields even if it itself is a reply.\n",
"description": "For replies in the same chat and message thread, the original message. Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply.",
"html_description": "<td><em>Optional</em>. For replies in the same chat and message thread, the original message. Note that the Message object in this field will not contain further <em>reply_to_message</em> fields even if it itself is a reply.</td>",
"rst_description": "*Optional*. For replies in the same chat and message thread, the original message. Note that the Message object in this field will not contain further *reply_to_message* fields even if it itself is a reply.\n",
"name": "reply_to_message",
"required": false
},
{
"type": "ExternalReplyInfo",
"description": "Information about the message that is being replied to, which may come from another chat or forum topic",
"html_description": "<td><em>Optional</em>. Information about the message that is being replied to, which may come from another chat or forum topic</td>",
"rst_description": "*Optional*. Information about the message that is being replied to, which may come from another chat or forum topic\n",
"name": "external_reply",
"required": false
},
{
"type": "TextQuote",
"description": "For replies that quote part of the original message, the quoted part of the message",
"html_description": "<td><em>Optional</em>. For replies that quote part of the original message, the quoted part of the message</td>",
"rst_description": "*Optional*. For replies that quote part of the original message, the quoted part of the message\n",
"name": "quote",
"required": false
},
{
"type": "User",
"description": "Bot through which the message was sent",
@ -187,6 +163,14 @@
"name": "entities",
"required": false
},
{
"type": "LinkPreviewOptions",
"description": "Options used for link preview generation for the message, if it is a text message and link preview options were changed",
"html_description": "<td><em>Optional</em>. Options used for link preview generation for the message, if it is a text message and link preview options were changed</td>",
"rst_description": "*Optional*. Options used for link preview generation for the message, if it is a text message and link preview options were changed\n",
"name": "link_preview_options",
"required": false
},
{
"type": "Animation",
"description": "Message is an animation, information about the animation. For backward compatibility, when this field is set, the document field will also be set",
@ -420,10 +404,10 @@
"required": false
},
{
"type": "Message",
"description": "Specified message was pinned. Note that the Message object in this field will not contain further reply_to_message fields even if it is itself a reply.",
"html_description": "<td><em>Optional</em>. Specified message was pinned. Note that the Message object in this field will not contain further <em>reply_to_message</em> fields even if it is itself a reply.</td>",
"rst_description": "*Optional*. Specified message was pinned. Note that the Message object in this field will not contain further *reply_to_message* fields even if it is itself a reply.\n",
"type": "MaybeInaccessibleMessage",
"description": "Specified message was pinned. Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply.",
"html_description": "<td><em>Optional</em>. Specified message was pinned. Note that the Message object in this field will not contain further <em>reply_to_message</em> fields even if it itself is a reply.</td>",
"rst_description": "*Optional*. Specified message was pinned. Note that the Message object in this field will not contain further *reply_to_message* fields even if it itself is a reply.\n",
"name": "pinned_message",
"required": false
},
@ -444,11 +428,11 @@
"required": false
},
{
"type": "UserShared",
"description": "Service message: a user was shared with the bot",
"html_description": "<td><em>Optional</em>. Service message: a user was shared with the bot</td>",
"rst_description": "*Optional*. Service message: a user was shared with the bot\n",
"name": "user_shared",
"type": "UsersShared",
"description": "Service message: users were shared with the bot",
"html_description": "<td><em>Optional</em>. Service message: users were shared with the bot</td>",
"rst_description": "*Optional*. Service message: users were shared with the bot\n",
"name": "users_shared",
"required": false
},
{
@ -539,6 +523,38 @@
"name": "general_forum_topic_unhidden",
"required": false
},
{
"type": "GiveawayCreated",
"description": "Service message: a scheduled giveaway was created",
"html_description": "<td><em>Optional</em>. Service message: a scheduled giveaway was created</td>",
"rst_description": "*Optional*. Service message: a scheduled giveaway was created\n",
"name": "giveaway_created",
"required": false
},
{
"type": "Giveaway",
"description": "The message is a scheduled giveaway message",
"html_description": "<td><em>Optional</em>. The message is a scheduled giveaway message</td>",
"rst_description": "*Optional*. The message is a scheduled giveaway message\n",
"name": "giveaway",
"required": false
},
{
"type": "GiveawayWinners",
"description": "A giveaway with public winners was completed",
"html_description": "<td><em>Optional</em>. A giveaway with public winners was completed</td>",
"rst_description": "*Optional*. A giveaway with public winners was completed\n",
"name": "giveaway_winners",
"required": false
},
{
"type": "GiveawayCompleted",
"description": "Service message: a giveaway without public winners was completed",
"html_description": "<td><em>Optional</em>. Service message: a giveaway without public winners was completed</td>",
"rst_description": "*Optional*. Service message: a giveaway without public winners was completed\n",
"name": "giveaway_completed",
"required": false
},
{
"type": "VideoChatScheduled",
"description": "Service message: video chat scheduled",
@ -586,6 +602,90 @@
"rst_description": "*Optional*. Inline keyboard attached to the message. :code:`login_url` buttons are represented as ordinary :code:`url` buttons.\n",
"name": "reply_markup",
"required": false
},
{
"type": "Integer",
"description": "For forwarded messages, date the original message was sent in Unix time",
"html_description": "<td><em>Optional</em>. For forwarded messages, date the original message was sent in Unix time</td>",
"rst_description": "*Optional*. For forwarded messages, date the original message was sent in Unix time\n",
"name": "forward_date",
"required": false,
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "User",
"description": "For forwarded messages, sender of the original message",
"html_description": "<td><em>Optional</em>. For forwarded messages, sender of the original message</td>",
"rst_description": "*Optional*. For forwarded messages, sender of the original message\n",
"name": "forward_from",
"required": false,
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Chat",
"description": "For messages forwarded from channels or from anonymous administrators, information about the original sender chat",
"html_description": "<td><em>Optional</em>. For messages forwarded from channels or from anonymous administrators, information about the original sender chat</td>",
"rst_description": "*Optional*. For messages forwarded from channels or from anonymous administrators, information about the original sender chat\n",
"name": "forward_from_chat",
"required": false,
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "Integer",
"description": "For messages forwarded from channels, identifier of the original message in the channel",
"html_description": "<td><em>Optional</em>. For messages forwarded from channels, identifier of the original message in the channel</td>",
"rst_description": "*Optional*. For messages forwarded from channels, identifier of the original message in the channel\n",
"name": "forward_from_message_id",
"required": false,
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "String",
"description": "Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages",
"html_description": "<td><em>Optional</em>. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages</td>",
"rst_description": "*Optional*. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages\n",
"name": "forward_sender_name",
"required": false,
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "String",
"description": "For forwarded messages that were originally sent in channels or by an anonymous chat administrator, signature of the message sender if present",
"html_description": "<td><em>Optional</em>. For forwarded messages that were originally sent in channels or by an anonymous chat administrator, signature of the message sender if present</td>",
"rst_description": "*Optional*. For forwarded messages that were originally sent in channels or by an anonymous chat administrator, signature of the message sender if present\n",
"name": "forward_signature",
"required": false,
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
{
"type": "UserShared",
"description": "Service message: a user was shared with the bot",
"html_description": "<td><em>Optional</em>. Service message: a user was shared with the bot</td>",
"rst_description": "*Optional*. Service message: a user was shared with the bot\n",
"name": "user_shared",
"required": false,
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
}
],
"category": "types"

6
.butcher/types/MessageEntity/entity.json
View file

@ -13,9 +13,9 @@
"annotations": [
{
"type": "String",
"description": "Type of the entity. Currently, can be 'mention' (@username), 'hashtag' (#hashtag), 'cashtag' ($USD), 'bot_command' (/start@jobs_bot), 'url' (https://telegram.org), 'email' (do-not-reply@telegram.org), 'phone_number' (+1-212-555-0123), 'bold' (bold text), 'italic' (italic text), 'underline' (underlined text), 'strikethrough' (strikethrough text), 'spoiler' (spoiler message), 'code' (monowidth string), 'pre' (monowidth block), 'text_link' (for clickable text URLs), 'text_mention' (for users without usernames), 'custom_emoji' (for inline custom emoji stickers)",
"html_description": "<td>Type of the entity. Currently, can be &#8220;mention&#8221; (<code>@username</code>), &#8220;hashtag&#8221; (<code>#hashtag</code>), &#8220;cashtag&#8221; (<code>$USD</code>), &#8220;bot_command&#8221; (<code>/start@jobs_bot</code>), &#8220;url&#8221; (<code>https://telegram.org</code>), &#8220;email&#8221; (<code>do-not-reply@telegram.org</code>), &#8220;phone_number&#8221; (<code>+1-212-555-0123</code>), &#8220;bold&#8221; (<strong>bold text</strong>), &#8220;italic&#8221; (<em>italic text</em>), &#8220;underline&#8221; (underlined text), &#8220;strikethrough&#8221; (strikethrough text), &#8220;spoiler&#8221; (spoiler message), &#8220;code&#8221; (monowidth string), &#8220;pre&#8221; (monowidth block), &#8220;text_link&#8221; (for clickable text URLs), &#8220;text_mention&#8221; (for users <a href=\"https://telegram.org/blog/edit#new-mentions\">without usernames</a>), &#8220;custom_emoji&#8221; (for inline custom emoji stickers)</td>",
"rst_description": "Type of the entity. Currently, can be 'mention' (:code:`@username`), 'hashtag' (:code:`#hashtag`), 'cashtag' (:code:`$USD`), 'bot_command' (:code:`/start@jobs_bot`), 'url' (:code:`https://telegram.org`), 'email' (:code:`do-not-reply@telegram.org`), 'phone_number' (:code:`+1-212-555-0123`), 'bold' (**bold text**), 'italic' (*italic text*), 'underline' (underlined text), 'strikethrough' (strikethrough text), 'spoiler' (spoiler message), 'code' (monowidth string), 'pre' (monowidth block), 'text_link' (for clickable text URLs), 'text_mention' (for users `without usernames <https://telegram.org/blog/edit#new-mentions>`_), 'custom_emoji' (for inline custom emoji stickers)\n",
"description": "Type of the entity. Currently, can be 'mention' (@username), 'hashtag' (#hashtag), 'cashtag' ($USD), 'bot_command' (/start@jobs_bot), 'url' (https://telegram.org), 'email' (do-not-reply@telegram.org), 'phone_number' (+1-212-555-0123), 'bold' (bold text), 'italic' (italic text), 'underline' (underlined text), 'strikethrough' (strikethrough text), 'spoiler' (spoiler message), 'blockquote' (block quotation), 'code' (monowidth string), 'pre' (monowidth block), 'text_link' (for clickable text URLs), 'text_mention' (for users without usernames), 'custom_emoji' (for inline custom emoji stickers)",
"html_description": "<td>Type of the entity. Currently, can be &#8220;mention&#8221; (<code>@username</code>), &#8220;hashtag&#8221; (<code>#hashtag</code>), &#8220;cashtag&#8221; (<code>$USD</code>), &#8220;bot_command&#8221; (<code>/start@jobs_bot</code>), &#8220;url&#8221; (<code>https://telegram.org</code>), &#8220;email&#8221; (<code>do-not-reply@telegram.org</code>), &#8220;phone_number&#8221; (<code>+1-212-555-0123</code>), &#8220;bold&#8221; (<strong>bold text</strong>), &#8220;italic&#8221; (<em>italic text</em>), &#8220;underline&#8221; (underlined text), &#8220;strikethrough&#8221; (strikethrough text), &#8220;spoiler&#8221; (spoiler message), &#8220;blockquote&#8221; (block quotation), &#8220;code&#8221; (monowidth string), &#8220;pre&#8221; (monowidth block), &#8220;text_link&#8221; (for clickable text URLs), &#8220;text_mention&#8221; (for users <a href=\"https://telegram.org/blog/edit#new-mentions\">without usernames</a>), &#8220;custom_emoji&#8221; (for inline custom emoji stickers)</td>",
"rst_description": "Type of the entity. Currently, can be 'mention' (:code:`@username`), 'hashtag' (:code:`#hashtag`), 'cashtag' (:code:`$USD`), 'bot_command' (:code:`/start@jobs_bot`), 'url' (:code:`https://telegram.org`), 'email' (:code:`do-not-reply@telegram.org`), 'phone_number' (:code:`+1-212-555-0123`), 'bold' (**bold text**), 'italic' (*italic text*), 'underline' (underlined text), 'strikethrough' (strikethrough text), 'spoiler' (spoiler message), 'blockquote' (block quotation), 'code' (monowidth string), 'pre' (monowidth block), 'text_link' (for clickable text URLs), 'text_mention' (for users `without usernames <https://telegram.org/blog/edit#new-mentions>`_), 'custom_emoji' (for inline custom emoji stickers)\n",
"name": "type",
"required": true
},

16
.butcher/types/MessageOrigin/entity.json Normal file
View file

@ -0,0 +1,16 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "messageorigin",
"name": "MessageOrigin",
"description": "This object describes the origin of a message. It can be one of\n - MessageOriginUser\n - MessageOriginHiddenUser\n - MessageOriginChat\n - MessageOriginChannel",
"html_description": "<p>This object describes the origin of a message. It can be one of</p><ul>\n<li><a href=\"#messageoriginuser\">MessageOriginUser</a></li>\n<li><a href=\"#messageoriginhiddenuser\">MessageOriginHiddenUser</a></li>\n<li><a href=\"#messageoriginchat\">MessageOriginChat</a></li>\n<li><a href=\"#messageoriginchannel\">MessageOriginChannel</a></li>\n</ul>",
"rst_description": "This object describes the origin of a message. It can be one of\n\n - :class:`aiogram.types.message_origin_user.MessageOriginUser`\n - :class:`aiogram.types.message_origin_hidden_user.MessageOriginHiddenUser`\n - :class:`aiogram.types.message_origin_chat.MessageOriginChat`\n - :class:`aiogram.types.message_origin_channel.MessageOriginChannel`",
"annotations": [],
"category": "types"
}
}

1
.butcher/types/MessageOrigin/subtypes.yml Normal file
View file

@ -0,0 +1 @@
discriminator: "type"

57
.butcher/types/MessageOriginChannel/entity.json Normal file
View file

@ -0,0 +1,57 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "messageoriginchannel",
"name": "MessageOriginChannel",
"description": "The message was originally sent to a channel chat.",
"html_description": "<p>The message was originally sent to a channel chat.</p>",
"rst_description": "The message was originally sent to a channel chat.",
"annotations": [
{
"type": "String",
"description": "Type of the message origin, always 'channel'",
"html_description": "<td>Type of the message origin, always &#8220;channel&#8221;</td>",
"rst_description": "Type of the message origin, always 'channel'\n",
"name": "type",
"required": true
},
{
"type": "Integer",
"description": "Date the message was sent originally in Unix time",
"html_description": "<td>Date the message was sent originally in Unix time</td>",
"rst_description": "Date the message was sent originally in Unix time\n",
"name": "date",
"required": true
},
{
"type": "Chat",
"description": "Channel chat to which the message was originally sent",
"html_description": "<td>Channel chat to which the message was originally sent</td>",
"rst_description": "Channel chat to which the message was originally sent\n",
"name": "chat",
"required": true
},
{
"type": "Integer",
"description": "Unique message identifier inside the chat",
"html_description": "<td>Unique message identifier inside the chat</td>",
"rst_description": "Unique message identifier inside the chat\n",
"name": "message_id",
"required": true
},
{
"type": "String",
"description": "Signature of the original post author",
"html_description": "<td><em>Optional</em>. Signature of the original post author</td>",
"rst_description": "*Optional*. Signature of the original post author\n",
"name": "author_signature",
"required": false
}
],
"category": "types"
}
}

5
.butcher/types/MessageOriginChannel/replace.yml Normal file
View file

@ -0,0 +1,5 @@
annotations:
date:
parsed_type:
type: std
name: DateTime

49
.butcher/types/MessageOriginChat/entity.json Normal file
View file

@ -0,0 +1,49 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "messageoriginchat",
"name": "MessageOriginChat",
"description": "The message was originally sent on behalf of a chat to a group chat.",
"html_description": "<p>The message was originally sent on behalf of a chat to a group chat.</p>",
"rst_description": "The message was originally sent on behalf of a chat to a group chat.",
"annotations": [
{
"type": "String",
"description": "Type of the message origin, always 'chat'",
"html_description": "<td>Type of the message origin, always &#8220;chat&#8221;</td>",
"rst_description": "Type of the message origin, always 'chat'\n",
"name": "type",
"required": true
},
{
"type": "Integer",
"description": "Date the message was sent originally in Unix time",
"html_description": "<td>Date the message was sent originally in Unix time</td>",
"rst_description": "Date the message was sent originally in Unix time\n",
"name": "date",
"required": true
},
{
"type": "Chat",
"description": "Chat that sent the message originally",
"html_description": "<td>Chat that sent the message originally</td>",
"rst_description": "Chat that sent the message originally\n",
"name": "sender_chat",
"required": true
},
{
"type": "String",
"description": "For messages originally sent by an anonymous chat administrator, original message author signature",
"html_description": "<td><em>Optional</em>. For messages originally sent by an anonymous chat administrator, original message author signature</td>",
"rst_description": "*Optional*. For messages originally sent by an anonymous chat administrator, original message author signature\n",
"name": "author_signature",
"required": false
}
],
"category": "types"
}
}

5
.butcher/types/MessageOriginChat/replace.yml Normal file
View file

@ -0,0 +1,5 @@
annotations:
date:
parsed_type:
type: std
name: DateTime

41
.butcher/types/MessageOriginHiddenUser/entity.json Normal file
View file

@ -0,0 +1,41 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "messageoriginhiddenuser",
"name": "MessageOriginHiddenUser",
"description": "The message was originally sent by an unknown user.",
"html_description": "<p>The message was originally sent by an unknown user.</p>",
"rst_description": "The message was originally sent by an unknown user.",
"annotations": [
{
"type": "String",
"description": "Type of the message origin, always 'hidden_user'",
"html_description": "<td>Type of the message origin, always &#8220;hidden_user&#8221;</td>",
"rst_description": "Type of the message origin, always 'hidden_user'\n",
"name": "type",
"required": true
},
{
"type": "Integer",
"description": "Date the message was sent originally in Unix time",
"html_description": "<td>Date the message was sent originally in Unix time</td>",
"rst_description": "Date the message was sent originally in Unix time\n",
"name": "date",
"required": true
},
{
"type": "String",
"description": "Name of the user that sent the message originally",
"html_description": "<td>Name of the user that sent the message originally</td>",
"rst_description": "Name of the user that sent the message originally\n",
"name": "sender_user_name",
"required": true
}
],
"category": "types"
}
}

5
.butcher/types/MessageOriginHiddenUser/replace.yml Normal file
View file

@ -0,0 +1,5 @@
annotations:
date:
parsed_type:
type: std
name: DateTime

41
.butcher/types/MessageOriginUser/entity.json Normal file
View file

@ -0,0 +1,41 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "messageoriginuser",
"name": "MessageOriginUser",
"description": "The message was originally sent by a known user.",
"html_description": "<p>The message was originally sent by a known user.</p>",
"rst_description": "The message was originally sent by a known user.",
"annotations": [
{
"type": "String",
"description": "Type of the message origin, always 'user'",
"html_description": "<td>Type of the message origin, always &#8220;user&#8221;</td>",
"rst_description": "Type of the message origin, always 'user'\n",
"name": "type",
"required": true
},
{
"type": "Integer",
"description": "Date the message was sent originally in Unix time",
"html_description": "<td>Date the message was sent originally in Unix time</td>",
"rst_description": "Date the message was sent originally in Unix time\n",
"name": "date",
"required": true
},
{
"type": "User",
"description": "User that sent the message originally",
"html_description": "<td>User that sent the message originally</td>",
"rst_description": "User that sent the message originally\n",
"name": "sender_user",
"required": true
}
],
"category": "types"
}
}

5
.butcher/types/MessageOriginUser/replace.yml Normal file
View file

@ -0,0 +1,5 @@
annotations:
date:
parsed_type:
type: std
name: DateTime

49
.butcher/types/MessageReactionCountUpdated/entity.json Normal file
View file

@ -0,0 +1,49 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "messagereactioncountupdated",
"name": "MessageReactionCountUpdated",
"description": "This object represents reaction changes on a message with anonymous reactions.",
"html_description": "<p>This object represents reaction changes on a message with anonymous reactions.</p>",
"rst_description": "This object represents reaction changes on a message with anonymous reactions.",
"annotations": [
{
"type": "Chat",
"description": "The chat containing the message",
"html_description": "<td>The chat containing the message</td>",
"rst_description": "The chat containing the message\n",
"name": "chat",
"required": true
},
{
"type": "Integer",
"description": "Unique message identifier inside the chat",
"html_description": "<td>Unique message identifier inside the chat</td>",
"rst_description": "Unique message identifier inside the chat\n",
"name": "message_id",
"required": true
},
{
"type": "Integer",
"description": "Date of the change in Unix time",
"html_description": "<td>Date of the change in Unix time</td>",
"rst_description": "Date of the change in Unix time\n",
"name": "date",
"required": true
},
{
"type": "Array of ReactionCount",
"description": "List of reactions that are present on the message",
"html_description": "<td>List of reactions that are present on the message</td>",
"rst_description": "List of reactions that are present on the message\n",
"name": "reactions",
"required": true
}
],
"category": "types"
}
}

5
.butcher/types/MessageReactionCountUpdated/replace.yml Normal file
View file

@ -0,0 +1,5 @@
annotations:
date:
parsed_type:
type: std
name: DateTime

73
.butcher/types/MessageReactionUpdated/entity.json Normal file
View file

@ -0,0 +1,73 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "messagereactionupdated",
"name": "MessageReactionUpdated",
"description": "This object represents a change of a reaction on a message performed by a user.",
"html_description": "<p>This object represents a change of a reaction on a message performed by a user.</p>",
"rst_description": "This object represents a change of a reaction on a message performed by a user.",
"annotations": [
{
"type": "Chat",
"description": "The chat containing the message the user reacted to",
"html_description": "<td>The chat containing the message the user reacted to</td>",
"rst_description": "The chat containing the message the user reacted to\n",
"name": "chat",
"required": true
},
{
"type": "Integer",
"description": "Unique identifier of the message inside the chat",
"html_description": "<td>Unique identifier of the message inside the chat</td>",
"rst_description": "Unique identifier of the message inside the chat\n",
"name": "message_id",
"required": true
},
{
"type": "User",
"description": "The user that changed the reaction, if the user isn't anonymous",
"html_description": "<td><em>Optional</em>. The user that changed the reaction, if the user isn't anonymous</td>",
"rst_description": "*Optional*. The user that changed the reaction, if the user isn't anonymous\n",
"name": "user",
"required": false
},
{
"type": "Chat",
"description": "The chat on behalf of which the reaction was changed, if the user is anonymous",
"html_description": "<td><em>Optional</em>. The chat on behalf of which the reaction was changed, if the user is anonymous</td>",
"rst_description": "*Optional*. The chat on behalf of which the reaction was changed, if the user is anonymous\n",
"name": "actor_chat",
"required": false
},
{
"type": "Integer",
"description": "Date of the change in Unix time",
"html_description": "<td>Date of the change in Unix time</td>",
"rst_description": "Date of the change in Unix time\n",
"name": "date",
"required": true
},
{
"type": "Array of ReactionType",
"description": "Previous list of reaction types that were set by the user",
"html_description": "<td>Previous list of reaction types that were set by the user</td>",
"rst_description": "Previous list of reaction types that were set by the user\n",
"name": "old_reaction",
"required": true
},
{
"type": "Array of ReactionType",
"description": "New list of reaction types that have been set by the user",
"html_description": "<td>New list of reaction types that have been set by the user</td>",
"rst_description": "New list of reaction types that have been set by the user\n",
"name": "new_reaction",
"required": true
}
],
"category": "types"
}
}

5
.butcher/types/MessageReactionUpdated/replace.yml Normal file
View file

@ -0,0 +1,5 @@
annotations:
date:
parsed_type:
type: std
name: DateTime

5
.butcher/types/PassportFile/replace.yml Normal file
View file

@ -0,0 +1,5 @@
annotations:
file_date:
parsed_type:
type: std
name: DateTime

33
.butcher/types/ReactionCount/entity.json Normal file
View file

@ -0,0 +1,33 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "reactioncount",
"name": "ReactionCount",
"description": "Represents a reaction added to a message along with the number of times it was added.",
"html_description": "<p>Represents a reaction added to a message along with the number of times it was added.</p>",
"rst_description": "Represents a reaction added to a message along with the number of times it was added.",
"annotations": [
{
"type": "ReactionType",
"description": "Type of the reaction",
"html_description": "<td>Type of the reaction</td>",
"rst_description": "Type of the reaction\n",
"name": "type",
"required": true
},
{
"type": "Integer",
"description": "Number of times the reaction was added",
"html_description": "<td>Number of times the reaction was added</td>",
"rst_description": "Number of times the reaction was added\n",
"name": "total_count",
"required": true
}
],
"category": "types"
}
}

16
.butcher/types/ReactionType/entity.json Normal file
View file

@ -0,0 +1,16 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "reactiontype",
"name": "ReactionType",
"description": "This object describes the type of a reaction. Currently, it can be one of\n - ReactionTypeEmoji\n - ReactionTypeCustomEmoji",
"html_description": "<p>This object describes the type of a reaction. Currently, it can be one of</p><ul>\n<li><a href=\"#reactiontypeemoji\">ReactionTypeEmoji</a></li>\n<li><a href=\"#reactiontypecustomemoji\">ReactionTypeCustomEmoji</a></li>\n</ul>",
"rst_description": "This object describes the type of a reaction. Currently, it can be one of\n\n - :class:`aiogram.types.reaction_type_emoji.ReactionTypeEmoji`\n - :class:`aiogram.types.reaction_type_custom_emoji.ReactionTypeCustomEmoji`",
"annotations": [],
"category": "types"
}
}

1
.butcher/types/ReactionType/subtypes.yml Normal file
View file

@ -0,0 +1 @@
discriminator: "type"

33
.butcher/types/ReactionTypeCustomEmoji/entity.json Normal file
View file

@ -0,0 +1,33 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "reactiontypecustomemoji",
"name": "ReactionTypeCustomEmoji",
"description": "The reaction is based on a custom emoji.",
"html_description": "<p>The reaction is based on a custom emoji.</p>",
"rst_description": "The reaction is based on a custom emoji.",
"annotations": [
{
"type": "String",
"description": "Type of the reaction, always 'custom_emoji'",
"html_description": "<td>Type of the reaction, always &#8220;custom_emoji&#8221;</td>",
"rst_description": "Type of the reaction, always 'custom_emoji'\n",
"name": "type",
"required": true
},
{
"type": "String",
"description": "Custom emoji identifier",
"html_description": "<td>Custom emoji identifier</td>",
"rst_description": "Custom emoji identifier\n",
"name": "custom_emoji_id",
"required": true
}
],
"category": "types"
}
}

33
.butcher/types/ReactionTypeEmoji/entity.json Normal file
View file

File diff suppressed because one or more lines are too long

73
.butcher/types/ReplyParameters/entity.json Normal file
View file

@ -0,0 +1,73 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "replyparameters",
"name": "ReplyParameters",
"description": "Describes reply parameters for the message that is being sent.",
"html_description": "<p>Describes reply parameters for the message that is being sent.</p>",
"rst_description": "Describes reply parameters for the message that is being sent.",
"annotations": [
{
"type": "Integer",
"description": "Identifier of the message that will be replied to in the current chat, or in the chat chat_id if it is specified",
"html_description": "<td>Identifier of the message that will be replied to in the current chat, or in the chat <em>chat_id</em> if it is specified</td>",
"rst_description": "Identifier of the message that will be replied to in the current chat, or in the chat *chat_id* if it is specified\n",
"name": "message_id",
"required": true
},
{
"type": "Integer or String",
"description": "If the message to be replied to is from a different chat, unique identifier for the chat or username of the channel (in the format @channelusername)",
"html_description": "<td><em>Optional</em>. If the message to be replied to is from a different chat, unique identifier for the chat or username of the channel (in the format <code>@channelusername</code>)</td>",
"rst_description": "*Optional*. If the message to be replied to is from a different chat, unique identifier for the chat or username of the channel (in the format :code:`@channelusername`)\n",
"name": "chat_id",
"required": false
},
{
"type": "Boolean",
"description": "Pass True if the message should be sent even if the specified message to be replied to is not found; can be used only for replies in the same chat and forum topic.",
"html_description": "<td><em>Optional</em>. Pass <em>True</em> if the message should be sent even if the specified message to be replied to is not found; can be used only for replies in the same chat and forum topic.</td>",
"rst_description": "*Optional*. Pass :code:`True` if the message should be sent even if the specified message to be replied to is not found; can be used only for replies in the same chat and forum topic.\n",
"name": "allow_sending_without_reply",
"required": false
},
{
"type": "String",
"description": "Quoted part of the message to be replied to; 0-1024 characters after entities parsing. The quote must be an exact substring of the message to be replied to, including bold, italic, underline, strikethrough, spoiler, and custom_emoji entities. The message will fail to send if the quote isn't found in the original message.",
"html_description": "<td><em>Optional</em>. Quoted part of the message to be replied to; 0-1024 characters after entities parsing. The quote must be an exact substring of the message to be replied to, including <em>bold</em>, <em>italic</em>, <em>underline</em>, <em>strikethrough</em>, <em>spoiler</em>, and <em>custom_emoji</em> entities. The message will fail to send if the quote isn't found in the original message.</td>",
"rst_description": "*Optional*. Quoted part of the message to be replied to; 0-1024 characters after entities parsing. The quote must be an exact substring of the message to be replied to, including *bold*, *italic*, *underline*, *strikethrough*, *spoiler*, and *custom_emoji* entities. The message will fail to send if the quote isn't found in the original message.\n",
"name": "quote",
"required": false
},
{
"type": "String",
"description": "Mode for parsing entities in the quote. See formatting options for more details.",
"html_description": "<td><em>Optional</em>. Mode for parsing entities in the quote. See <a href=\"#formatting-options\">formatting options</a> for more details.</td>",
"rst_description": "*Optional*. Mode for parsing entities in the quote. See `formatting options <https://core.telegram.org/bots/api#formatting-options>`_ for more details.\n",
"name": "quote_parse_mode",
"required": false
},
{
"type": "Array of MessageEntity",
"description": "A JSON-serialized list of special entities that appear in the quote. It can be specified instead of quote_parse_mode.",
"html_description": "<td><em>Optional</em>. A JSON-serialized list of special entities that appear in the quote. It can be specified instead of <em>quote_parse_mode</em>.</td>",
"rst_description": "*Optional*. A JSON-serialized list of special entities that appear in the quote. It can be specified instead of *quote_parse_mode*.\n",
"name": "quote_entities",
"required": false
},
{
"type": "Integer",
"description": "Position of the quote in the original message in UTF-16 code units",
"html_description": "<td><em>Optional</em>. Position of the quote in the original message in UTF-16 code units</td>",
"rst_description": "*Optional*. Position of the quote in the original message in UTF-16 code units\n",
"name": "quote_position",
"required": false
}
],
"category": "types"
}
}

3
.butcher/types/ReplyParameters/replace.yml Normal file
View file

@ -0,0 +1,3 @@
annotations:
quote_parse_mode:
value: UNSET_PARSE_MODE

4
.butcher/types/ShippingAddress/entity.json
View file

@ -14,8 +14,8 @@
{
"type": "String",
"description": "Two-letter ISO 3166-1 alpha-2 country code",
"html_description": "<td>Two-letter ISO 3166-1 alpha-2 country code</td>",
"rst_description": "Two-letter ISO 3166-1 alpha-2 country code\n",
"html_description": "<td>Two-letter <a href=\"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2\">ISO 3166-1 alpha-2</a> country code</td>",
"rst_description": "Two-letter `ISO 3166-1 alpha-2 <https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2>`_ country code\n",
"name": "country_code",
"required": true
},

49
.butcher/types/TextQuote/entity.json Normal file
View file

@ -0,0 +1,49 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "textquote",
"name": "TextQuote",
"description": "This object contains information about the quoted part of a message that is replied to by the given message.",
"html_description": "<p>This object contains information about the quoted part of a message that is replied to by the given message.</p>",
"rst_description": "This object contains information about the quoted part of a message that is replied to by the given message.",
"annotations": [
{
"type": "String",
"description": "Text of the quoted part of a message that is replied to by the given message",
"html_description": "<td>Text of the quoted part of a message that is replied to by the given message</td>",
"rst_description": "Text of the quoted part of a message that is replied to by the given message\n",
"name": "text",
"required": true
},
{
"type": "Array of MessageEntity",
"description": "Special entities that appear in the quote. Currently, only bold, italic, underline, strikethrough, spoiler, and custom_emoji entities are kept in quotes.",
"html_description": "<td><em>Optional</em>. Special entities that appear in the quote. Currently, only <em>bold</em>, <em>italic</em>, <em>underline</em>, <em>strikethrough</em>, <em>spoiler</em>, and <em>custom_emoji</em> entities are kept in quotes.</td>",
"rst_description": "*Optional*. Special entities that appear in the quote. Currently, only *bold*, *italic*, *underline*, *strikethrough*, *spoiler*, and *custom_emoji* entities are kept in quotes.\n",
"name": "entities",
"required": false
},
{
"type": "Integer",
"description": "Approximate quote position in the original message in UTF-16 code units as specified by the sender",
"html_description": "<td>Approximate quote position in the original message in UTF-16 code units as specified by the sender</td>",
"rst_description": "Approximate quote position in the original message in UTF-16 code units as specified by the sender\n",
"name": "position",
"required": true
},
{
"type": "True",
"description": "True, if the quote was chosen manually by the message sender. Otherwise, the quote was added automatically by the server.",
"html_description": "<td><em>Optional</em>. True, if the quote was chosen manually by the message sender. Otherwise, the quote was added automatically by the server.</td>",
"rst_description": "*Optional*. True, if the quote was chosen manually by the message sender. Otherwise, the quote was added automatically by the server.\n",
"name": "is_manual",
"required": false
}
],
"category": "types"
}
}

32
.butcher/types/Update/entity.json
View file

@ -51,6 +51,22 @@
"name": "edited_channel_post",
"required": false
},
{
"type": "MessageReactionUpdated",
"description": "A reaction to a message was changed by a user. The bot must be an administrator in the chat and must explicitly specify \"message_reaction\" in the list of allowed_updates to receive these updates. The update isn't received for reactions set by bots.",
"html_description": "<td><em>Optional</em>. A reaction to a message was changed by a user. The bot must be an administrator in the chat and must explicitly specify <code>\"message_reaction\"</code> in the list of <em>allowed_updates</em> to receive these updates. The update isn't received for reactions set by bots.</td>",
"rst_description": "*Optional*. A reaction to a message was changed by a user. The bot must be an administrator in the chat and must explicitly specify :code:`\"message_reaction\"` in the list of *allowed_updates* to receive these updates. The update isn't received for reactions set by bots.\n",
"name": "message_reaction",
"required": false
},
{
"type": "MessageReactionCountUpdated",
"description": "Reactions to a message with anonymous reactions were changed. The bot must be an administrator in the chat and must explicitly specify \"message_reaction_count\" in the list of allowed_updates to receive these updates.",
"html_description": "<td><em>Optional</em>. Reactions to a message with anonymous reactions were changed. The bot must be an administrator in the chat and must explicitly specify <code>\"message_reaction_count\"</code> in the list of <em>allowed_updates</em> to receive these updates.</td>",
"rst_description": "*Optional*. Reactions to a message with anonymous reactions were changed. The bot must be an administrator in the chat and must explicitly specify :code:`\"message_reaction_count\"` in the list of *allowed_updates* to receive these updates.\n",
"name": "message_reaction_count",
"required": false
},
{
"type": "InlineQuery",
"description": "New incoming inline query",
@ -130,6 +146,22 @@
"rst_description": "*Optional*. A request to join the chat has been sent. The bot must have the *can_invite_users* administrator right in the chat to receive these updates.\n",
"name": "chat_join_request",
"required": false
},
{
"type": "ChatBoostUpdated",
"description": "A chat boost was added or changed. The bot must be an administrator in the chat to receive these updates.",
"html_description": "<td><em>Optional</em>. A chat boost was added or changed. The bot must be an administrator in the chat to receive these updates.</td>",
"rst_description": "*Optional*. A chat boost was added or changed. The bot must be an administrator in the chat to receive these updates.\n",
"name": "chat_boost",
"required": false
},
{
"type": "ChatBoostRemoved",
"description": "A boost was removed from a chat. The bot must be an administrator in the chat to receive these updates.",
"html_description": "<td><em>Optional</em>. A boost was removed from a chat. The bot must be an administrator in the chat to receive these updates.</td>",
"rst_description": "*Optional*. A boost was removed from a chat. The bot must be an administrator in the chat to receive these updates.\n",
"name": "removed_chat_boost",
"required": false
}
],
"category": "types"

25
.butcher/types/UserChatBoosts/entity.json Normal file
View file

@ -0,0 +1,25 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "userchatboosts",
"name": "UserChatBoosts",
"description": "This object represents a list of boosts added to a chat by a user.",
"html_description": "<p>This object represents a list of boosts added to a chat by a user.</p>",
"rst_description": "This object represents a list of boosts added to a chat by a user.",
"annotations": [
{
"type": "Array of ChatBoost",
"description": "The list of boosts added to the chat by the user",
"html_description": "<td>The list of boosts added to the chat by the user</td>",
"rst_description": "The list of boosts added to the chat by the user\n",
"name": "boosts",
"required": true
}
],
"category": "types"
}
}

7
.butcher/types/UserShared/entity.json
View file

@ -1,5 +1,10 @@
{
"meta": {},
"meta": {
"deprecated": {
"version": "7.0",
"release_date": "2023-12-29"
}
},
"group": {
"title": "Available types",
"anchor": "available-types"

33
.butcher/types/UsersShared/entity.json Normal file
View file

@ -0,0 +1,33 @@
{
"meta": {},
"group": {
"title": "Available types",
"anchor": "available-types"
},
"object": {
"anchor": "usersshared",
"name": "UsersShared",
"description": "This object contains information about the users whose identifiers were shared with the bot using a KeyboardButtonRequestUsers button.",
"html_description": "<p>This object contains information about the users whose identifiers were shared with the bot using a <a href=\"#keyboardbuttonrequestusers\">KeyboardButtonRequestUsers</a> button.</p>",
"rst_description": "This object contains information about the users whose identifiers were shared with the bot using a :class:`aiogram.types.keyboard_button_request_users.KeyboardButtonRequestUsers` button.",
"annotations": [
{
"type": "Integer",
"description": "Identifier of the request",
"html_description": "<td>Identifier of the request</td>",
"rst_description": "Identifier of the request\n",
"name": "request_id",
"required": true
},
{
"type": "Array of Integer",
"description": "Identifiers of the shared users. These numbers may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting them. But they have at most 52 significant bits, so 64-bit integers or double-precision float types are safe for storing these identifiers. The bot may not have access to the users and could be unable to use these identifiers, unless the users are already known to the bot by some other means.",
"html_description": "<td>Identifiers of the shared users. These numbers may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting them. But they have at most 52 significant bits, so 64-bit integers or double-precision float types are safe for storing these identifiers. The bot may not have access to the users and could be unable to use these identifiers, unless the users are already known to the bot by some other means.</td>",
"rst_description": "Identifiers of the shared users. These numbers may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting them. But they have at most 52 significant bits, so 64-bit integers or double-precision float types are safe for storing these identifiers. The bot may not have access to the users and could be unable to use these identifiers, unless the users are already known to the bot by some other means.\n",
"name": "user_ids",
"required": true
}
],
"category": "types"
}
}

11
CHANGES/1387.feature.rst Normal file
View file

@ -0,0 +1,11 @@
Added full support of `Bot API 7.0 <https://core.telegram.org/bots/api-changelog#december-29-2023>`_
- Reactions
- Replies 2.0
- Link Preview Customization
- Block Quotation
- Multiple Message Actions
- Requests for multiple users
- Chat Boosts
- Giveaway
- Other changes

13
Makefile
View file

@ -119,16 +119,3 @@ release:
git add .
git commit -m "Release $(shell poetry version -s)"
git tag v$(shell hatch version -s)
butcher_version := 0.1.23
butcher-install:
pip install -U git+ssh://git@github.com/aiogram/butcher.git@v$(butcher_version)
.PHONY: butcher-install
butcher:
butcher parse
butcher refresh
butcher apply all
.PHONY: butcher

2
README.rst
View file

@ -52,7 +52,7 @@ Features
- Asynchronous (`asyncio docs <https://docs.python.org/3/library/asyncio.html>`_, :pep:`492`)
- Has type hints (:pep:`484`) and can be used with `mypy <http://mypy-lang.org/>`_
- Supports `PyPy <https://www.pypy.org/>`_
- Supports `Telegram Bot API 6.9 <https://core.telegram.org/bots/api>`_ and gets fast updates to the latest versions of the Bot API
- Supports `Telegram Bot API 7.0 <https://core.telegram.org/bots/api>`_ and gets fast updates to the latest versions of the Bot API
- Telegram Bot API integration code was `autogenerated <https://github.com/aiogram/tg-codegen>`_ and can be easily re-generated when API gets updated
- Updates router (Blueprints)
- Has Finite State Machine

4
aiogram/__meta__.py
View file

@ -1,2 +1,2 @@
__version__ = "3.2.0"
__api_version__ = "6.9"
__version__ = "3.3.0"
__api_version__ = "7.0"

451
aiogram/client/bot.py
View file

@ -18,7 +18,6 @@ from typing import (
import aiofiles
from aiogram.utils.mixins import ContextInstanceMixin
from aiogram.utils.token import extract_bot_id, validate_token
from ..methods import (
@ -35,6 +34,7 @@ from ..methods import (
CloseForumTopic,
CloseGeneralForumTopic,
CopyMessage,
CopyMessages,
CreateChatInviteLink,
CreateForumTopic,
CreateInvoiceLink,
@ -44,6 +44,7 @@ from ..methods import (
DeleteChatStickerSet,
DeleteForumTopic,
DeleteMessage,
DeleteMessages,
DeleteMyCommands,
DeleteStickerFromSet,
DeleteStickerSet,
@ -58,6 +59,7 @@ from ..methods import (
EditMessageText,
ExportChatInviteLink,
ForwardMessage,
ForwardMessages,
GetChat,
GetChatAdministrators,
GetChatMember,
@ -75,6 +77,7 @@ from ..methods import (
GetMyShortDescription,
GetStickerSet,
GetUpdates,
GetUserChatBoosts,
GetUserProfilePhotos,
GetWebhookInfo,
HideGeneralForumTopic,
@ -113,6 +116,7 @@ from ..methods import (
SetChatTitle,
SetCustomEmojiStickerSetThumbnail,
SetGameScore,
SetMessageReaction,
SetMyCommands,
SetMyDefaultAdministratorRights,
SetMyDescription,
@ -196,6 +200,7 @@ from ..types import (
InputMediaVideo,
InputSticker,
LabeledPrice,
LinkPreviewOptions,
MaskPosition,
MenuButtonCommands,
MenuButtonDefault,
@ -213,14 +218,18 @@ from ..types import (
PassportElementErrorTranslationFiles,
PassportElementErrorUnspecified,
Poll,
ReactionTypeCustomEmoji,
ReactionTypeEmoji,
ReplyKeyboardMarkup,
ReplyKeyboardRemove,
ReplyParameters,
SentWebAppMessage,
ShippingOption,
Sticker,
StickerSet,
Update,
User,
UserChatBoosts,
UserProfilePhotos,
WebhookInfo,
)
@ -800,15 +809,16 @@ class Bot:
caption_entities: Optional[List[MessageEntity]] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> MessageId:
"""
Use this method to copy messages of any kind. Service messages and invoice messages can't be copied. A quiz :class:`aiogram.methods.poll.Poll` can be copied only if the value of the field *correct_option_id* is known to the bot. The method is analogous to the method :class:`aiogram.methods.forward_message.ForwardMessage`, but the copied message doesn't have a link to the original message. Returns the :class:`aiogram.types.message_id.MessageId` of the sent message on success.
Use this method to copy messages of any kind. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz :class:`aiogram.methods.poll.Poll` can be copied only if the value of the field *correct_option_id* is known to the bot. The method is analogous to the method :class:`aiogram.methods.forward_message.ForwardMessage`, but the copied message doesn't have a link to the original message. Returns the :class:`aiogram.types.message_id.MessageId` of the sent message on success.
Source: https://core.telegram.org/bots/api#copymessage
@ -821,9 +831,10 @@ class Bot:
:param caption_entities: A JSON-serialized list of special entities that appear in the new caption, which can be specified instead of *parse_mode*
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: Returns the :class:`aiogram.types.message_id.MessageId` of the sent message on success.
"""
@ -838,9 +849,10 @@ class Bot:
caption_entities=caption_entities,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -1441,8 +1453,9 @@ class Bot:
inline_message_id: Optional[str] = None,
parse_mode: Optional[str] = UNSET_PARSE_MODE,
entities: Optional[List[MessageEntity]] = None,
disable_web_page_preview: Optional[bool] = UNSET_DISABLE_WEB_PAGE_PREVIEW,
link_preview_options: Optional[LinkPreviewOptions] = None,
reply_markup: Optional[InlineKeyboardMarkup] = None,
disable_web_page_preview: Optional[bool] = UNSET_DISABLE_WEB_PAGE_PREVIEW,
request_timeout: Optional[int] = None,
) -> Union[Message, bool]:
"""
@ -1456,8 +1469,9 @@ class Bot:
:param inline_message_id: Required if *chat_id* and *message_id* are not specified. Identifier of the inline message
:param parse_mode: Mode for parsing entities in the message text. See `formatting options <https://core.telegram.org/bots/api#formatting-options>`_ for more details.
:param entities: A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode*
:param disable_web_page_preview: Disables link previews for links in this message
:param link_preview_options: Link preview generation options for the message
:param reply_markup: A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_.
:param disable_web_page_preview: Disables link previews for links in this message
:param request_timeout: Request timeout
:return: On success, if the edited message is not an inline message, the edited :class:`aiogram.types.message.Message` is returned, otherwise :code:`True` is returned.
"""
@ -1469,8 +1483,9 @@ class Bot:
inline_message_id=inline_message_id,
parse_mode=parse_mode,
entities=entities,
disable_web_page_preview=disable_web_page_preview,
link_preview_options=link_preview_options,
reply_markup=reply_markup,
disable_web_page_preview=disable_web_page_preview,
)
return await self(call, request_timeout=request_timeout)
@ -1507,7 +1522,7 @@ class Bot:
request_timeout: Optional[int] = None,
) -> Message:
"""
Use this method to forward messages of any kind. Service messages can't be forwarded. On success, the sent :class:`aiogram.types.message.Message` is returned.
Use this method to forward messages of any kind. Service messages and messages with protected content can't be forwarded. On success, the sent :class:`aiogram.types.message.Message` is returned.
Source: https://core.telegram.org/bots/api#forwardmessage
@ -1537,7 +1552,7 @@ class Bot:
request_timeout: Optional[int] = None,
) -> Chat:
"""
Use this method to get up to date information about the chat (current name of the user for one-on-one conversations, current username of a user, group or channel, etc.). Returns a :class:`aiogram.types.chat.Chat` object on success.
Use this method to get up to date information about the chat. Returns a :class:`aiogram.types.chat.Chat` object on success.
Source: https://core.telegram.org/bots/api#getchat
@ -1849,7 +1864,7 @@ class Bot:
:param offset: Identifier of the first update to be returned. Must be greater by one than the highest among the identifiers of previously received updates. By default, updates starting with the earliest unconfirmed update are returned. An update is considered confirmed as soon as :class:`aiogram.methods.get_updates.GetUpdates` is called with an *offset* higher than its *update_id*. The negative offset can be specified to retrieve updates starting from *-offset* update from the end of the updates queue. All previous updates will be forgotten.
:param limit: Limits the number of updates to be retrieved. Values between 1-100 are accepted. Defaults to 100.
:param timeout: Timeout in seconds for long polling. Defaults to 0, i.e. usual short polling. Should be positive, short polling should be used for testing purposes only.
:param allowed_updates: A JSON-serialized list of the update types you want your bot to receive. For example, specify :code:`["message", "edited_channel_post", "callback_query"]` to only receive updates of these types. See :class:`aiogram.types.update.Update` for a complete list of available update types. Specify an empty list to receive all update types except *chat_member* (default). If not specified, the previous setting will be used.
:param allowed_updates: A JSON-serialized list of the update types you want your bot to receive. For example, specify :code:`["message", "edited_channel_post", "callback_query"]` to only receive updates of these types. See :class:`aiogram.types.update.Update` for a complete list of available update types. Specify an empty list to receive all update types except *chat_member*, *message_reaction*, and *message_reaction_count* (default). If not specified, the previous setting will be used.
:param request_timeout: Request timeout
:return: Returns an Array of :class:`aiogram.types.update.Update` objects.
"""
@ -2127,11 +2142,12 @@ class Bot:
has_spoiler: Optional[bool] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -2152,9 +2168,10 @@ class Bot:
:param has_spoiler: Pass :code:`True` if the animation needs to be covered with a spoiler animation
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future.
"""
@ -2173,9 +2190,10 @@ class Bot:
has_spoiler=has_spoiler,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2193,11 +2211,12 @@ class Bot:
thumbnail: Optional[InputFile] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -2218,9 +2237,10 @@ class Bot:
:param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://<file_attach_name>' if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. :ref:`More information on Sending Files » <sending-files>`
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future.
"""
@ -2238,9 +2258,10 @@ class Bot:
thumbnail=thumbnail,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2284,11 +2305,12 @@ class Bot:
vcard: Optional[str] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -2304,9 +2326,10 @@ class Bot:
:param vcard: Additional data about the contact in the form of a `vCard <https://en.wikipedia.org/wiki/VCard>`_, 0-2048 bytes
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: On success, the sent :class:`aiogram.types.message.Message` is returned.
"""
@ -2320,9 +2343,10 @@ class Bot:
vcard=vcard,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2333,11 +2357,12 @@ class Bot:
emoji: Optional[str] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -2350,9 +2375,10 @@ class Bot:
:param emoji: Emoji on which the dice throw animation is based. Currently, must be one of '🎲', '🎯', '🏀', '⚽', '🎳', or '🎰'. Dice can have values 1-6 for '🎲', '🎯' and '🎳', values 1-5 for '🏀' and '⚽', and values 1-64 for '🎰'. Defaults to '🎲'
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: On success, the sent :class:`aiogram.types.message.Message` is returned.
"""
@ -2363,9 +2389,10 @@ class Bot:
emoji=emoji,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2381,11 +2408,12 @@ class Bot:
disable_content_type_detection: Optional[bool] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -2403,9 +2431,10 @@ class Bot:
:param disable_content_type_detection: Disables automatic server-side content type detection for files uploaded using multipart/form-data
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future.
"""
@ -2421,9 +2450,10 @@ class Bot:
disable_content_type_detection=disable_content_type_detection,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2434,9 +2464,10 @@ class Bot:
message_thread_id: Optional[int] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[InlineKeyboardMarkup] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -2449,9 +2480,10 @@ class Bot:
:param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: On success, the sent :class:`aiogram.types.message.Message` is returned.
"""
@ -2462,9 +2494,10 @@ class Bot:
message_thread_id=message_thread_id,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2495,9 +2528,10 @@ class Bot:
is_flexible: Optional[bool] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[InlineKeyboardMarkup] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -2530,9 +2564,10 @@ class Bot:
:param is_flexible: Pass :code:`True` if the final price depends on the shipping method
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_. If empty, one 'Pay :code:`total price`' button will be shown. If not empty, the first button must be a Pay button.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: On success, the sent :class:`aiogram.types.message.Message` is returned.
"""
@ -2563,9 +2598,10 @@ class Bot:
is_flexible=is_flexible,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2581,11 +2617,12 @@ class Bot:
proximity_alert_radius: Optional[int] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -2603,9 +2640,10 @@ class Bot:
:param proximity_alert_radius: For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: On success, the sent :class:`aiogram.types.message.Message` is returned.
"""
@ -2621,9 +2659,10 @@ class Bot:
proximity_alert_radius=proximity_alert_radius,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2634,8 +2673,9 @@ class Bot:
message_thread_id: Optional[int] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
reply_parameters: Optional[ReplyParameters] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> List[Message]:
"""
@ -2648,8 +2688,9 @@ class Bot:
:param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
:param disable_notification: Sends messages `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent messages from forwarding and saving
:param reply_to_message_id: If the messages are a reply, ID of the original message
:param reply_parameters: Description of the message to reply to
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the messages are a reply, ID of the original message
:param request_timeout: Request timeout
:return: On success, an array of `Messages <https://core.telegram.org/bots/api#message>`_ that were sent is returned.
"""
@ -2660,8 +2701,9 @@ class Bot:
message_thread_id=message_thread_id,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
reply_parameters=reply_parameters,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2672,14 +2714,16 @@ class Bot:
message_thread_id: Optional[int] = None,
parse_mode: Optional[str] = UNSET_PARSE_MODE,
entities: Optional[List[MessageEntity]] = None,
disable_web_page_preview: Optional[bool] = UNSET_DISABLE_WEB_PAGE_PREVIEW,
link_preview_options: Optional[LinkPreviewOptions] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
disable_web_page_preview: Optional[bool] = UNSET_DISABLE_WEB_PAGE_PREVIEW,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -2692,12 +2736,14 @@ class Bot:
:param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
:param parse_mode: Mode for parsing entities in the message text. See `formatting options <https://core.telegram.org/bots/api#formatting-options>`_ for more details.
:param entities: A JSON-serialized list of special entities that appear in message text, which can be specified instead of *parse_mode*
:param disable_web_page_preview: Disables link previews for links in this message
:param link_preview_options: Link preview generation options for the message
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param disable_web_page_preview: Disables link previews for links in this message
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: On success, the sent :class:`aiogram.types.message.Message` is returned.
"""
@ -2708,12 +2754,14 @@ class Bot:
message_thread_id=message_thread_id,
parse_mode=parse_mode,
entities=entities,
disable_web_page_preview=disable_web_page_preview,
link_preview_options=link_preview_options,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
disable_web_page_preview=disable_web_page_preview,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2728,11 +2776,12 @@ class Bot:
has_spoiler: Optional[bool] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -2749,9 +2798,10 @@ class Bot:
:param has_spoiler: Pass :code:`True` if the photo needs to be covered with a spoiler animation
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: On success, the sent :class:`aiogram.types.message.Message` is returned.
"""
@ -2766,9 +2816,10 @@ class Bot:
has_spoiler=has_spoiler,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2790,11 +2841,12 @@ class Bot:
is_closed: Optional[bool] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -2818,9 +2870,10 @@ class Bot:
:param is_closed: Pass :code:`True` if the poll needs to be immediately closed. This can be useful for poll preview.
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: On success, the sent :class:`aiogram.types.message.Message` is returned.
"""
@ -2842,9 +2895,10 @@ class Bot:
is_closed=is_closed,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2856,11 +2910,12 @@ class Bot:
emoji: Optional[str] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -2874,9 +2929,10 @@ class Bot:
:param emoji: Emoji associated with the sticker; only for just uploaded stickers
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: On success, the sent :class:`aiogram.types.message.Message` is returned.
"""
@ -2888,9 +2944,10 @@ class Bot:
emoji=emoji,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2908,11 +2965,12 @@ class Bot:
google_place_type: Optional[str] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -2932,9 +2990,10 @@ class Bot:
:param google_place_type: Google Places type of the venue. (See `supported types <https://developers.google.com/places/web-service/supported_types>`_.)
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: On success, the sent :class:`aiogram.types.message.Message` is returned.
"""
@ -2952,9 +3011,10 @@ class Bot:
google_place_type=google_place_type,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -2974,11 +3034,12 @@ class Bot:
supports_streaming: Optional[bool] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -3000,9 +3061,10 @@ class Bot:
:param supports_streaming: Pass :code:`True` if the uploaded video is suitable for streaming
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.
"""
@ -3022,9 +3084,10 @@ class Bot:
supports_streaming=supports_streaming,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -3038,11 +3101,12 @@ class Bot:
thumbnail: Optional[InputFile] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -3058,9 +3122,10 @@ class Bot:
:param thumbnail: Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass 'attach://<file_attach_name>' if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. :ref:`More information on Sending Files » <sending-files>`
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: On success, the sent :class:`aiogram.types.message.Message` is returned.
"""
@ -3074,9 +3139,10 @@ class Bot:
thumbnail=thumbnail,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -3091,11 +3157,12 @@ class Bot:
duration: Optional[int] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = UNSET_PROTECT_CONTENT,
reply_to_message_id: Optional[int] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_parameters: Optional[ReplyParameters] = None,
reply_markup: Optional[
Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]
] = None,
allow_sending_without_reply: Optional[bool] = None,
reply_to_message_id: Optional[int] = None,
request_timeout: Optional[int] = None,
) -> Message:
"""
@ -3112,9 +3179,10 @@ class Bot:
:param duration: Duration of the voice message in seconds
:param disable_notification: Sends the message `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent message from forwarding and saving
:param reply_to_message_id: If the message is a reply, ID of the original message
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_parameters: Description of the message to reply to
:param reply_markup: Additional interface options. A JSON-serialized object for an `inline keyboard <https://core.telegram.org/bots/features#inline-keyboards>`_, `custom reply keyboard <https://core.telegram.org/bots/features#keyboards>`_, instructions to remove reply keyboard or to force a reply from the user.
:param allow_sending_without_reply: Pass :code:`True` if the message should be sent even if the specified replied-to message is not found
:param reply_to_message_id: If the message is a reply, ID of the original message
:param request_timeout: Request timeout
:return: Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future.
"""
@ -3129,9 +3197,10 @@ class Bot:
duration=duration,
disable_notification=disable_notification,
protect_content=protect_content,
reply_to_message_id=reply_to_message_id,
allow_sending_without_reply=allow_sending_without_reply,
reply_parameters=reply_parameters,
reply_markup=reply_markup,
allow_sending_without_reply=allow_sending_without_reply,
reply_to_message_id=reply_to_message_id,
)
return await self(call, request_timeout=request_timeout)
@ -3490,7 +3559,7 @@ class Bot:
:param certificate: Upload your public key certificate so that the root certificate in use can be checked. See our `self-signed guide <https://core.telegram.org/bots/self-signed>`_ for details.
:param ip_address: The fixed IP address which will be used to send webhook requests instead of the IP address resolved through DNS
:param max_connections: The maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100. Defaults to *40*. Use lower values to limit the load on your bot's server, and higher values to increase your bot's throughput.
:param allowed_updates: A JSON-serialized list of the update types you want your bot to receive. For example, specify :code:`["message", "edited_channel_post", "callback_query"]` to only receive updates of these types. See :class:`aiogram.types.update.Update` for a complete list of available update types. Specify an empty list to receive all update types except *chat_member* (default). If not specified, the previous setting will be used.
:param allowed_updates: A JSON-serialized list of the update types you want your bot to receive. For example, specify :code:`["message", "edited_channel_post", "callback_query"]` to only receive updates of these types. See :class:`aiogram.types.update.Update` for a complete list of available update types. Specify an empty list to receive all update types except *chat_member*, *message_reaction*, and *message_reaction_count* (default). If not specified, the previous setting will be used.
:param drop_pending_updates: Pass :code:`True` to drop all pending updates
:param secret_token: A secret token to be sent in a header 'X-Telegram-Bot-Api-Secret-Token' in every webhook request, 1-256 characters. Only characters :code:`A-Z`, :code:`a-z`, :code:`0-9`, :code:`_` and :code:`-` are allowed. The header is useful to ensure that the request comes from a webhook set by you.
:param request_timeout: Request timeout
@ -4116,3 +4185,151 @@ class Bot:
chat_id=chat_id,
)
return await self(call, request_timeout=request_timeout)
async def copy_messages(
self,
chat_id: Union[int, str],
from_chat_id: Union[int, str],
message_ids: List[int],
message_thread_id: Optional[int] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = None,
remove_caption: Optional[bool] = None,
request_timeout: Optional[int] = None,
) -> List[MessageId]:
"""
Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz :class:`aiogram.methods.poll.Poll` can be copied only if the value of the field *correct_option_id* is known to the bot. The method is analogous to the method :class:`aiogram.methods.forward_messages.ForwardMessages`, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of :class:`aiogram.types.message_id.MessageId` of the sent messages is returned.
Source: https://core.telegram.org/bots/api#copymessages
:param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)
:param from_chat_id: Unique identifier for the chat where the original messages were sent (or channel username in the format :code:`@channelusername`)
:param message_ids: Identifiers of 1-100 messages in the chat *from_chat_id* to copy. The identifiers must be specified in a strictly increasing order.
:param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
:param disable_notification: Sends the messages `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the sent messages from forwarding and saving
:param remove_caption: Pass :code:`True` to copy the messages without their captions
:param request_timeout: Request timeout
:return: On success, an array of :class:`aiogram.types.message_id.MessageId` of the sent messages is returned.
"""
call = CopyMessages(
chat_id=chat_id,
from_chat_id=from_chat_id,
message_ids=message_ids,
message_thread_id=message_thread_id,
disable_notification=disable_notification,
protect_content=protect_content,
remove_caption=remove_caption,
)
return await self(call, request_timeout=request_timeout)
async def delete_messages(
self,
chat_id: Union[int, str],
message_ids: List[int],
request_timeout: Optional[int] = None,
) -> bool:
"""
Use this method to delete multiple messages simultaneously. If some of the specified messages can't be found, they are skipped. Returns :code:`True` on success.
Source: https://core.telegram.org/bots/api#deletemessages
:param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)
:param message_ids: Identifiers of 1-100 messages to delete. See :class:`aiogram.methods.delete_message.DeleteMessage` for limitations on which messages can be deleted
:param request_timeout: Request timeout
:return: Returns :code:`True` on success.
"""
call = DeleteMessages(
chat_id=chat_id,
message_ids=message_ids,
)
return await self(call, request_timeout=request_timeout)
async def forward_messages(
self,
chat_id: Union[int, str],
from_chat_id: Union[int, str],
message_ids: List[int],
message_thread_id: Optional[int] = None,
disable_notification: Optional[bool] = None,
protect_content: Optional[bool] = None,
request_timeout: Optional[int] = None,
) -> List[MessageId]:
"""
Use this method to forward multiple messages of any kind. If some of the specified messages can't be found or forwarded, they are skipped. Service messages and messages with protected content can't be forwarded. Album grouping is kept for forwarded messages. On success, an array of :class:`aiogram.types.message_id.MessageId` of the sent messages is returned.
Source: https://core.telegram.org/bots/api#forwardmessages
:param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)
:param from_chat_id: Unique identifier for the chat where the original messages were sent (or channel username in the format :code:`@channelusername`)
:param message_ids: Identifiers of 1-100 messages in the chat *from_chat_id* to forward. The identifiers must be specified in a strictly increasing order.
:param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
:param disable_notification: Sends the messages `silently <https://telegram.org/blog/channels-2-0#silent-messages>`_. Users will receive a notification with no sound.
:param protect_content: Protects the contents of the forwarded messages from forwarding and saving
:param request_timeout: Request timeout
:return: On success, an array of :class:`aiogram.types.message_id.MessageId` of the sent messages is returned.
"""
call = ForwardMessages(
chat_id=chat_id,
from_chat_id=from_chat_id,
message_ids=message_ids,
message_thread_id=message_thread_id,
disable_notification=disable_notification,
protect_content=protect_content,
)
return await self(call, request_timeout=request_timeout)
async def get_user_chat_boosts(
self,
chat_id: Union[int, str],
user_id: int,
request_timeout: Optional[int] = None,
) -> UserChatBoosts:
"""
Use this method to get the list of boosts added to a chat by a user. Requires administrator rights in the chat. Returns a :class:`aiogram.types.user_chat_boosts.UserChatBoosts` object.
Source: https://core.telegram.org/bots/api#getuserchatboosts
:param chat_id: Unique identifier for the chat or username of the channel (in the format :code:`@channelusername`)
:param user_id: Unique identifier of the target user
:param request_timeout: Request timeout
:return: Returns a :class:`aiogram.types.user_chat_boosts.UserChatBoosts` object.
"""
call = GetUserChatBoosts(
chat_id=chat_id,
user_id=user_id,
)
return await self(call, request_timeout=request_timeout)
async def set_message_reaction(
self,
chat_id: Union[int, str],
message_id: int,
reaction: Optional[List[Union[ReactionTypeEmoji, ReactionTypeCustomEmoji]]] = None,
is_big: Optional[bool] = None,
request_timeout: Optional[int] = None,
) -> bool:
"""
Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. In albums, bots must react to the first message. Returns :code:`True` on success.
Source: https://core.telegram.org/bots/api#setmessagereaction
:param chat_id: Unique identifier for the target chat or username of the target channel (in the format :code:`@channelusername`)
:param message_id: Identifier of the target message
:param reaction: New list of reaction types to set on the message. Currently, as non-premium users, bots can set up to one reaction per message. A custom emoji reaction can be used if it is either already present on the message or explicitly allowed by chat administrators.
:param is_big: Pass :code:`True` to set the reaction with a big animation
:param request_timeout: Request timeout
:return: Returns :code:`True` on success.
"""
call = SetMessageReaction(
chat_id=chat_id,
message_id=message_id,
reaction=reaction,
is_big=is_big,
)
return await self(call, request_timeout=request_timeout)

Some files were not shown because too many files have changed in this diff Show more