+Subscribe to @BotNews to be the first to know about the latest updates and join the discussion in @BotTalk
Bot API 6.3
+Bot API 6.2
Custom Emoji Support
diff --git a/data/web/core.telegram.org/bots/api-changelog.html b/data/web/core.telegram.org/bots/api-changelog.html index 7475458d85..6595769a46 100644 --- a/data/web/core.telegram.org/bots/api-changelog.html +++ b/data/web/core.telegram.org/bots/api-changelog.html @@ -54,6 +54,20 @@ To learn how to create…">+Subscribe to @BotNews to be the first to know about the latest updates and join the discussion in @BotTalk
Bot API 6.3
+Bot API 6.2
Custom Emoji Support
diff --git a/data/web/core.telegram.org/bots/api.html b/data/web/core.telegram.org/bots/api.html index 839c576750..354368e5ae 100644 --- a/data/web/core.telegram.org/bots/api.html +++ b/data/web/core.telegram.org/bots/api.html @@ -53,6 +53,20 @@ To learn how to create…">+Subscribe to @BotNews to be the first to know about the latest updates and join the discussion in @BotTalk
Bot API 6.3
+Bot API 6.2
Custom Emoji Support
@@ -566,11 +580,26 @@ To learn how to create…">This object represents a service message about a new forum topic created in the chat.
+| Field | +Type | +Description | +
|---|---|---|
| name | +String | +Name of the topic | +
| icon_color | +Integer | +Color of the topic icon in RGB format | +
| icon_custom_emoji_id | +String | +Optional. Unique identifier of the custom emoji shown as the topic icon | +
This object represents a service message about a forum topic closed in the chat. Currently holds no information.
+This object represents a service message about a forum topic reopened in the chat. Currently holds no information.
This object represents a service message about a video chat scheduled in the chat.
| Boolean | Optional. True, if the user is allowed to pin messages; groups and supergroups only | +|
| can_manage_topics | +Boolean | +Optional. True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only | +
This object represents a forum topic.
+| Field | +Type | +Description | +
|---|---|---|
| message_thread_id | +Integer | +Unique identifier of the forum topic | +
| name | +String | +Name of the topic | +
| icon_color | +Integer | +Color of the topic icon in RGB format | +
| icon_custom_emoji_id | +String | +Optional. Unique identifier of the custom emoji shown as the topic icon | +
This object represents a bot command.
Unique identifier for the target chat or username of the target channel (in the format @channelusername) |
||||
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| text | String | Yes | @@ -3542,6 +3687,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| from_chat_id | Integer or String | Yes | @@ -3586,6 +3737,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| from_chat_id | Integer or String | Yes | @@ -3666,6 +3823,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| photo | InputFile or String | Yes | @@ -3741,6 +3904,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| audio | InputFile or String | Yes | @@ -3839,6 +4008,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| document | InputFile or String | Yes | @@ -3925,6 +4100,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| video | InputFile or String | Yes | @@ -4029,6 +4210,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| animation | InputFile or String | Yes | @@ -4127,6 +4314,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| voice | InputFile or String | Yes | @@ -4207,6 +4400,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| video_note | InputFile or String | Yes | @@ -4281,6 +4480,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| media | Array of InputMediaAudio, InputMediaDocument, InputMediaPhoto and InputMediaVideo | Yes | @@ -4331,6 +4536,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| latitude | Float number | Yes | @@ -4523,6 +4734,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| latitude | Float number | Yes | @@ -4621,6 +4838,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| phone_number | String | Yes | @@ -4695,6 +4918,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| question | String | Yes | @@ -4817,6 +5046,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername) |
|
| message_thread_id | +Integer | +Optional | +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only | +|
| emoji | String | Optional | @@ -5135,6 +5370,12 @@ pre-formatted fixed-width code block written in the Python programming languageOptional | Pass True if the administrator can pin messages, supergroups only |
| can_manage_topics | +Boolean | +Optional | +Pass True if the user is allowed to create, rename, close, and reopen forum topics, supergroups only | +
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.
+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.
+| Parameter | +Type | +Required | +Description | +
|---|---|---|---|
| chat_id | +Integer or String | +Yes | +Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) |
+
| name | +String | +Yes | +Topic name, 1-128 characters | +
| icon_color | +Integer | +Optional | +Color of the topic icon in RGB format. Currently, must be one of 0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, 0xFF93B2, or 0xFB6F5F | +
| icon_custom_emoji_id | +String | +Optional | +Unique identifier of the custom emoji shown as the topic icon. Use getForumTopicIconStickers to get all allowed custom emoji identifiers. | +
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.
+| Parameter | +Type | +Required | +Description | +
|---|---|---|---|
| chat_id | +Integer or String | +Yes | +Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) |
+
| message_thread_id | +Integer | +Yes | +Unique identifier for the target message thread of the forum topic | +
| name | +String | +Yes | +New topic name, 1-128 characters | +
| icon_custom_emoji_id | +String | +Yes | +New unique identifier of the custom emoji shown as the topic icon. Use getForumTopicIconStickers to get all allowed custom emoji identifiers | +
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.
+| Parameter | +Type | +Required | +Description | +
|---|---|---|---|
| chat_id | +Integer or String | +Yes | +Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) |
+
| message_thread_id | +Integer | +Yes | +Unique identifier for the target message thread of the forum topic | +
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.
+| Parameter | +Type | +Required | +Description | +
|---|---|---|---|
| chat_id | +Integer or String | +Yes | +Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) |
+
| message_thread_id | +Integer | +Yes | +Unique identifier for the target message thread of the forum topic | +
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.
+| Parameter | +Type | +Required | +Description | +
|---|---|---|---|
| chat_id | +Integer or String | +Yes | +Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) |
+
| message_thread_id | +Integer | +Yes | +Unique identifier for the target message thread of the forum topic | +
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.
+| Parameter | +Type | +Required | +Description | +
|---|---|---|---|
| chat_id | +Integer or String | +Yes | +Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) |
+
| message_thread_id | +Integer | +Yes | +Unique identifier for the target message thread of the forum topic | +
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.
@@ -6231,7 +6654,7 @@ pre-formatted fixed-width code block written in the Python programming languagedeleteMessage
-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.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.
@@ -6441,6 +6864,12 @@ pre-formatted fixed-width code block written in the Python programming language Unique identifier for the target chat or username of the target channel (in the format @channelusername)+ +message_thread_id +Integer +Optional +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only +sticker InputFile or String Yes @@ -8615,6 +9044,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat or username of the target channel (in the format @channelusername)+ +message_thread_id +Integer +Optional +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only +title String Yes @@ -9793,6 +10228,12 @@ pre-formatted fixed-width code block written in the Python programming languageUnique identifier for the target chat + +message_thread_id +Integer +Optional +Unique identifier for the target message thread (topic) of the forum; for forum supergroups only +game_short_name String Yes diff --git a/data/web/corefork.telegram.org/bots/api-changelog.html b/data/web/corefork.telegram.org/bots/api-changelog.html index 79e4c9a0fc..69cae66e1b 100644 --- a/data/web/corefork.telegram.org/bots/api-changelog.html +++ b/data/web/corefork.telegram.org/bots/api-changelog.html @@ -54,6 +54,20 @@ To learn how to create…">+Subscribe to @BotNews to be the first to know about the latest updates and join the discussion in @BotTalk
November 5, 2022
+Bot API 6.3
++
- Added support for Topics in Groups.
+- Added the field is_forum to the class Chat.
+- Added the fields is_topic_message and message_thread_id to the class Message to allow detection of messages belonging to a forum topic and their message thread identifier.
+- Added the classes ForumTopicCreated, ForumTopicClosed, and ForumTopicReopened and the fields forum_topic_created, forum_topic_closed, and forum_topic_reopened to the class Message. Note that service messages about forum topic creation can't be deleted with the deleteMessage method.
+- Added the field can_manage_topics to the classes ChatAdministratorRights, ChatPermissions, ChatMemberAdministrator, and ChatMemberRestricted.
+- Added the parameter can_manage_topics to the method promoteChatMember.
+- Added the methods createForumTopic, editForumTopic, closeForumTopic, reopenForumTopic, deleteForumTopic, unpinAllForumTopicMessages, and getForumTopicIconStickers for forum topic management.
+- Added the parameter message_thread_id to the methods sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, sendMediaGroup, copyMessage, forwardMessage to support sending of messages to a forum topic.
+- Added support for Multiple Usernames via the field active_usernames in the class Chat.
+- Added the field emoji_status_custom_emoji_id to the class Chat.
+August 12, 2022
Bot API 6.2
Custom Emoji Support