5 Commits

Author SHA1 Message Date
renovate[bot]
9ca08973d1 Update dependency mkdocs-material to v9.7.6 2026-05-02 00:02:13 +00:00
72aece1cf4 fix of Message hierarchy 2026-04-30 11:23:10 +06:00
7c6e8ac655 fix messages hierarchy showing 2026-04-29 20:59:17 +06:00
446c6d7516 add updates section 2026-04-29 20:59:17 +06:00
b64117f829 Update index.md 2026-04-25 12:33:36 +06:00
5 changed files with 125 additions and 22 deletions

View File

@@ -1,6 +1,6 @@
# TelegramBotAPI
[![Maven Central Version](https://img.shields.io/maven-central/v/dev.inmo/tgbotapi)](https://central.sonatype.com/artifact/dev.inmo/tgbotapi) [![Supported version](https://img.shields.io/badge/Telegram%20Bot%20API-9.0-blue)](https://core.telegram.org/bots/api-changelog#april-11-2025)
[![Maven Central Version](https://img.shields.io/maven-central/v/dev.inmo/tgbotapi)](https://central.sonatype.com/artifact/dev.inmo/tgbotapi) [![Supported version](https://img.shields.io/badge/Telegram%20Bot%20API-9.6-blue)](https://core.telegram.org/bots/api-changelog#april-3-2026)
<!--- [![Telegram Channel](./resources/tg_channel_qr.jpg)](https://t.me/ktgbotapi) --->

View File

@@ -1,6 +1,108 @@
# Types conversations
One of the most important topics in context of tgbotapi is types conversations. This library is very strong-typed and a lot of things are based on types hierarchy. Lets look into the hierarchy of classes for the [Message](https://github.com/InsanusMokrassar/TelegramBotAPI/blob/master/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/message/abstracts/Message.kt#L12) in 0.35.8: [![Message Diagram.png](https://bookstack.inmo.dev/uploads/images/gallery/2021-09/scaled-1680-/message-diagram.png)](https://bookstack.inmo.dev/uploads/images/gallery/2021-09/message-diagram.png)
# Types conversations
One of the most important topics in context of tgbotapi is types conversations. This library is very strong-typed and a lot of things are based on types hierarchy. Lets look into the hierarchy of classes for the [Message](https://github.com/InsanusMokrassar/TelegramBotAPI/blob/master/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/message/abstracts/Message.kt#L12) in 0.35.8:
```mermaid
%%{init: {"flowchart": {"defaultRenderer": "elk"}} }%%
classDiagram
Message <|-- AccessibleMessage
AccessibleMessage <|-- ChatEventMessage
ChatEventMessage <|-- ChannelEventMessage
ChatEventMessage <|-- GroupEventMessage
GroupEventMessage <|-- ChannelDirectMessagesEventMessage
ChannelDirectMessagesEventMessage <|-- CommonChannelDirectMessagesEventMessage
GroupEventMessage <|-- CommonGroupEventMessage
GroupEventMessage <|-- SupergroupEventMessage
SupergroupEventMessage <|-- CommonSupergroupEventMessage
ChatEventMessage <|-- PrivateEventMessage
ChatEventMessage <|-- PrivateForumEventMessage
AccessibleMessage <|-- CommonMessage
CommonMessage <|-- PossiblySentViaBotCommonMessage
PossiblySentViaBotCommonMessage <|-- BusinessContentMessage
BusinessContentMessage <|-- BusinessContentMessageImpl
PossiblySentViaBotCommonMessage <|-- ChannelContentMessage
ChannelContentMessage <|-- ChannelContentMessageImpl
ChannelContentMessage <|-- ChannelPaidPost
ChannelPaidPost <|-- ChannelPaidPostImpl
PossiblySentViaBotCommonMessage <|-- PrivateContentMessage
PrivateContentMessage <|-- PrivateContentMessageImpl
PrivateContentMessage <|-- PrivateForumContentMessage
PrivateForumContentMessage <|-- PrivateForumContentMessageImpl
PossiblySentViaBotCommonMessage <|-- PublicContentMessage
PublicContentMessage <|-- GroupContentMessage
GroupContentMessage <|-- AnonymousGroupContentMessage
AnonymousGroupContentMessage <|-- AnonymousGroupContentMessageImpl
GroupContentMessage <|-- ChannelDirectMessagesContentMessage
ChannelDirectMessagesContentMessage <|-- CommonChannelDirectMessagesContentMessage
CommonChannelDirectMessagesContentMessage <|-- CommonChannelDirectMessagesContentMessageImpl
ChannelDirectMessagesContentMessage <|-- FromChannelChannelDirectMessagesContentMessage
FromChannelChannelDirectMessagesContentMessage <|-- FromChannelChannelDirectMessagesContentMessageImpl
ChannelDirectMessagesContentMessage <|-- SuggestedChannelDirectMessagesContentMessage
SuggestedChannelDirectMessagesContentMessage <|-- CommonSuggestedChannelDirectMessagesContentMessage
CommonSuggestedChannelDirectMessagesContentMessage <|-- CommonSuggestedChannelDirectMessagesContentMessageImpl
SuggestedChannelDirectMessagesContentMessage <|-- FromChannelSuggestedChannelDirectMessagesContentMessage
FromChannelSuggestedChannelDirectMessagesContentMessage <|-- FromChannelSuggestedChannelDirectMessagesContentMessageImpl
GroupContentMessage <|-- CommonGroupContentMessage
CommonGroupContentMessage <|-- CommonGroupContentMessageImpl
GroupContentMessage <|-- ForumContentMessage
ForumContentMessage <|-- AnonymousForumContentMessage
AnonymousForumContentMessage <|-- AnonymousForumContentMessageImpl
ForumContentMessage <|-- CommonForumContentMessage
CommonForumContentMessage <|-- CommonForumContentMessageImpl
ForumContentMessage <|-- FromChannelForumContentMessage
FromChannelForumContentMessage <|-- FromChannelForumContentMessageImpl
GroupContentMessage <|-- FromChannelGroupContentMessage
FromChannelGroupContentMessage <|-- ConnectedFromChannelGroupContentMessage
ConnectedFromChannelGroupContentMessage <|-- ConnectedFromChannelGroupContentMessageImpl
FromChannelGroupContentMessage <|-- FromChannelChannelDirectMessagesContentMessage
FromChannelGroupContentMessage <|-- FromChannelForumContentMessage
FromChannelGroupContentMessage <|-- FromChannelSuggestedChannelDirectMessagesContentMessage
FromChannelGroupContentMessage <|-- UnconnectedFromChannelGroupContentMessage
UnconnectedFromChannelGroupContentMessage <|-- UnconnectedFromChannelGroupContentMessageImpl
GroupContentMessage <|-- PotentiallyFromUserGroupContentMessage
PotentiallyFromUserGroupContentMessage <|-- CommonChannelDirectMessagesContentMessage
PotentiallyFromUserGroupContentMessage <|-- CommonForumContentMessage
PotentiallyFromUserGroupContentMessage <|-- CommonGroupContentMessage
PotentiallyFromUserGroupContentMessage <|-- CommonSuggestedChannelDirectMessagesContentMessage
AccessibleMessage <|-- ContentMessage
ContentMessage <|-- CommonMessage
ContentMessage <|-- PossiblyMediaGroupMessage
PossiblyMediaGroupMessage <|-- CommonMessage
AccessibleMessage <|-- OptionallyFromUserMessage
OptionallyFromUserMessage <|-- ChannelContentMessage
OptionallyFromUserMessage <|-- FromUserMessage
FromUserMessage <|-- BusinessContentMessage
FromUserMessage <|-- CommonChannelDirectMessagesContentMessage
FromUserMessage <|-- CommonForumContentMessage
FromUserMessage <|-- CommonGroupContentMessage
FromUserMessage <|-- CommonSuggestedChannelDirectMessagesContentMessage
FromUserMessage <|-- GroupEventMessage
FromUserMessage <|-- PassportMessage
FromUserMessage <|-- PrivateContentMessage
AccessibleMessage <|-- PassportMessage
AccessibleMessage <|-- PossiblyEditedMessage
PossiblyEditedMessage <|-- CommonMessage
AccessibleMessage <|-- PossiblyForwardedMessage
PossiblyForwardedMessage <|-- CommonMessage
AccessibleMessage <|-- PossiblyPaymentMessage
AccessibleMessage <|-- PossiblyTopicMessage
PossiblyTopicMessage <|-- ForumContentMessage
PossiblyTopicMessage <|-- PrivateForumContentMessage
AccessibleMessage <|-- SignedMessage
SignedMessage <|-- AnonymousForumContentMessage
SignedMessage <|-- AnonymousGroupContentMessage
SignedMessage <|-- ChannelContentMessage
SignedMessage <|-- FromChannelGroupContentMessage
AccessibleMessage <|-- UnknownMessageType
Message <|-- InaccessibleMessage
Message <|-- PossiblyOfflineMessage
PossiblyOfflineMessage <|-- CommonMessage
PossiblyOfflineMessage <|-- PrivateContentMessage
Message <|-- PossiblyPaidMessage
PossiblyPaidMessage <|-- CommonMessage
Message <|-- PossiblyWithEffectMessage
PossiblyWithEffectMessage <|-- PrivateContentMessage
```
As you may see, it is a little bit complex and require several tools for types conversation.

View File

@@ -0,0 +1 @@
This secion contains information about way of getting updates and additional info related to it.

View File

@@ -30,6 +30,7 @@ nav:
- Guides:
- 'tgbotapi/guides/keyboards.md'
- Updates retrieving:
- 'tgbotapi/updates/index.md'
- 'tgbotapi/updates/updates-filters.md'
- 'tgbotapi/updates/long-polling.md'
- 'tgbotapi/updates/webhooks.md'

35
poetry.lock generated
View File

@@ -470,33 +470,32 @@ mkdocs = ">=1.0.4"
[[package]]
name = "mkdocs-material"
version = "9.6.17"
version = "9.7.6"
description = "Documentation that simply works"
optional = false
python-versions = ">=3.8"
files = [
{file = "mkdocs_material-9.6.17-py3-none-any.whl", hash = "sha256:221dd8b37a63f52e580bcab4a7e0290e4a6f59bd66190be9c3d40767e05f9417"},
{file = "mkdocs_material-9.6.17.tar.gz", hash = "sha256:48ae7aec72a3f9f501a70be3fbd329c96ff5f5a385b67a1563e5ed5ce064affe"},
{file = "mkdocs_material-9.7.6-py3-none-any.whl", hash = "sha256:71b84353921b8ea1ba84fe11c50912cc512da8fe0881038fcc9a0761c0e635ba"},
{file = "mkdocs_material-9.7.6.tar.gz", hash = "sha256:00bdde50574f776d328b1862fe65daeaf581ec309bd150f7bff345a098c64a69"},
]
[package.dependencies]
babel = ">=2.10,<3.0"
backrefs = ">=5.7.post1,<6.0"
click = "<8.2.2"
colorama = ">=0.4,<1.0"
jinja2 = ">=3.1,<4.0"
markdown = ">=3.2,<4.0"
mkdocs = ">=1.6,<2.0"
mkdocs-material-extensions = ">=1.3,<2.0"
paginate = ">=0.5,<1.0"
pygments = ">=2.16,<3.0"
pymdown-extensions = ">=10.2,<11.0"
requests = ">=2.26,<3.0"
babel = ">=2.10"
backrefs = ">=5.7.post1"
colorama = ">=0.4"
jinja2 = ">=3.1"
markdown = ">=3.2"
mkdocs = ">=1.6,<2"
mkdocs-material-extensions = ">=1.3"
paginate = ">=0.5"
pygments = ">=2.16"
pymdown-extensions = ">=10.2"
requests = ">=2.30"
[package.extras]
git = ["mkdocs-git-committers-plugin-2 (>=1.1,<3)", "mkdocs-git-revision-date-localized-plugin (>=1.2.4,<2.0)"]
imaging = ["cairosvg (>=2.6,<3.0)", "pillow (>=10.2,<11.0)"]
recommended = ["mkdocs-minify-plugin (>=0.7,<1.0)", "mkdocs-redirects (>=1.2,<2.0)", "mkdocs-rss-plugin (>=1.6,<2.0)"]
git = ["mkdocs-git-committers-plugin-2 (>=1.1)", "mkdocs-git-revision-date-localized-plugin (>=1.2.4)"]
imaging = ["cairosvg (>=2.6)", "pillow (>=10.2)"]
recommended = ["mkdocs-minify-plugin (>=0.7)", "mkdocs-redirects (>=1.2)", "mkdocs-rss-plugin (>=1.6)"]
[[package]]
name = "mkdocs-material-extensions"