Bot API 6.3

[TiiFuchs]

• 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.

Database Changes

• Added the field is_forum to the class Chat.
• Added the fields is_topic_message and message_thread_id to the class Message
• Added the fields forum_topic_created, forum_topic_closed, and forum_topic_reopened to the class Message

[TiiFuchs]

@noplanman The chat table in the DB does not contain every field of the Chat class.
Is that intentional?

Plus it still has a all_members_are_administrators field...?
Don't know where this comes from... Changelog.md says it was removed from Message entity.

[TiiFuchs]

Now only the DB changes for Chat are left.

The question remains whether the new fields should be created and whether the missing fields should be retrofitted.

[noplanman]

@TiiFuchs Where is the PR?

The Chat table doesn't include columns for values that are "Returned only in getChat".
We save in the DB what comes through from the API in messages, it's not an active scraping of data, which would need to be done periodically to keep it updated.

The all_members_are_administrators field was left for BC in the last release, in case users were accessing it directly from the DB still. Let's leave it in for now and add a "Will be removed in the next release" note for the next changelog entry.

[TiiFuchs]

Work is in the api-6.3 branch. PR comes when it's finished.