From a50f0e3dd448a55d1c5a97936dd4c22bc14fecbd Mon Sep 17 00:00:00 2001 From: sys-001 Date: Sat, 5 Nov 2022 13:00:03 +0000 Subject: [PATCH] deploy: a94711cb06f80f4ddbb49121e0c4a00b7f85b6e0 --- schemas/botapi.json | 546 +++++++++++++++- schemas/botapi.yaml | 410 +++++++++++- schemas/botapi_openapi.json | 1175 ++++++++++++++++++++++++++++++++++- schemas/botapi_openapi.yaml | 752 +++++++++++++++++++++- schemas/botapi_postman.json | 400 +++++++++++- 5 files changed, 3262 insertions(+), 21 deletions(-) diff --git a/schemas/botapi.json b/schemas/botapi.json index 5128e09..da0fa1e 100644 --- a/schemas/botapi.json +++ b/schemas/botapi.json @@ -1,5 +1,5 @@ { - "version": "6.2.0", + "version": "6.3.0", "types": [ { "name": "Update", @@ -356,6 +356,15 @@ "optional": true, "description": "Optional. Last name of the other party in a private chat" }, + { + "name": "is_forum", + "types": [ + "bool" + ], + "optional": true, + "description": "Optional. True, if the supergroup chat is a forum (has topics enabled)", + "default": true + }, { "name": "photo", "types": [ @@ -364,6 +373,22 @@ "optional": true, "description": "Optional. Chat photo. Returned only in getChat." }, + { + "name": "active_usernames", + "types": [ + "Array" + ], + "optional": true, + "description": "Optional. If non-empty, the list of all active chat usernames; for private chats, supergroups and channels. Returned only in getChat." + }, + { + "name": "emoji_status_custom_emoji_id", + "types": [ + "string" + ], + "optional": true, + "description": "Optional. Custom emoji identifier of emoji status of the other party in a private chat. Returned only in getChat." + }, { "name": "bio", "types": [ @@ -513,6 +538,14 @@ "optional": false, "description": "Unique message identifier inside this chat" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Optional. Unique identifier of a message thread to which the message belongs; for supergroups only" + }, { "name": "from", "types": [ @@ -593,6 +626,15 @@ "optional": true, "description": "Optional. For forwarded messages, date the original message was sent in Unix time" }, + { + "name": "is_topic_message", + "types": [ + "bool" + ], + "optional": true, + "description": "Optional. True, if the message is sent to a forum topic", + "default": true + }, { "name": "is_automatic_forward", "types": [ @@ -935,6 +977,30 @@ "optional": true, "description": "Optional. Service message. A user in the chat triggered another user's proximity alert while sharing Live Location." }, + { + "name": "forum_topic_created", + "types": [ + "ForumTopicCreated" + ], + "optional": true, + "description": "Optional. Service message: forum topic created" + }, + { + "name": "forum_topic_closed", + "types": [ + "ForumTopicClosed" + ], + "optional": true, + "description": "Optional. Service message: forum topic closed" + }, + { + "name": "forum_topic_reopened", + "types": [ + "ForumTopicReopened" + ], + "optional": true, + "description": "Optional. Service message: forum topic reopened" + }, { "name": "video_chat_scheduled", "types": [ @@ -1927,6 +1993,49 @@ ], "extended_by": [] }, + { + "name": "ForumTopicCreated", + "description": "This object represents a service message about a new forum topic created in the chat.", + "fields": [ + { + "name": "name", + "types": [ + "string" + ], + "optional": false, + "description": "Name of the topic" + }, + { + "name": "icon_color", + "types": [ + "int" + ], + "optional": false, + "description": "Color of the topic icon in RGB format" + }, + { + "name": "icon_custom_emoji_id", + "types": [ + "string" + ], + "optional": true, + "description": "Optional. Unique identifier of the custom emoji shown as the topic icon" + } + ], + "extended_by": [] + }, + { + "name": "ForumTopicClosed", + "description": "This object represents a service message about a forum topic closed in the chat. Currently holds no information.", + "fields": [], + "extended_by": [] + }, + { + "name": "ForumTopicReopened", + "description": "This object represents a service message about a forum topic reopened in the chat. Currently holds no information.", + "fields": [], + "extended_by": [] + }, { "name": "VideoChatScheduled", "description": "This object represents a service message about a video chat scheduled in the chat.", @@ -2627,6 +2736,14 @@ ], "optional": true, "description": "Optional. True, if the user is allowed to pin messages; groups and supergroups only" + }, + { + "name": "can_manage_topics", + "types": [ + "bool" + ], + "optional": true, + "description": "Optional. True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only" } ], "extended_by": [] @@ -2799,6 +2916,14 @@ "optional": true, "description": "Optional. True, if the user is allowed to pin messages; groups and supergroups only" }, + { + "name": "can_manage_topics", + "types": [ + "bool" + ], + "optional": true, + "description": "Optional. True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only" + }, { "name": "custom_title", "types": [ @@ -2885,6 +3010,14 @@ "optional": false, "description": "True, if the user is allowed to pin messages" }, + { + "name": "can_manage_topics", + "types": [ + "bool" + ], + "optional": false, + "description": "True, if the user is allowed to create forum topics" + }, { "name": "can_send_messages", "types": [ @@ -3159,6 +3292,14 @@ ], "optional": true, "description": "Optional. True, if the user is allowed to pin messages. Ignored in public supergroups" + }, + { + "name": "can_manage_topics", + "types": [ + "bool" + ], + "optional": true, + "description": "Optional. True, if the user is allowed to create forum topics. If omitted defaults to the value of can_pin_messages" } ], "extended_by": [] @@ -3186,6 +3327,45 @@ ], "extended_by": [] }, + { + "name": "ForumTopic", + "description": "This object represents a forum topic.", + "fields": [ + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": false, + "description": "Unique identifier of the forum topic" + }, + { + "name": "name", + "types": [ + "string" + ], + "optional": false, + "description": "Name of the topic" + }, + { + "name": "icon_color", + "types": [ + "int" + ], + "optional": false, + "description": "Color of the topic icon in RGB format" + }, + { + "name": "icon_custom_emoji_id", + "types": [ + "string" + ], + "optional": true, + "description": "Optional. Unique identifier of the custom emoji shown as the topic icon" + } + ], + "extended_by": [] + }, { "name": "BotCommand", "description": "This object represents a bot command.", @@ -7677,6 +7857,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "text", "types": [ @@ -7770,6 +7958,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "from_chat_id", "types": [ @@ -7821,6 +8017,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "from_chat_id", "types": [ @@ -7923,6 +8127,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "photo", "types": [ @@ -8017,6 +8229,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "audio", "types": [ @@ -8144,6 +8364,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "document", "types": [ @@ -8255,6 +8483,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "video", "types": [ @@ -8390,6 +8626,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "animation", "types": [ @@ -8517,6 +8761,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "voice", "types": [ @@ -8619,6 +8871,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "video_note", "types": [ @@ -8714,6 +8974,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "media", "types": [ @@ -8772,6 +9040,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "latitude", "types": [ @@ -9007,6 +9283,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "latitude", "types": [ @@ -9132,6 +9416,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "phone_number", "types": [ @@ -9205,7 +9497,7 @@ "ForceReply" ], "optional": true, - "description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove keyboard or to force a reply from the user." + "description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user." } ], "return_types": [ @@ -9225,6 +9517,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "question", "types": [ @@ -9385,6 +9685,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "emoji", "types": [ @@ -9745,6 +10053,14 @@ ], "optional": true, "description": "Pass True if the administrator can pin messages, supergroups only" + }, + { + "name": "can_manage_topics", + "types": [ + "bool" + ], + "optional": true, + "description": "Pass True if the user is allowed to create, rename, close, and reopen forum topics, supergroups only" } ], "return_types": [ @@ -10130,7 +10446,7 @@ "string" ], "optional": false, - "description": "New chat title, 1-255 characters" + "description": "New chat title, 1-128 characters" } ], "return_types": [ @@ -10383,6 +10699,202 @@ "bool" ] }, + { + "name": "getForumTopicIconStickers", + "description": "Use this method to get custom emoji stickers, which can be used as a forum topic icon by any user. Requires no parameters. Returns an Array of Sticker objects.", + "fields": [], + "return_types": [ + "Array" + ] + }, + { + "name": "createForumTopic", + "description": "Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights. Returns information about the created topic as a ForumTopic object.", + "fields": [ + { + "name": "chat_id", + "types": [ + "int", + "string" + ], + "optional": false, + "description": "Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)" + }, + { + "name": "name", + "types": [ + "string" + ], + "optional": false, + "description": "Topic name, 1-128 characters" + }, + { + "name": "icon_color", + "types": [ + "int" + ], + "optional": true, + "description": "Color of the topic icon in RGB format. Currently, must be one of 0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, 0xFF93B2, or 0xFB6F5F" + }, + { + "name": "icon_custom_emoji_id", + "types": [ + "string" + ], + "optional": true, + "description": "Unique identifier of the custom emoji shown as the topic icon. Use getForumTopicIconStickers to get all allowed custom emoji identifiers." + } + ], + "return_types": [ + "ForumTopic" + ] + }, + { + "name": "editForumTopic", + "description": "Use this method to edit name and icon of a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.", + "fields": [ + { + "name": "chat_id", + "types": [ + "int", + "string" + ], + "optional": false, + "description": "Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)" + }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": false, + "description": "Unique identifier for the target message thread of the forum topic" + }, + { + "name": "name", + "types": [ + "string" + ], + "optional": false, + "description": "New topic name, 1-128 characters" + }, + { + "name": "icon_custom_emoji_id", + "types": [ + "string" + ], + "optional": false, + "description": "New unique identifier of the custom emoji shown as the topic icon. Use getForumTopicIconStickers to get all allowed custom emoji identifiers" + } + ], + "return_types": [ + "bool" + ] + }, + { + "name": "closeForumTopic", + "description": "Use this method to close an open topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.", + "fields": [ + { + "name": "chat_id", + "types": [ + "int", + "string" + ], + "optional": false, + "description": "Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)" + }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": false, + "description": "Unique identifier for the target message thread of the forum topic" + } + ], + "return_types": [ + "bool" + ] + }, + { + "name": "reopenForumTopic", + "description": "Use this method to reopen a closed topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.", + "fields": [ + { + "name": "chat_id", + "types": [ + "int", + "string" + ], + "optional": false, + "description": "Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)" + }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": false, + "description": "Unique identifier for the target message thread of the forum topic" + } + ], + "return_types": [ + "bool" + ] + }, + { + "name": "deleteForumTopic", + "description": "Use this method to delete a forum topic along with all its messages in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_delete_messages administrator rights. Returns True on success.", + "fields": [ + { + "name": "chat_id", + "types": [ + "int", + "string" + ], + "optional": false, + "description": "Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)" + }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": false, + "description": "Unique identifier for the target message thread of the forum topic" + } + ], + "return_types": [ + "bool" + ] + }, + { + "name": "unpinAllForumTopicMessages", + "description": "Use this method to clear the list of pinned messages in a forum topic. The bot must be an administrator in the chat for this to work and must have the can_pin_messages administrator right in the supergroup. Returns True on success.", + "fields": [ + { + "name": "chat_id", + "types": [ + "int", + "string" + ], + "optional": false, + "description": "Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)" + }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": false, + "description": "Unique identifier for the target message thread of the forum topic" + } + ], + "return_types": [ + "bool" + ] + }, { "name": "answerCallbackQuery", "description": "Use this method to send answers to callback queries sent from inline keyboards. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. On success, True is returned.", @@ -10436,7 +10948,7 @@ }, { "name": "setMyCommands", - "description": "Use this method to change the list of the bot's commands. See https://core.telegram.org/bots#commands for more details about bot commands. Returns True on success.", + "description": "Use this method to change the list of the bot's commands. See this manual for more details about bot commands. Returns True on success.", "fields": [ { "name": "commands", @@ -10877,7 +11389,7 @@ }, { "name": "deleteMessage", - "description": "Use this method to delete a message, including service messages, with the following limitations:- A message can only be deleted if it was sent less than 48 hours ago.- A dice message in a private chat can only be deleted if it was sent more than 24 hours ago.- Bots can delete outgoing messages in private chats, groups, and supergroups.- Bots can delete incoming messages in private chats.- Bots granted can_post_messages permissions can delete outgoing messages in channels.- If the bot is an administrator of a group, it can delete any message there.- If the bot has can_delete_messages permission in a supergroup or a channel, it can delete any message there.Returns True on success.", + "description": "Use this method to delete a message, including service messages, with the following limitations:- A message can only be deleted if it was sent less than 48 hours ago.- Service messages about a supergroup, channel, or forum topic creation can't be deleted.- A dice message in a private chat can only be deleted if it was sent more than 24 hours ago.- Bots can delete outgoing messages in private chats, groups, and supergroups.- Bots can delete incoming messages in private chats.- Bots granted can_post_messages permissions can delete outgoing messages in channels.- If the bot is an administrator of a group, it can delete any message there.- If the bot has can_delete_messages permission in a supergroup or a channel, it can delete any message there.Returns True on success.", "fields": [ { "name": "chat_id", @@ -10914,6 +11426,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "sticker", "types": [ @@ -11358,6 +11878,14 @@ "optional": false, "description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "title", "types": [ @@ -11853,6 +12381,14 @@ "optional": false, "description": "Unique identifier for the target chat" }, + { + "name": "message_thread_id", + "types": [ + "int" + ], + "optional": true, + "description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only" + }, { "name": "game_short_name", "types": [ diff --git a/schemas/botapi.yaml b/schemas/botapi.yaml index 92c381c..87017e0 100644 --- a/schemas/botapi.yaml +++ b/schemas/botapi.yaml @@ -1,4 +1,4 @@ -version: 6.2.0 +version: 6.3.0 types: - name: Update @@ -267,12 +267,31 @@ types: - string optional: true description: 'Optional. Last name of the other party in a private chat' + - + name: is_forum + types: + - bool + optional: true + description: 'Optional. True, if the supergroup chat is a forum (has topics enabled)' + default: true - name: photo types: - ChatPhoto optional: true description: 'Optional. Chat photo. Returned only in getChat.' + - + name: active_usernames + types: + - Array + optional: true + description: 'Optional. If non-empty, the list of all active chat usernames; for private chats, supergroups and channels. Returned only in getChat.' + - + name: emoji_status_custom_emoji_id + types: + - string + optional: true + description: 'Optional. Custom emoji identifier of emoji status of the other party in a private chat. Returned only in getChat.' - name: bio types: @@ -386,6 +405,12 @@ types: - int optional: false description: 'Unique message identifier inside this chat' + - + name: message_thread_id + types: + - int + optional: true + description: 'Optional. Unique identifier of a message thread to which the message belongs; for supergroups only' - name: from types: @@ -446,6 +471,13 @@ types: - int optional: true description: 'Optional. For forwarded messages, date the original message was sent in Unix time' + - + name: is_topic_message + types: + - bool + optional: true + description: 'Optional. True, if the message is sent to a forum topic' + default: true - name: is_automatic_forward types: @@ -704,6 +736,24 @@ types: - ProximityAlertTriggered optional: true description: "Optional. Service message. A user in the chat triggered another user's proximity alert while sharing Live Location." + - + name: forum_topic_created + types: + - ForumTopicCreated + optional: true + description: 'Optional. Service message: forum topic created' + - + name: forum_topic_closed + types: + - ForumTopicClosed + optional: true + description: 'Optional. Service message: forum topic closed' + - + name: forum_topic_reopened + types: + - ForumTopicReopened + optional: true + description: 'Optional. Service message: forum topic reopened' - name: video_chat_scheduled types: @@ -1442,6 +1492,39 @@ types: optional: false description: 'New auto-delete time for messages in the chat; in seconds' extended_by: { } + - + name: ForumTopicCreated + description: 'This object represents a service message about a new forum topic created in the chat.' + fields: + - + name: name + types: + - string + optional: false + description: 'Name of the topic' + - + name: icon_color + types: + - int + optional: false + description: 'Color of the topic icon in RGB format' + - + name: icon_custom_emoji_id + types: + - string + optional: true + description: 'Optional. Unique identifier of the custom emoji shown as the topic icon' + extended_by: { } + - + name: ForumTopicClosed + description: 'This object represents a service message about a forum topic closed in the chat. Currently holds no information.' + fields: { } + extended_by: { } + - + name: ForumTopicReopened + description: 'This object represents a service message about a forum topic reopened in the chat. Currently holds no information.' + fields: { } + extended_by: { } - name: VideoChatScheduled description: 'This object represents a service message about a video chat scheduled in the chat.' @@ -1966,6 +2049,12 @@ types: - bool optional: true description: 'Optional. True, if the user is allowed to pin messages; groups and supergroups only' + - + name: can_manage_topics + types: + - bool + optional: true + description: 'Optional. True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only' extended_by: { } - name: ChatMember @@ -2095,6 +2184,12 @@ types: - bool optional: true description: 'Optional. True, if the user is allowed to pin messages; groups and supergroups only' + - + name: can_manage_topics + types: + - bool + optional: true + description: 'Optional. True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only' - name: custom_title types: @@ -2159,6 +2254,12 @@ types: - bool optional: false description: 'True, if the user is allowed to pin messages' + - + name: can_manage_topics + types: + - bool + optional: false + description: 'True, if the user is allowed to create forum topics' - name: can_send_messages types: @@ -2364,6 +2465,12 @@ types: - bool optional: true description: 'Optional. True, if the user is allowed to pin messages. Ignored in public supergroups' + - + name: can_manage_topics + types: + - bool + optional: true + description: 'Optional. True, if the user is allowed to create forum topics. If omitted defaults to the value of can_pin_messages' extended_by: { } - name: ChatLocation @@ -2382,6 +2489,35 @@ types: optional: false description: 'Location address; 1-64 characters, as defined by the chat owner' extended_by: { } + - + name: ForumTopic + description: 'This object represents a forum topic.' + fields: + - + name: message_thread_id + types: + - int + optional: false + description: 'Unique identifier of the forum topic' + - + name: name + types: + - string + optional: false + description: 'Name of the topic' + - + name: icon_color + types: + - int + optional: false + description: 'Color of the topic icon in RGB format' + - + name: icon_custom_emoji_id + types: + - string + optional: true + description: 'Optional. Unique identifier of the custom emoji shown as the topic icon' + extended_by: { } - name: BotCommand description: 'This object represents a bot command.' @@ -5757,6 +5893,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: text types: @@ -5827,6 +5969,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: from_chat_id types: @@ -5865,6 +6013,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: from_chat_id types: @@ -5942,6 +6096,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: photo types: @@ -6013,6 +6173,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: audio types: @@ -6109,6 +6275,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: document types: @@ -6193,6 +6365,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: video types: @@ -6295,6 +6473,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: animation types: @@ -6391,6 +6575,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: voice types: @@ -6468,6 +6658,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: video_note types: @@ -6540,6 +6736,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: media types: @@ -6583,6 +6785,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: latitude types: @@ -6759,6 +6967,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: latitude types: @@ -6853,6 +7067,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: phone_number types: @@ -6909,7 +7129,7 @@ methods: - ReplyKeyboardRemove - ForceReply optional: true - description: 'Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove keyboard or to force a reply from the user.' + description: 'Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.' return_types: - Message - @@ -6923,6 +7143,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: question types: @@ -7044,6 +7270,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: emoji types: @@ -7312,6 +7544,12 @@ methods: - bool optional: true description: 'Pass True if the administrator can pin messages, supergroups only' + - + name: can_manage_topics + types: + - bool + optional: true + description: 'Pass True if the user is allowed to create, rename, close, and reopen forum topics, supergroups only' return_types: - bool - @@ -7594,7 +7832,7 @@ methods: types: - string optional: false - description: 'New chat title, 1-255 characters' + description: 'New chat title, 1-128 characters' return_types: - bool - @@ -7776,6 +8014,150 @@ methods: description: 'Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)' return_types: - bool + - + name: getForumTopicIconStickers + description: 'Use this method to get custom emoji stickers, which can be used as a forum topic icon by any user. Requires no parameters. Returns an Array of Sticker objects.' + fields: { } + return_types: + - Array + - + name: createForumTopic + description: 'Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights. Returns information about the created topic as a ForumTopic object.' + fields: + - + name: chat_id + types: + - int + - string + optional: false + description: 'Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)' + - + name: name + types: + - string + optional: false + description: 'Topic name, 1-128 characters' + - + name: icon_color + types: + - int + optional: true + description: 'Color of the topic icon in RGB format. Currently, must be one of 0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, 0xFF93B2, or 0xFB6F5F' + - + name: icon_custom_emoji_id + types: + - string + optional: true + description: 'Unique identifier of the custom emoji shown as the topic icon. Use getForumTopicIconStickers to get all allowed custom emoji identifiers.' + return_types: + - ForumTopic + - + name: editForumTopic + description: 'Use this method to edit name and icon of a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.' + fields: + - + name: chat_id + types: + - int + - string + optional: false + description: 'Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)' + - + name: message_thread_id + types: + - int + optional: false + description: 'Unique identifier for the target message thread of the forum topic' + - + name: name + types: + - string + optional: false + description: 'New topic name, 1-128 characters' + - + name: icon_custom_emoji_id + types: + - string + optional: false + description: 'New unique identifier of the custom emoji shown as the topic icon. Use getForumTopicIconStickers to get all allowed custom emoji identifiers' + return_types: + - bool + - + name: closeForumTopic + description: 'Use this method to close an open topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.' + fields: + - + name: chat_id + types: + - int + - string + optional: false + description: 'Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)' + - + name: message_thread_id + types: + - int + optional: false + description: 'Unique identifier for the target message thread of the forum topic' + return_types: + - bool + - + name: reopenForumTopic + description: 'Use this method to reopen a closed topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.' + fields: + - + name: chat_id + types: + - int + - string + optional: false + description: 'Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)' + - + name: message_thread_id + types: + - int + optional: false + description: 'Unique identifier for the target message thread of the forum topic' + return_types: + - bool + - + name: deleteForumTopic + description: 'Use this method to delete a forum topic along with all its messages in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_delete_messages administrator rights. Returns True on success.' + fields: + - + name: chat_id + types: + - int + - string + optional: false + description: 'Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)' + - + name: message_thread_id + types: + - int + optional: false + description: 'Unique identifier for the target message thread of the forum topic' + return_types: + - bool + - + name: unpinAllForumTopicMessages + description: 'Use this method to clear the list of pinned messages in a forum topic. The bot must be an administrator in the chat for this to work and must have the can_pin_messages administrator right in the supergroup. Returns True on success.' + fields: + - + name: chat_id + types: + - int + - string + optional: false + description: 'Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)' + - + name: message_thread_id + types: + - int + optional: false + description: 'Unique identifier for the target message thread of the forum topic' + return_types: + - bool - name: answerCallbackQuery description: 'Use this method to send answers to callback queries sent from inline keyboards. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. On success, True is returned.' @@ -7816,7 +8198,7 @@ methods: - bool - name: setMyCommands - description: "Use this method to change the list of the bot's commands. See https://core.telegram.org/bots#commands for more details about bot commands. Returns True on success." + description: "Use this method to change the list of the bot's commands. See this manual for more details about bot commands. Returns True on success." fields: - name: commands @@ -8141,7 +8523,7 @@ methods: - Poll - name: deleteMessage - description: 'Use this method to delete a message, including service messages, with the following limitations:- A message can only be deleted if it was sent less than 48 hours ago.- A dice message in a private chat can only be deleted if it was sent more than 24 hours ago.- Bots can delete outgoing messages in private chats, groups, and supergroups.- Bots can delete incoming messages in private chats.- Bots granted can_post_messages permissions can delete outgoing messages in channels.- If the bot is an administrator of a group, it can delete any message there.- If the bot has can_delete_messages permission in a supergroup or a channel, it can delete any message there.Returns True on success.' + description: "Use this method to delete a message, including service messages, with the following limitations:- A message can only be deleted if it was sent less than 48 hours ago.- Service messages about a supergroup, channel, or forum topic creation can't be deleted.- A dice message in a private chat can only be deleted if it was sent more than 24 hours ago.- Bots can delete outgoing messages in private chats, groups, and supergroups.- Bots can delete incoming messages in private chats.- Bots granted can_post_messages permissions can delete outgoing messages in channels.- If the bot is an administrator of a group, it can delete any message there.- If the bot has can_delete_messages permission in a supergroup or a channel, it can delete any message there.Returns True on success." fields: - name: chat_id @@ -8169,6 +8551,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: sticker types: @@ -8496,6 +8884,12 @@ methods: - string optional: false description: 'Unique identifier for the target chat or username of the target channel (in the format @channelusername)' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: title types: @@ -8864,6 +9258,12 @@ methods: - int optional: false description: 'Unique identifier for the target chat' + - + name: message_thread_id + types: + - int + optional: true + description: 'Unique identifier for the target message thread (topic) of the forum; for forum supergroups only' - name: game_short_name types: diff --git a/schemas/botapi_openapi.json b/schemas/botapi_openapi.json index 4c9c82c..4263909 100644 --- a/schemas/botapi_openapi.json +++ b/schemas/botapi_openapi.json @@ -3,7 +3,7 @@ "info": { "title": "Telegram Bot API", "description": "Auto-generated OpenAPI schema by TGScraper.", - "version": "6.2.0" + "version": "6.3.0" }, "servers": [ { @@ -327,9 +327,22 @@ "last_name": { "type": "string" }, + "is_forum": { + "type": "boolean", + "default": true + }, "photo": { "$ref": "#/components/schemas/ChatPhoto" }, + "active_usernames": { + "type": "array", + "items": { + "type": "string" + } + }, + "emoji_status_custom_emoji_id": { + "type": "string" + }, "bio": { "type": "string" }, @@ -398,6 +411,9 @@ "message_id": { "type": "integer" }, + "message_thread_id": { + "type": "integer" + }, "from": { "$ref": "#/components/schemas/User" }, @@ -428,6 +444,10 @@ "forward_date": { "type": "integer" }, + "is_topic_message": { + "type": "boolean", + "default": true + }, "is_automatic_forward": { "type": "boolean", "default": true @@ -575,6 +595,15 @@ "proximity_alert_triggered": { "$ref": "#/components/schemas/ProximityAlertTriggered" }, + "forum_topic_created": { + "$ref": "#/components/schemas/ForumTopicCreated" + }, + "forum_topic_closed": { + "$ref": "#/components/schemas/ForumTopicClosed" + }, + "forum_topic_reopened": { + "$ref": "#/components/schemas/ForumTopicReopened" + }, "video_chat_scheduled": { "$ref": "#/components/schemas/VideoChatScheduled" }, @@ -1118,6 +1147,33 @@ }, "type": "object" }, + "ForumTopicCreated": { + "description": "This object represents a service message about a new forum topic created in the chat.", + "required": [ + "name", + "icon_color" + ], + "properties": { + "name": { + "type": "string" + }, + "icon_color": { + "type": "integer" + }, + "icon_custom_emoji_id": { + "type": "string" + } + }, + "type": "object" + }, + "ForumTopicClosed": { + "description": "This object represents a service message about a forum topic closed in the chat. Currently holds no information.", + "type": "object" + }, + "ForumTopicReopened": { + "description": "This object represents a service message about a forum topic reopened in the chat. Currently holds no information.", + "type": "object" + }, "VideoChatScheduled": { "description": "This object represents a service message about a video chat scheduled in the chat.", "required": [ @@ -1531,6 +1587,9 @@ }, "can_pin_messages": { "type": "boolean" + }, + "can_manage_topics": { + "type": "boolean" } }, "type": "object" @@ -1639,6 +1698,9 @@ "can_pin_messages": { "type": "boolean" }, + "can_manage_topics": { + "type": "boolean" + }, "custom_title": { "type": "string" } @@ -1670,6 +1732,7 @@ "can_change_info", "can_invite_users", "can_pin_messages", + "can_manage_topics", "can_send_messages", "can_send_media_messages", "can_send_polls", @@ -1696,6 +1759,9 @@ "can_pin_messages": { "type": "boolean" }, + "can_manage_topics": { + "type": "boolean" + }, "can_send_messages": { "type": "boolean" }, @@ -1836,6 +1902,9 @@ }, "can_pin_messages": { "type": "boolean" + }, + "can_manage_topics": { + "type": "boolean" } }, "type": "object" @@ -1856,6 +1925,29 @@ }, "type": "object" }, + "ForumTopic": { + "description": "This object represents a forum topic.", + "required": [ + "message_thread_id", + "name", + "icon_color" + ], + "properties": { + "message_thread_id": { + "type": "integer" + }, + "name": { + "type": "string" + }, + "icon_color": { + "type": "integer" + }, + "icon_custom_emoji_id": { + "type": "string" + } + }, + "type": "object" + }, "BotCommand": { "description": "This object represents a bot command.", "required": [ @@ -5090,6 +5182,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "text": { "type": "string" }, @@ -5154,6 +5249,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "text": { "type": "string" }, @@ -5218,6 +5316,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "text": { "type": "string" }, @@ -5341,6 +5442,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "from_chat_id": { "anyOf": [ { @@ -5382,6 +5486,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "from_chat_id": { "anyOf": [ { @@ -5423,6 +5530,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "from_chat_id": { "anyOf": [ { @@ -5522,6 +5632,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "from_chat_id": { "anyOf": [ { @@ -5597,6 +5710,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "from_chat_id": { "anyOf": [ { @@ -5672,6 +5788,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "from_chat_id": { "anyOf": [ { @@ -5804,6 +5923,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "photo": { "anyOf": [ { @@ -5875,6 +5997,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "photo": { "anyOf": [ { @@ -5946,6 +6071,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "photo": { "anyOf": [ { @@ -6075,6 +6203,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "audio": { "anyOf": [ { @@ -6165,6 +6296,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "audio": { "anyOf": [ { @@ -6255,6 +6389,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "audio": { "anyOf": [ { @@ -6403,6 +6540,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "document": { "anyOf": [ { @@ -6487,6 +6627,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "document": { "anyOf": [ { @@ -6571,6 +6714,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "document": { "anyOf": [ { @@ -6713,6 +6859,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "video": { "anyOf": [ { @@ -6806,6 +6955,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "video": { "anyOf": [ { @@ -6899,6 +7051,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "video": { "anyOf": [ { @@ -7050,6 +7205,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "animation": { "anyOf": [ { @@ -7140,6 +7298,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "animation": { "anyOf": [ { @@ -7230,6 +7391,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "animation": { "anyOf": [ { @@ -7378,6 +7542,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "voice": { "anyOf": [ { @@ -7452,6 +7619,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "voice": { "anyOf": [ { @@ -7526,6 +7696,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "voice": { "anyOf": [ { @@ -7658,6 +7831,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "video_note": { "anyOf": [ { @@ -7733,6 +7909,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "video_note": { "anyOf": [ { @@ -7808,6 +7987,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "video_note": { "anyOf": [ { @@ -7941,6 +8123,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "media": { "type": "array", "items": { @@ -7993,6 +8178,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "media": { "type": "array", "items": { @@ -8045,6 +8233,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "media": { "type": "array", "items": { @@ -8159,6 +8350,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "latitude": { "type": "number" }, @@ -8227,6 +8421,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "latitude": { "type": "number" }, @@ -8295,6 +8492,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "latitude": { "type": "number" }, @@ -8765,6 +8965,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "latitude": { "type": "number" }, @@ -8841,6 +9044,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "latitude": { "type": "number" }, @@ -8917,6 +9123,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "latitude": { "type": "number" }, @@ -9049,6 +9258,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "phone_number": { "type": "string" }, @@ -9111,6 +9323,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "phone_number": { "type": "string" }, @@ -9173,6 +9388,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "phone_number": { "type": "string" }, @@ -9293,6 +9511,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "question": { "type": "string" }, @@ -9387,6 +9608,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "question": { "type": "string" }, @@ -9481,6 +9705,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "question": { "type": "string" }, @@ -9631,6 +9858,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "emoji": { "type": "string", "default": "🎲" @@ -9683,6 +9913,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "emoji": { "type": "string", "default": "🎲" @@ -9735,6 +9968,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "emoji": { "type": "string", "default": "🎲" @@ -10664,6 +10900,9 @@ }, "can_pin_messages": { "type": "boolean" + }, + "can_manage_topics": { + "type": "boolean" } } } @@ -10721,6 +10960,9 @@ }, "can_pin_messages": { "type": "boolean" + }, + "can_manage_topics": { + "type": "boolean" } } } @@ -10778,6 +11020,9 @@ }, "can_pin_messages": { "type": "boolean" + }, + "can_manage_topics": { + "type": "boolean" } } } @@ -13936,6 +14181,903 @@ } } }, + "/getForumTopicIconStickers": { + "description": "Use this method to get custom emoji stickers, which can be used as a forum topic icon by any user. Requires no parameters. Returns an Array of Sticker objects.", + "post": { + "requestBody": { + "content": { + "application/json": { + "schema": { + "type": "object" + } + }, + "application/x-www-form-urlencoded": { + "schema": { + "type": "object" + } + }, + "multipart/form-data": { + "schema": { + "type": "object" + } + } + } + }, + "responses": { + "200": { + "description": "Request was successful, the result is returned.", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "$ref": "#/components/schemas/Success" + }, + { + "type": "object", + "properties": { + "result": { + "type": "array", + "items": { + "$ref": "#/components/schemas/Sticker" + } + } + } + } + ] + } + } + } + }, + "400": { + "$ref": "#/components/responses/BadRequest" + }, + "401": { + "$ref": "#/components/responses/Unauthorized" + }, + "403": { + "$ref": "#/components/responses/Forbidden" + }, + "404": { + "$ref": "#/components/responses/NotFound" + }, + "409": { + "$ref": "#/components/responses/Conflict" + }, + "429": { + "$ref": "#/components/responses/TooManyRequests" + }, + "5XX": { + "$ref": "#/components/responses/ServerError" + }, + "default": { + "$ref": "#/components/responses/UnknownError" + } + } + } + }, + "/createForumTopic": { + "description": "Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights. Returns information about the created topic as a ForumTopic object.", + "post": { + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "name" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "name": { + "type": "string" + }, + "icon_color": { + "type": "integer" + }, + "icon_custom_emoji_id": { + "type": "string" + } + } + } + }, + "application/x-www-form-urlencoded": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "name" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "name": { + "type": "string" + }, + "icon_color": { + "type": "integer" + }, + "icon_custom_emoji_id": { + "type": "string" + } + } + } + }, + "multipart/form-data": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "name" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "name": { + "type": "string" + }, + "icon_color": { + "type": "integer" + }, + "icon_custom_emoji_id": { + "type": "string" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Request was successful, the result is returned.", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "$ref": "#/components/schemas/Success" + }, + { + "type": "object", + "properties": { + "result": { + "$ref": "#/components/schemas/ForumTopic" + } + } + } + ] + } + } + } + }, + "400": { + "$ref": "#/components/responses/BadRequest" + }, + "401": { + "$ref": "#/components/responses/Unauthorized" + }, + "403": { + "$ref": "#/components/responses/Forbidden" + }, + "404": { + "$ref": "#/components/responses/NotFound" + }, + "409": { + "$ref": "#/components/responses/Conflict" + }, + "429": { + "$ref": "#/components/responses/TooManyRequests" + }, + "5XX": { + "$ref": "#/components/responses/ServerError" + }, + "default": { + "$ref": "#/components/responses/UnknownError" + } + } + } + }, + "/editForumTopic": { + "description": "Use this method to edit name and icon of a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.", + "post": { + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id", + "name", + "icon_custom_emoji_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + }, + "name": { + "type": "string" + }, + "icon_custom_emoji_id": { + "type": "string" + } + } + } + }, + "application/x-www-form-urlencoded": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id", + "name", + "icon_custom_emoji_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + }, + "name": { + "type": "string" + }, + "icon_custom_emoji_id": { + "type": "string" + } + } + } + }, + "multipart/form-data": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id", + "name", + "icon_custom_emoji_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + }, + "name": { + "type": "string" + }, + "icon_custom_emoji_id": { + "type": "string" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Request was successful, the result is returned.", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "$ref": "#/components/schemas/Success" + }, + { + "type": "object", + "properties": { + "result": { + "type": "boolean" + } + } + } + ] + } + } + } + }, + "400": { + "$ref": "#/components/responses/BadRequest" + }, + "401": { + "$ref": "#/components/responses/Unauthorized" + }, + "403": { + "$ref": "#/components/responses/Forbidden" + }, + "404": { + "$ref": "#/components/responses/NotFound" + }, + "409": { + "$ref": "#/components/responses/Conflict" + }, + "429": { + "$ref": "#/components/responses/TooManyRequests" + }, + "5XX": { + "$ref": "#/components/responses/ServerError" + }, + "default": { + "$ref": "#/components/responses/UnknownError" + } + } + } + }, + "/closeForumTopic": { + "description": "Use this method to close an open topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.", + "post": { + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + } + } + } + }, + "application/x-www-form-urlencoded": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + } + } + } + }, + "multipart/form-data": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Request was successful, the result is returned.", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "$ref": "#/components/schemas/Success" + }, + { + "type": "object", + "properties": { + "result": { + "type": "boolean" + } + } + } + ] + } + } + } + }, + "400": { + "$ref": "#/components/responses/BadRequest" + }, + "401": { + "$ref": "#/components/responses/Unauthorized" + }, + "403": { + "$ref": "#/components/responses/Forbidden" + }, + "404": { + "$ref": "#/components/responses/NotFound" + }, + "409": { + "$ref": "#/components/responses/Conflict" + }, + "429": { + "$ref": "#/components/responses/TooManyRequests" + }, + "5XX": { + "$ref": "#/components/responses/ServerError" + }, + "default": { + "$ref": "#/components/responses/UnknownError" + } + } + } + }, + "/reopenForumTopic": { + "description": "Use this method to reopen a closed topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.", + "post": { + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + } + } + } + }, + "application/x-www-form-urlencoded": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + } + } + } + }, + "multipart/form-data": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Request was successful, the result is returned.", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "$ref": "#/components/schemas/Success" + }, + { + "type": "object", + "properties": { + "result": { + "type": "boolean" + } + } + } + ] + } + } + } + }, + "400": { + "$ref": "#/components/responses/BadRequest" + }, + "401": { + "$ref": "#/components/responses/Unauthorized" + }, + "403": { + "$ref": "#/components/responses/Forbidden" + }, + "404": { + "$ref": "#/components/responses/NotFound" + }, + "409": { + "$ref": "#/components/responses/Conflict" + }, + "429": { + "$ref": "#/components/responses/TooManyRequests" + }, + "5XX": { + "$ref": "#/components/responses/ServerError" + }, + "default": { + "$ref": "#/components/responses/UnknownError" + } + } + } + }, + "/deleteForumTopic": { + "description": "Use this method to delete a forum topic along with all its messages in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_delete_messages administrator rights. Returns True on success.", + "post": { + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + } + } + } + }, + "application/x-www-form-urlencoded": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + } + } + } + }, + "multipart/form-data": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Request was successful, the result is returned.", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "$ref": "#/components/schemas/Success" + }, + { + "type": "object", + "properties": { + "result": { + "type": "boolean" + } + } + } + ] + } + } + } + }, + "400": { + "$ref": "#/components/responses/BadRequest" + }, + "401": { + "$ref": "#/components/responses/Unauthorized" + }, + "403": { + "$ref": "#/components/responses/Forbidden" + }, + "404": { + "$ref": "#/components/responses/NotFound" + }, + "409": { + "$ref": "#/components/responses/Conflict" + }, + "429": { + "$ref": "#/components/responses/TooManyRequests" + }, + "5XX": { + "$ref": "#/components/responses/ServerError" + }, + "default": { + "$ref": "#/components/responses/UnknownError" + } + } + } + }, + "/unpinAllForumTopicMessages": { + "description": "Use this method to clear the list of pinned messages in a forum topic. The bot must be an administrator in the chat for this to work and must have the can_pin_messages administrator right in the supergroup. Returns True on success.", + "post": { + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + } + } + } + }, + "application/x-www-form-urlencoded": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + } + } + } + }, + "multipart/form-data": { + "schema": { + "type": "object", + "required": [ + "chat_id", + "message_thread_id" + ], + "properties": { + "chat_id": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "string" + } + ] + }, + "message_thread_id": { + "type": "integer" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Request was successful, the result is returned.", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "$ref": "#/components/schemas/Success" + }, + { + "type": "object", + "properties": { + "result": { + "type": "boolean" + } + } + } + ] + } + } + } + }, + "400": { + "$ref": "#/components/responses/BadRequest" + }, + "401": { + "$ref": "#/components/responses/Unauthorized" + }, + "403": { + "$ref": "#/components/responses/Forbidden" + }, + "404": { + "$ref": "#/components/responses/NotFound" + }, + "409": { + "$ref": "#/components/responses/Conflict" + }, + "429": { + "$ref": "#/components/responses/TooManyRequests" + }, + "5XX": { + "$ref": "#/components/responses/ServerError" + }, + "default": { + "$ref": "#/components/responses/UnknownError" + } + } + } + }, "/answerCallbackQuery": { "description": "Use this method to send answers to callback queries sent from inline keyboards. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. On success, True is returned.", "post": { @@ -14070,7 +15212,7 @@ } }, "/setMyCommands": { - "description": "Use this method to change the list of the bot's commands. See https://core.telegram.org/bots#commands for more details about bot commands. Returns True on success.", + "description": "Use this method to change the list of the bot's commands. See this manual for more details about bot commands. Returns True on success.", "post": { "requestBody": { "required": true, @@ -15584,7 +16726,7 @@ } }, "/deleteMessage": { - "description": "Use this method to delete a message, including service messages, with the following limitations:- A message can only be deleted if it was sent less than 48 hours ago.- A dice message in a private chat can only be deleted if it was sent more than 24 hours ago.- Bots can delete outgoing messages in private chats, groups, and supergroups.- Bots can delete incoming messages in private chats.- Bots granted can_post_messages permissions can delete outgoing messages in channels.- If the bot is an administrator of a group, it can delete any message there.- If the bot has can_delete_messages permission in a supergroup or a channel, it can delete any message there.Returns True on success.", + "description": "Use this method to delete a message, including service messages, with the following limitations:- A message can only be deleted if it was sent less than 48 hours ago.- Service messages about a supergroup, channel, or forum topic creation can't be deleted.- A dice message in a private chat can only be deleted if it was sent more than 24 hours ago.- Bots can delete outgoing messages in private chats, groups, and supergroups.- Bots can delete incoming messages in private chats.- Bots granted can_post_messages permissions can delete outgoing messages in channels.- If the bot is an administrator of a group, it can delete any message there.- If the bot has can_delete_messages permission in a supergroup or a channel, it can delete any message there.Returns True on success.", "post": { "requestBody": { "required": true, @@ -15737,6 +16879,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "sticker": { "anyOf": [ { @@ -15796,6 +16941,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "sticker": { "anyOf": [ { @@ -15855,6 +17003,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "sticker": { "anyOf": [ { @@ -17289,6 +18440,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "title": { "type": "string" }, @@ -17399,6 +18553,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "title": { "type": "string" }, @@ -17509,6 +18666,9 @@ } ] }, + "message_thread_id": { + "type": "integer" + }, "title": { "type": "string" }, @@ -18338,6 +19498,9 @@ "chat_id": { "type": "integer" }, + "message_thread_id": { + "type": "integer" + }, "game_short_name": { "type": "string" }, @@ -18370,6 +19533,9 @@ "chat_id": { "type": "integer" }, + "message_thread_id": { + "type": "integer" + }, "game_short_name": { "type": "string" }, @@ -18402,6 +19568,9 @@ "chat_id": { "type": "integer" }, + "message_thread_id": { + "type": "integer" + }, "game_short_name": { "type": "string" }, diff --git a/schemas/botapi_openapi.yaml b/schemas/botapi_openapi.yaml index 2b5f7cf..00198ae 100644 --- a/schemas/botapi_openapi.yaml +++ b/schemas/botapi_openapi.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: 'Telegram Bot API' description: 'Auto-generated OpenAPI schema by TGScraper.' - version: 6.2.0 + version: 6.3.0 servers: - url: 'https://api.telegram.org/bot{token}' @@ -215,8 +215,17 @@ components: type: string last_name: type: string + is_forum: + type: boolean + default: true photo: $ref: '#/components/schemas/ChatPhoto' + active_usernames: + type: array + items: + type: string + emoji_status_custom_emoji_id: + type: string bio: type: string has_private_forwards: @@ -265,6 +274,8 @@ components: properties: message_id: type: integer + message_thread_id: + type: integer from: $ref: '#/components/schemas/User' sender_chat: @@ -285,6 +296,9 @@ components: type: string forward_date: type: integer + is_topic_message: + type: boolean + default: true is_automatic_forward: type: boolean default: true @@ -385,6 +399,12 @@ components: $ref: '#/components/schemas/PassportData' proximity_alert_triggered: $ref: '#/components/schemas/ProximityAlertTriggered' + forum_topic_created: + $ref: '#/components/schemas/ForumTopicCreated' + forum_topic_closed: + $ref: '#/components/schemas/ForumTopicClosed' + forum_topic_reopened: + $ref: '#/components/schemas/ForumTopicReopened' video_chat_scheduled: $ref: '#/components/schemas/VideoChatScheduled' video_chat_started: @@ -759,6 +779,25 @@ components: message_auto_delete_time: type: integer type: object + ForumTopicCreated: + description: 'This object represents a service message about a new forum topic created in the chat.' + required: + - name + - icon_color + properties: + name: + type: string + icon_color: + type: integer + icon_custom_emoji_id: + type: string + type: object + ForumTopicClosed: + description: 'This object represents a service message about a forum topic closed in the chat. Currently holds no information.' + type: object + ForumTopicReopened: + description: 'This object represents a service message about a forum topic reopened in the chat. Currently holds no information.' + type: object VideoChatScheduled: description: 'This object represents a service message about a video chat scheduled in the chat.' required: @@ -1043,6 +1082,8 @@ components: type: boolean can_pin_messages: type: boolean + can_manage_topics: + type: boolean type: object ChatMember: description: 'This object contains information about one member of a chat. Currently, the following 6 types of chat members are supported:' @@ -1118,6 +1159,8 @@ components: type: boolean can_pin_messages: type: boolean + can_manage_topics: + type: boolean custom_title: type: string type: object @@ -1141,6 +1184,7 @@ components: - can_change_info - can_invite_users - can_pin_messages + - can_manage_topics - can_send_messages - can_send_media_messages - can_send_polls @@ -1160,6 +1204,8 @@ components: type: boolean can_pin_messages: type: boolean + can_manage_topics: + type: boolean can_send_messages: type: boolean can_send_media_messages: @@ -1257,6 +1303,8 @@ components: type: boolean can_pin_messages: type: boolean + can_manage_topics: + type: boolean type: object ChatLocation: description: 'Represents a location to which a chat is connected.' @@ -1269,6 +1317,22 @@ components: address: type: string type: object + ForumTopic: + description: 'This object represents a forum topic.' + required: + - message_thread_id + - name + - icon_color + properties: + message_thread_id: + type: integer + name: + type: string + icon_color: + type: integer + icon_custom_emoji_id: + type: string + type: object BotCommand: description: 'This object represents a bot command.' required: @@ -3462,6 +3526,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer text: type: string parse_mode: @@ -3503,6 +3569,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer text: type: string parse_mode: @@ -3544,6 +3612,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer text: type: string parse_mode: @@ -3622,6 +3692,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer from_chat_id: anyOf: - @@ -3648,6 +3720,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer from_chat_id: anyOf: - @@ -3674,6 +3748,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer from_chat_id: anyOf: - @@ -3736,6 +3812,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer from_chat_id: anyOf: - @@ -3784,6 +3862,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer from_chat_id: anyOf: - @@ -3832,6 +3912,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer from_chat_id: anyOf: - @@ -3915,6 +3997,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer photo: anyOf: - @@ -3960,6 +4044,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer photo: anyOf: - @@ -4005,6 +4091,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer photo: anyOf: - @@ -4086,6 +4174,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer audio: anyOf: - @@ -4143,6 +4233,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer audio: anyOf: - @@ -4200,6 +4292,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer audio: anyOf: - @@ -4293,6 +4387,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer document: anyOf: - @@ -4346,6 +4442,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer document: anyOf: - @@ -4399,6 +4497,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer document: anyOf: - @@ -4488,6 +4588,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer video: anyOf: - @@ -4547,6 +4649,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer video: anyOf: - @@ -4606,6 +4710,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer video: anyOf: - @@ -4701,6 +4807,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer animation: anyOf: - @@ -4758,6 +4866,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer animation: anyOf: - @@ -4815,6 +4925,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer animation: anyOf: - @@ -4908,6 +5020,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer voice: anyOf: - @@ -4955,6 +5069,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer voice: anyOf: - @@ -5002,6 +5118,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer voice: anyOf: - @@ -5085,6 +5203,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer video_note: anyOf: - @@ -5132,6 +5252,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer video_note: anyOf: - @@ -5179,6 +5301,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer video_note: anyOf: - @@ -5262,6 +5386,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer media: type: array items: @@ -5295,6 +5421,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer media: type: array items: @@ -5328,6 +5456,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer media: type: array items: @@ -5400,6 +5530,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer latitude: type: number longitude: @@ -5444,6 +5576,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer latitude: type: number longitude: @@ -5488,6 +5622,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer latitude: type: number longitude: @@ -5784,6 +5920,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer latitude: type: number longitude: @@ -5834,6 +5972,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer latitude: type: number longitude: @@ -5884,6 +6024,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer latitude: type: number longitude: @@ -5968,6 +6110,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer phone_number: type: string first_name: @@ -6008,6 +6152,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer phone_number: type: string first_name: @@ -6048,6 +6194,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer phone_number: type: string first_name: @@ -6124,6 +6272,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer question: type: string options: @@ -6186,6 +6336,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer question: type: string options: @@ -6248,6 +6400,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer question: type: string options: @@ -6344,6 +6498,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer emoji: type: string default: 🎲 @@ -6377,6 +6533,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer emoji: type: string default: 🎲 @@ -6410,6 +6568,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer emoji: type: string default: 🎲 @@ -6996,6 +7156,8 @@ paths: type: boolean can_pin_messages: type: boolean + can_manage_topics: + type: boolean application/x-www-form-urlencoded: schema: type: object @@ -7033,6 +7195,8 @@ paths: type: boolean can_pin_messages: type: boolean + can_manage_topics: + type: boolean multipart/form-data: schema: type: object @@ -7070,6 +7234,8 @@ paths: type: boolean can_pin_messages: type: boolean + can_manage_topics: + type: boolean responses: 200: description: 'Request was successful, the result is returned.' @@ -9022,6 +9188,568 @@ paths: $ref: '#/components/responses/ServerError' default: $ref: '#/components/responses/UnknownError' + /getForumTopicIconStickers: + description: 'Use this method to get custom emoji stickers, which can be used as a forum topic icon by any user. Requires no parameters. Returns an Array of Sticker objects.' + post: + requestBody: + content: + application/json: + schema: + type: object + application/x-www-form-urlencoded: + schema: + type: object + multipart/form-data: + schema: + type: object + responses: + 200: + description: 'Request was successful, the result is returned.' + content: + application/json: + schema: + allOf: + - + $ref: '#/components/schemas/Success' + - + type: object + properties: + result: + type: array + items: + $ref: '#/components/schemas/Sticker' + 400: + $ref: '#/components/responses/BadRequest' + 401: + $ref: '#/components/responses/Unauthorized' + 403: + $ref: '#/components/responses/Forbidden' + 404: + $ref: '#/components/responses/NotFound' + 409: + $ref: '#/components/responses/Conflict' + 429: + $ref: '#/components/responses/TooManyRequests' + 5XX: + $ref: '#/components/responses/ServerError' + default: + $ref: '#/components/responses/UnknownError' + /createForumTopic: + description: 'Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights. Returns information about the created topic as a ForumTopic object.' + post: + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - chat_id + - name + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + name: + type: string + icon_color: + type: integer + icon_custom_emoji_id: + type: string + application/x-www-form-urlencoded: + schema: + type: object + required: + - chat_id + - name + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + name: + type: string + icon_color: + type: integer + icon_custom_emoji_id: + type: string + multipart/form-data: + schema: + type: object + required: + - chat_id + - name + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + name: + type: string + icon_color: + type: integer + icon_custom_emoji_id: + type: string + responses: + 200: + description: 'Request was successful, the result is returned.' + content: + application/json: + schema: + allOf: + - + $ref: '#/components/schemas/Success' + - + type: object + properties: + result: + $ref: '#/components/schemas/ForumTopic' + 400: + $ref: '#/components/responses/BadRequest' + 401: + $ref: '#/components/responses/Unauthorized' + 403: + $ref: '#/components/responses/Forbidden' + 404: + $ref: '#/components/responses/NotFound' + 409: + $ref: '#/components/responses/Conflict' + 429: + $ref: '#/components/responses/TooManyRequests' + 5XX: + $ref: '#/components/responses/ServerError' + default: + $ref: '#/components/responses/UnknownError' + /editForumTopic: + description: 'Use this method to edit name and icon of a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.' + post: + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - chat_id + - message_thread_id + - name + - icon_custom_emoji_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + name: + type: string + icon_custom_emoji_id: + type: string + application/x-www-form-urlencoded: + schema: + type: object + required: + - chat_id + - message_thread_id + - name + - icon_custom_emoji_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + name: + type: string + icon_custom_emoji_id: + type: string + multipart/form-data: + schema: + type: object + required: + - chat_id + - message_thread_id + - name + - icon_custom_emoji_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + name: + type: string + icon_custom_emoji_id: + type: string + responses: + 200: + description: 'Request was successful, the result is returned.' + content: + application/json: + schema: + allOf: + - + $ref: '#/components/schemas/Success' + - + type: object + properties: + result: + type: boolean + 400: + $ref: '#/components/responses/BadRequest' + 401: + $ref: '#/components/responses/Unauthorized' + 403: + $ref: '#/components/responses/Forbidden' + 404: + $ref: '#/components/responses/NotFound' + 409: + $ref: '#/components/responses/Conflict' + 429: + $ref: '#/components/responses/TooManyRequests' + 5XX: + $ref: '#/components/responses/ServerError' + default: + $ref: '#/components/responses/UnknownError' + /closeForumTopic: + description: 'Use this method to close an open topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.' + post: + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - chat_id + - message_thread_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + application/x-www-form-urlencoded: + schema: + type: object + required: + - chat_id + - message_thread_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + multipart/form-data: + schema: + type: object + required: + - chat_id + - message_thread_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + responses: + 200: + description: 'Request was successful, the result is returned.' + content: + application/json: + schema: + allOf: + - + $ref: '#/components/schemas/Success' + - + type: object + properties: + result: + type: boolean + 400: + $ref: '#/components/responses/BadRequest' + 401: + $ref: '#/components/responses/Unauthorized' + 403: + $ref: '#/components/responses/Forbidden' + 404: + $ref: '#/components/responses/NotFound' + 409: + $ref: '#/components/responses/Conflict' + 429: + $ref: '#/components/responses/TooManyRequests' + 5XX: + $ref: '#/components/responses/ServerError' + default: + $ref: '#/components/responses/UnknownError' + /reopenForumTopic: + description: 'Use this method to reopen a closed topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.' + post: + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - chat_id + - message_thread_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + application/x-www-form-urlencoded: + schema: + type: object + required: + - chat_id + - message_thread_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + multipart/form-data: + schema: + type: object + required: + - chat_id + - message_thread_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + responses: + 200: + description: 'Request was successful, the result is returned.' + content: + application/json: + schema: + allOf: + - + $ref: '#/components/schemas/Success' + - + type: object + properties: + result: + type: boolean + 400: + $ref: '#/components/responses/BadRequest' + 401: + $ref: '#/components/responses/Unauthorized' + 403: + $ref: '#/components/responses/Forbidden' + 404: + $ref: '#/components/responses/NotFound' + 409: + $ref: '#/components/responses/Conflict' + 429: + $ref: '#/components/responses/TooManyRequests' + 5XX: + $ref: '#/components/responses/ServerError' + default: + $ref: '#/components/responses/UnknownError' + /deleteForumTopic: + description: 'Use this method to delete a forum topic along with all its messages in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_delete_messages administrator rights. Returns True on success.' + post: + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - chat_id + - message_thread_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + application/x-www-form-urlencoded: + schema: + type: object + required: + - chat_id + - message_thread_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + multipart/form-data: + schema: + type: object + required: + - chat_id + - message_thread_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + responses: + 200: + description: 'Request was successful, the result is returned.' + content: + application/json: + schema: + allOf: + - + $ref: '#/components/schemas/Success' + - + type: object + properties: + result: + type: boolean + 400: + $ref: '#/components/responses/BadRequest' + 401: + $ref: '#/components/responses/Unauthorized' + 403: + $ref: '#/components/responses/Forbidden' + 404: + $ref: '#/components/responses/NotFound' + 409: + $ref: '#/components/responses/Conflict' + 429: + $ref: '#/components/responses/TooManyRequests' + 5XX: + $ref: '#/components/responses/ServerError' + default: + $ref: '#/components/responses/UnknownError' + /unpinAllForumTopicMessages: + description: 'Use this method to clear the list of pinned messages in a forum topic. The bot must be an administrator in the chat for this to work and must have the can_pin_messages administrator right in the supergroup. Returns True on success.' + post: + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - chat_id + - message_thread_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + application/x-www-form-urlencoded: + schema: + type: object + required: + - chat_id + - message_thread_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + multipart/form-data: + schema: + type: object + required: + - chat_id + - message_thread_id + properties: + chat_id: + anyOf: + - + type: integer + - + type: string + message_thread_id: + type: integer + responses: + 200: + description: 'Request was successful, the result is returned.' + content: + application/json: + schema: + allOf: + - + $ref: '#/components/schemas/Success' + - + type: object + properties: + result: + type: boolean + 400: + $ref: '#/components/responses/BadRequest' + 401: + $ref: '#/components/responses/Unauthorized' + 403: + $ref: '#/components/responses/Forbidden' + 404: + $ref: '#/components/responses/NotFound' + 409: + $ref: '#/components/responses/Conflict' + 429: + $ref: '#/components/responses/TooManyRequests' + 5XX: + $ref: '#/components/responses/ServerError' + default: + $ref: '#/components/responses/UnknownError' /answerCallbackQuery: description: 'Use this method to send answers to callback queries sent from inline keyboards. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. On success, True is returned.' post: @@ -9107,7 +9835,7 @@ paths: default: $ref: '#/components/responses/UnknownError' /setMyCommands: - description: "Use this method to change the list of the bot's commands. See https://core.telegram.org/bots#commands for more details about bot commands. Returns True on success." + description: "Use this method to change the list of the bot's commands. See this manual for more details about bot commands. Returns True on success." post: requestBody: required: true @@ -10050,7 +10778,7 @@ paths: default: $ref: '#/components/responses/UnknownError' /deleteMessage: - description: 'Use this method to delete a message, including service messages, with the following limitations:- A message can only be deleted if it was sent less than 48 hours ago.- A dice message in a private chat can only be deleted if it was sent more than 24 hours ago.- Bots can delete outgoing messages in private chats, groups, and supergroups.- Bots can delete incoming messages in private chats.- Bots granted can_post_messages permissions can delete outgoing messages in channels.- If the bot is an administrator of a group, it can delete any message there.- If the bot has can_delete_messages permission in a supergroup or a channel, it can delete any message there.Returns True on success.' + description: "Use this method to delete a message, including service messages, with the following limitations:- A message can only be deleted if it was sent less than 48 hours ago.- Service messages about a supergroup, channel, or forum topic creation can't be deleted.- A dice message in a private chat can only be deleted if it was sent more than 24 hours ago.- Bots can delete outgoing messages in private chats, groups, and supergroups.- Bots can delete incoming messages in private chats.- Bots granted can_post_messages permissions can delete outgoing messages in channels.- If the bot is an administrator of a group, it can delete any message there.- If the bot has can_delete_messages permission in a supergroup or a channel, it can delete any message there.Returns True on success." post: requestBody: required: true @@ -10149,6 +10877,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer sticker: anyOf: - @@ -10186,6 +10916,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer sticker: anyOf: - @@ -10223,6 +10955,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer sticker: anyOf: - @@ -11134,6 +11868,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer title: type: string description: @@ -11208,6 +11944,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer title: type: string description: @@ -11282,6 +12020,8 @@ paths: type: integer - type: string + message_thread_id: + type: integer title: type: string description: @@ -11821,6 +12561,8 @@ paths: properties: chat_id: type: integer + message_thread_id: + type: integer game_short_name: type: string disable_notification: @@ -11842,6 +12584,8 @@ paths: properties: chat_id: type: integer + message_thread_id: + type: integer game_short_name: type: string disable_notification: @@ -11863,6 +12607,8 @@ paths: properties: chat_id: type: integer + message_thread_id: + type: integer game_short_name: type: string disable_notification: diff --git a/schemas/botapi_postman.json b/schemas/botapi_postman.json index b2a5e3f..ed12838 100644 --- a/schemas/botapi_postman.json +++ b/schemas/botapi_postman.json @@ -3,7 +3,7 @@ "name": "Telegram Bot API", "description": "Auto-generated Postman collection by TGScraper.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", - "version": "6.2.0" + "version": "6.3.0" }, "variable": { "key": "token", @@ -270,6 +270,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "text", "disabled": false, @@ -355,6 +361,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "from_chat_id", "disabled": false, @@ -410,6 +422,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "from_chat_id", "disabled": false, @@ -501,6 +519,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "photo", "disabled": false, @@ -586,6 +610,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "audio", "disabled": false, @@ -695,6 +725,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "document", "disabled": false, @@ -792,6 +828,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "video", "disabled": false, @@ -907,6 +949,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "animation", "disabled": false, @@ -1016,6 +1064,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "voice", "disabled": false, @@ -1107,6 +1161,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "video_note", "disabled": false, @@ -1192,6 +1252,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "media", "disabled": false, @@ -1253,6 +1319,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "latitude", "disabled": false, @@ -1478,6 +1550,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "latitude", "disabled": false, @@ -1587,6 +1665,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "phone_number", "disabled": false, @@ -1638,7 +1722,7 @@ { "key": "reply_markup", "disabled": true, - "description": "Optional. Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove keyboard or to force a reply from the user.", + "description": "Optional. Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.", "type": "text" } ] @@ -1672,6 +1756,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "question", "disabled": false, @@ -1807,6 +1897,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "emoji", "disabled": true, @@ -2199,6 +2295,12 @@ "disabled": true, "description": "Optional. Pass True if the administrator can pin messages, supergroups only", "type": "text" + }, + { + "key": "can_manage_topics", + "disabled": true, + "description": "Optional. Pass True if the user is allowed to create, rename, close, and reopen forum topics, supergroups only", + "type": "text" } ] }, @@ -2714,7 +2816,7 @@ { "key": "title", "disabled": false, - "description": "Required. New chat title, 1-255 characters", + "description": "Required. New chat title, 1-128 characters", "type": "text" } ] @@ -3112,6 +3214,276 @@ "description": "Use this method to delete a group sticker set from a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Use the field can_set_sticker_set optionally returned in getChat requests to check if the bot can use this method. Returns True on success." } }, + { + "name": "getForumTopicIconStickers", + "request": { + "method": "POST", + "body": { + "mode": "formdata", + "formdata": [] + }, + "url": { + "raw": "https://api.telegram.org/bot{{token}}/getForumTopicIconStickers", + "protocol": "https", + "host": [ + "api", + "telegram", + "org" + ], + "path": [ + "bot{{token}}", + "getForumTopicIconStickers" + ] + }, + "description": "Use this method to get custom emoji stickers, which can be used as a forum topic icon by any user. Requires no parameters. Returns an Array of Sticker objects." + } + }, + { + "name": "createForumTopic", + "request": { + "method": "POST", + "body": { + "mode": "formdata", + "formdata": [ + { + "key": "chat_id", + "disabled": false, + "description": "Required. Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)", + "type": "text" + }, + { + "key": "name", + "disabled": false, + "description": "Required. Topic name, 1-128 characters", + "type": "text" + }, + { + "key": "icon_color", + "disabled": true, + "description": "Optional. Color of the topic icon in RGB format. Currently, must be one of 0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, 0xFF93B2, or 0xFB6F5F", + "type": "text" + }, + { + "key": "icon_custom_emoji_id", + "disabled": true, + "description": "Optional. Unique identifier of the custom emoji shown as the topic icon. Use getForumTopicIconStickers to get all allowed custom emoji identifiers.", + "type": "text" + } + ] + }, + "url": { + "raw": "https://api.telegram.org/bot{{token}}/createForumTopic", + "protocol": "https", + "host": [ + "api", + "telegram", + "org" + ], + "path": [ + "bot{{token}}", + "createForumTopic" + ] + }, + "description": "Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights. Returns information about the created topic as a ForumTopic object." + } + }, + { + "name": "editForumTopic", + "request": { + "method": "POST", + "body": { + "mode": "formdata", + "formdata": [ + { + "key": "chat_id", + "disabled": false, + "description": "Required. Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)", + "type": "text" + }, + { + "key": "message_thread_id", + "disabled": false, + "description": "Required. Unique identifier for the target message thread of the forum topic", + "type": "text" + }, + { + "key": "name", + "disabled": false, + "description": "Required. New topic name, 1-128 characters", + "type": "text" + }, + { + "key": "icon_custom_emoji_id", + "disabled": false, + "description": "Required. New unique identifier of the custom emoji shown as the topic icon. Use getForumTopicIconStickers to get all allowed custom emoji identifiers", + "type": "text" + } + ] + }, + "url": { + "raw": "https://api.telegram.org/bot{{token}}/editForumTopic", + "protocol": "https", + "host": [ + "api", + "telegram", + "org" + ], + "path": [ + "bot{{token}}", + "editForumTopic" + ] + }, + "description": "Use this method to edit name and icon of a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success." + } + }, + { + "name": "closeForumTopic", + "request": { + "method": "POST", + "body": { + "mode": "formdata", + "formdata": [ + { + "key": "chat_id", + "disabled": false, + "description": "Required. Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)", + "type": "text" + }, + { + "key": "message_thread_id", + "disabled": false, + "description": "Required. Unique identifier for the target message thread of the forum topic", + "type": "text" + } + ] + }, + "url": { + "raw": "https://api.telegram.org/bot{{token}}/closeForumTopic", + "protocol": "https", + "host": [ + "api", + "telegram", + "org" + ], + "path": [ + "bot{{token}}", + "closeForumTopic" + ] + }, + "description": "Use this method to close an open topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success." + } + }, + { + "name": "reopenForumTopic", + "request": { + "method": "POST", + "body": { + "mode": "formdata", + "formdata": [ + { + "key": "chat_id", + "disabled": false, + "description": "Required. Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)", + "type": "text" + }, + { + "key": "message_thread_id", + "disabled": false, + "description": "Required. Unique identifier for the target message thread of the forum topic", + "type": "text" + } + ] + }, + "url": { + "raw": "https://api.telegram.org/bot{{token}}/reopenForumTopic", + "protocol": "https", + "host": [ + "api", + "telegram", + "org" + ], + "path": [ + "bot{{token}}", + "reopenForumTopic" + ] + }, + "description": "Use this method to reopen a closed topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success." + } + }, + { + "name": "deleteForumTopic", + "request": { + "method": "POST", + "body": { + "mode": "formdata", + "formdata": [ + { + "key": "chat_id", + "disabled": false, + "description": "Required. Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)", + "type": "text" + }, + { + "key": "message_thread_id", + "disabled": false, + "description": "Required. Unique identifier for the target message thread of the forum topic", + "type": "text" + } + ] + }, + "url": { + "raw": "https://api.telegram.org/bot{{token}}/deleteForumTopic", + "protocol": "https", + "host": [ + "api", + "telegram", + "org" + ], + "path": [ + "bot{{token}}", + "deleteForumTopic" + ] + }, + "description": "Use this method to delete a forum topic along with all its messages in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_delete_messages administrator rights. Returns True on success." + } + }, + { + "name": "unpinAllForumTopicMessages", + "request": { + "method": "POST", + "body": { + "mode": "formdata", + "formdata": [ + { + "key": "chat_id", + "disabled": false, + "description": "Required. Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)", + "type": "text" + }, + { + "key": "message_thread_id", + "disabled": false, + "description": "Required. Unique identifier for the target message thread of the forum topic", + "type": "text" + } + ] + }, + "url": { + "raw": "https://api.telegram.org/bot{{token}}/unpinAllForumTopicMessages", + "protocol": "https", + "host": [ + "api", + "telegram", + "org" + ], + "path": [ + "bot{{token}}", + "unpinAllForumTopicMessages" + ] + }, + "description": "Use this method to clear the list of pinned messages in a forum topic. The bot must be an administrator in the chat for this to work and must have the can_pin_messages administrator right in the supergroup. Returns True on success." + } + }, { "name": "answerCallbackQuery", "request": { @@ -3208,7 +3580,7 @@ "setMyCommands" ] }, - "description": "Use this method to change the list of the bot's commands. See https://core.telegram.org/bots#commands for more details about bot commands. Returns True on success." + "description": "Use this method to change the list of the bot's commands. See this manual for more details about bot commands. Returns True on success." } }, { @@ -3745,7 +4117,7 @@ "deleteMessage" ] }, - "description": "Use this method to delete a message, including service messages, with the following limitations:- A message can only be deleted if it was sent less than 48 hours ago.- A dice message in a private chat can only be deleted if it was sent more than 24 hours ago.- Bots can delete outgoing messages in private chats, groups, and supergroups.- Bots can delete incoming messages in private chats.- Bots granted can_post_messages permissions can delete outgoing messages in channels.- If the bot is an administrator of a group, it can delete any message there.- If the bot has can_delete_messages permission in a supergroup or a channel, it can delete any message there.Returns True on success." + "description": "Use this method to delete a message, including service messages, with the following limitations:- A message can only be deleted if it was sent less than 48 hours ago.- Service messages about a supergroup, channel, or forum topic creation can't be deleted.- A dice message in a private chat can only be deleted if it was sent more than 24 hours ago.- Bots can delete outgoing messages in private chats, groups, and supergroups.- Bots can delete incoming messages in private chats.- Bots granted can_post_messages permissions can delete outgoing messages in channels.- If the bot is an administrator of a group, it can delete any message there.- If the bot has can_delete_messages permission in a supergroup or a channel, it can delete any message there.Returns True on success." } }, { @@ -3761,6 +4133,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "sticker", "disabled": false, @@ -4289,6 +4667,12 @@ "description": "Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "title", "disabled": false, @@ -4750,6 +5134,12 @@ "description": "Required. Unique identifier for the target chat", "type": "text" }, + { + "key": "message_thread_id", + "disabled": true, + "description": "Optional. Unique identifier for the target message thread (topic) of the forum; for forum supergroups only", + "type": "text" + }, { "key": "game_short_name", "disabled": false,