mirror of
https://github.com/InsanusMokrassar/TelegramBotAPI-examples.git
synced 2026-06-29 14:45:08 +00:00
Compare commits
1 Commits
35.0.0
...
renovate/k
| Author | SHA1 | Date | |
|---|---|---|---|
|
2bf49f9cb9 |
@@ -1,21 +0,0 @@
|
||||
buildscript {
|
||||
repositories {
|
||||
mavenCentral()
|
||||
}
|
||||
|
||||
dependencies {
|
||||
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
|
||||
}
|
||||
}
|
||||
|
||||
apply plugin: 'kotlin'
|
||||
apply plugin: 'application'
|
||||
|
||||
mainClassName="JoinRequestQueriesBotKt"
|
||||
|
||||
|
||||
dependencies {
|
||||
implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
|
||||
|
||||
implementation "dev.inmo:tgbotapi:$telegram_bot_api_version"
|
||||
}
|
||||
@@ -1,106 +0,0 @@
|
||||
import dev.inmo.kslog.common.KSLog
|
||||
import dev.inmo.kslog.common.LogLevel
|
||||
import dev.inmo.kslog.common.defaultMessageFormatter
|
||||
import dev.inmo.kslog.common.setDefaultKSLog
|
||||
import dev.inmo.micro_utils.coroutines.subscribeLoggingDropExceptions
|
||||
import dev.inmo.tgbotapi.extensions.api.bot.getMe
|
||||
import dev.inmo.tgbotapi.extensions.api.chat.get.getChat
|
||||
import dev.inmo.tgbotapi.extensions.api.chat.invite_links.answerChatJoinRequestQuery
|
||||
import dev.inmo.tgbotapi.extensions.api.chat.invite_links.sendChatJoinRequestWebApp
|
||||
import dev.inmo.tgbotapi.extensions.behaviour_builder.telegramBotWithBehaviourAndLongPolling
|
||||
import dev.inmo.tgbotapi.extensions.behaviour_builder.triggers_handling.onChatJoinRequest
|
||||
import dev.inmo.tgbotapi.requests.chat.invite_links.ChatJoinRequestQueryResult
|
||||
import kotlinx.coroutines.CoroutineScope
|
||||
import kotlinx.coroutines.Dispatchers
|
||||
|
||||
/**
|
||||
* This bot demonstrates Join Request Queries support introduced in Telegram Bot API 10.1.
|
||||
*
|
||||
* A "guard bot" of a chat receives chat join requests as queries and must process them with
|
||||
* [answerChatJoinRequestQuery] or hand the user a Web App via [sendChatJoinRequestWebApp]
|
||||
* (for example, to run a captcha / verification flow before deciding).
|
||||
*
|
||||
* Your bot must be set as the guard bot of the chat and must have `can_invite_users` rights to
|
||||
* receive these requests.
|
||||
*
|
||||
* Key concepts demonstrated:
|
||||
* - [dev.inmo.tgbotapi.types.chat.ExtendedBot.supportsJoinRequestQueries] — whether the bot itself
|
||||
* supports join request queries (from getMe(), maps `User.supports_join_request_queries`)
|
||||
* - [dev.inmo.tgbotapi.types.chat.ExtendedChat.guardBot] — the bot that processes join request
|
||||
* queries in a chat (from getChat(), maps `ChatFullInfo.guard_bot`)
|
||||
* - [dev.inmo.tgbotapi.types.chat.ChatJoinRequest.queryId] — the [dev.inmo.tgbotapi.types.ChatJoinRequestQueryId]
|
||||
* present when the request arrives as a query to the guard bot
|
||||
* - [answerChatJoinRequestQuery] with [ChatJoinRequestQueryResult] (Approve / Decline / Queue / Unknown)
|
||||
* - [sendChatJoinRequestWebApp] — open a Web App to process the request
|
||||
*/
|
||||
suspend fun main(vararg args: String) {
|
||||
val botToken = args.first()
|
||||
val isDebug = args.any { it == "debug" }
|
||||
val isTestServer = args.any { it == "testServer" }
|
||||
// pass a https url as the second argument to demonstrate sendChatJoinRequestWebApp
|
||||
val webAppUrl = args.getOrNull(1) ?.takeIf { it.startsWith("https://") }
|
||||
|
||||
if (isDebug) {
|
||||
setDefaultKSLog(
|
||||
KSLog { level: LogLevel, tag: String?, message: Any, throwable: Throwable? ->
|
||||
println(defaultMessageFormatter(level, tag, message, throwable))
|
||||
}
|
||||
)
|
||||
}
|
||||
|
||||
telegramBotWithBehaviourAndLongPolling(
|
||||
botToken,
|
||||
CoroutineScope(Dispatchers.IO),
|
||||
testServer = isTestServer
|
||||
) {
|
||||
val me = getMe()
|
||||
println("Bot info: $me")
|
||||
// supportsJoinRequestQueries reflects the supports_join_request_queries field from the Telegram API
|
||||
println("Supports join request queries: ${me.supportsJoinRequestQueries}")
|
||||
|
||||
onChatJoinRequest { request ->
|
||||
println("=== Chat join request received ===")
|
||||
println(" from: ${request.from}")
|
||||
println(" chat: ${request.chat}")
|
||||
println(" bio: ${request.bio}")
|
||||
// queryId is non-null only when the request arrives as a query to this bot as the guard bot
|
||||
println(" queryId: ${request.queryId}")
|
||||
|
||||
// guardBot is the bot processing join request queries in this chat (admins-only field)
|
||||
val guardBot = runCatching { getChat(request.chat).guardBot }.getOrNull()
|
||||
println(" guardBot: $guardBot")
|
||||
|
||||
val queryId = request.queryId
|
||||
if (queryId == null) {
|
||||
println(" -> request has no queryId, this bot is not the guard bot here")
|
||||
return@onChatJoinRequest
|
||||
}
|
||||
|
||||
if (webAppUrl != null) {
|
||||
// sendChatJoinRequestWebApp: hand the user a Web App (e.g. captcha) instead of deciding now
|
||||
sendChatJoinRequestWebApp(request, webAppUrl)
|
||||
println(" -> sent join request Web App: $webAppUrl")
|
||||
return@onChatJoinRequest
|
||||
}
|
||||
|
||||
// answerChatJoinRequestQuery with one of the ChatJoinRequestQueryResult variants:
|
||||
// Approve — allow the user to join
|
||||
// Decline — disallow the user to join
|
||||
// Queue — leave the decision to other administrators
|
||||
// Unknown — any future result not yet known to the library
|
||||
val result = if (request.bio.isNullOrBlank()) {
|
||||
// no bio -> let other admins decide
|
||||
ChatJoinRequestQueryResult.Queue
|
||||
} else {
|
||||
// has a bio -> approve
|
||||
ChatJoinRequestQueryResult.Approve
|
||||
}
|
||||
answerChatJoinRequestQuery(request, result)
|
||||
println(" -> answered with: ${result.name}")
|
||||
}
|
||||
|
||||
allUpdatesFlow.subscribeLoggingDropExceptions(scope = this) {
|
||||
println(it)
|
||||
}
|
||||
}.second.join()
|
||||
}
|
||||
@@ -25,7 +25,6 @@ import dev.inmo.tgbotapi.types.BotCommand
|
||||
import dev.inmo.tgbotapi.types.IdChatIdentifier
|
||||
import dev.inmo.tgbotapi.types.PollId
|
||||
import dev.inmo.tgbotapi.types.ReplyParameters
|
||||
import dev.inmo.tgbotapi.types.media.TelegramMediaLink
|
||||
import dev.inmo.tgbotapi.types.media.TelegramMediaLocation
|
||||
import dev.inmo.tgbotapi.types.media.TelegramMediaSticker
|
||||
import dev.inmo.tgbotapi.types.media.TelegramMediaVenue
|
||||
@@ -56,8 +55,6 @@ import kotlin.random.Random
|
||||
* * `/members_only` — poll with `membersOnly = true` (new [dev.inmo.tgbotapi.types.polls.Poll.membersOnly] field)
|
||||
* * `/country_codes` — poll with `countryCodes` (new [dev.inmo.tgbotapi.types.polls.Poll.countryCodes] field)
|
||||
* * `/single_option` — poll with just 1 option (minimum options count decreased from 2 to 1)
|
||||
* * `/link_poll` — poll whose options carry a [TelegramMediaLink] (InputMediaLink / Bot API 10.1
|
||||
* [dev.inmo.tgbotapi.types.Link]) as [dev.inmo.tgbotapi.types.media.InputPollOptionMedia]
|
||||
*
|
||||
* [onPollUpdates] prints [dev.inmo.tgbotapi.types.polls.Poll.media], [dev.inmo.tgbotapi.types.polls.Poll.membersOnly],
|
||||
* [dev.inmo.tgbotapi.types.polls.Poll.countryCodes], [QuizPoll.explanationMedia], and
|
||||
@@ -315,30 +312,6 @@ suspend fun main(vararg args: String) {
|
||||
}
|
||||
}
|
||||
|
||||
// Demonstrates TelegramMediaLink (InputMediaLink, Bot API 10.1) as poll option media.
|
||||
// Link is the only new poll media type in 10.1 and is allowed only as InputPollOptionMedia.
|
||||
onCommand("link_poll") {
|
||||
val sentPoll = sendRegularPoll(
|
||||
it.chat.id,
|
||||
buildEntities { regular("Pick your favourite resource") },
|
||||
listOf(
|
||||
// InputPollOptionMedia via TelegramMediaLink (InputMediaLink)
|
||||
InputPollOption(
|
||||
media = TelegramMediaLink("https://core.telegram.org/bots/api")
|
||||
) { regular("Bot API docs") },
|
||||
InputPollOption(
|
||||
media = TelegramMediaLink("https://github.com/InsanusMokrassar/ktgbotapi")
|
||||
) { regular("ktgbotapi") },
|
||||
InputPollOption { regular("None of these") },
|
||||
),
|
||||
isAnonymous = false,
|
||||
replyParameters = ReplyParameters(it)
|
||||
)
|
||||
pollToChatMutex.withLock {
|
||||
pollToChat[sentPoll.content.poll.id] = sentPoll.chat.id
|
||||
}
|
||||
}
|
||||
|
||||
onPollAnswer {
|
||||
val chatId = pollToChat[it.pollId] ?: return@onPollAnswer
|
||||
|
||||
@@ -407,7 +380,6 @@ suspend fun main(vararg args: String) {
|
||||
BotCommand("members_only", "Poll restricted to channel members only (membersOnly)"),
|
||||
BotCommand("country_codes", "Poll targeted to US, DE, JP users (countryCodes)"),
|
||||
BotCommand("single_option", "Poll with 1 option (minimum is now 1, not 2)"),
|
||||
BotCommand("link_poll", "Poll with link media (TelegramMediaLink) on options"),
|
||||
)
|
||||
|
||||
allUpdatesFlow.subscribeLoggingDropExceptions(scope = this) {
|
||||
|
||||
@@ -1,21 +0,0 @@
|
||||
buildscript {
|
||||
repositories {
|
||||
mavenCentral()
|
||||
}
|
||||
|
||||
dependencies {
|
||||
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
|
||||
}
|
||||
}
|
||||
|
||||
apply plugin: 'kotlin'
|
||||
apply plugin: 'application'
|
||||
|
||||
mainClassName="RichMessagesBotKt"
|
||||
|
||||
|
||||
dependencies {
|
||||
implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
|
||||
|
||||
implementation "dev.inmo:tgbotapi:$telegram_bot_api_version"
|
||||
}
|
||||
@@ -1,408 +0,0 @@
|
||||
import dev.inmo.kslog.common.KSLog
|
||||
import dev.inmo.kslog.common.LogLevel
|
||||
import dev.inmo.kslog.common.defaultMessageFormatter
|
||||
import dev.inmo.kslog.common.setDefaultKSLog
|
||||
import dev.inmo.micro_utils.coroutines.subscribeLoggingDropExceptions
|
||||
import dev.inmo.tgbotapi.extensions.api.answers.answer
|
||||
import dev.inmo.tgbotapi.extensions.api.bot.setMyCommands
|
||||
import dev.inmo.tgbotapi.extensions.api.send.reply
|
||||
import dev.inmo.tgbotapi.extensions.api.send.send
|
||||
import dev.inmo.tgbotapi.extensions.api.send.sendRichMessage
|
||||
import dev.inmo.tgbotapi.extensions.api.send.sendRichMessageDraft
|
||||
import dev.inmo.tgbotapi.extensions.behaviour_builder.expectations.waitRichMessage
|
||||
import dev.inmo.tgbotapi.extensions.behaviour_builder.telegramBotWithBehaviourAndLongPolling
|
||||
import dev.inmo.tgbotapi.extensions.behaviour_builder.triggers_handling.onBaseInlineQuery
|
||||
import dev.inmo.tgbotapi.extensions.behaviour_builder.triggers_handling.onCommand
|
||||
import dev.inmo.tgbotapi.extensions.behaviour_builder.triggers_handling.onRichMessage
|
||||
import dev.inmo.tgbotapi.extensions.utils.baseSentMessageUpdateOrNull
|
||||
import dev.inmo.tgbotapi.extensions.utils.contentMessageOrNull
|
||||
import dev.inmo.tgbotapi.extensions.utils.onlyRichMessageContentMessages
|
||||
import dev.inmo.tgbotapi.requests.edit.text.EditChatMessageRichText
|
||||
import dev.inmo.tgbotapi.types.BotCommand
|
||||
import dev.inmo.tgbotapi.types.InlineQueries.InlineQueryResult.InlineQueryResultArticle
|
||||
import dev.inmo.tgbotapi.types.InlineQueries.InputMessageContent.InputRichMessageContent
|
||||
import dev.inmo.tgbotapi.types.InlineQueryId
|
||||
import dev.inmo.tgbotapi.types.rich.InputRichMessageHTML
|
||||
import dev.inmo.tgbotapi.types.rich.InputRichMessageMarkdown
|
||||
import dev.inmo.tgbotapi.types.toChatId
|
||||
import kotlinx.coroutines.CoroutineScope
|
||||
import kotlinx.coroutines.Dispatchers
|
||||
import kotlinx.coroutines.delay
|
||||
import kotlinx.coroutines.flow.first
|
||||
import kotlinx.coroutines.flow.mapNotNull
|
||||
|
||||
/**
|
||||
* This bot demonstrates Rich Messages support introduced in Telegram Bot API 10.1.
|
||||
*
|
||||
* Rich messages allow bots to send highly structured text (and to stream AI-generated replies
|
||||
* with seamless rich formatting). Telegram parses the provided HTML/Markdown into a structured
|
||||
* [dev.inmo.tgbotapi.types.rich.RichMessage] made of [dev.inmo.tgbotapi.types.rich.RichBlock]s.
|
||||
*
|
||||
* Key concepts demonstrated:
|
||||
* - [dev.inmo.tgbotapi.types.rich.InputRichMessage] — describes a rich message to send. Built only via
|
||||
* the [InputRichMessageHTML] / [InputRichMessageMarkdown] factories (exactly one format must be used)
|
||||
* - [sendRichMessage] — sendRichMessage method
|
||||
* - [sendRichMessageDraft] — sendRichMessageDraft method: stream partial rich messages by draftId
|
||||
* - [EditChatMessageRichText] — editMessageText with the new `rich_message` parameter
|
||||
* - [onRichMessage] — trigger for incoming [dev.inmo.tgbotapi.types.message.content.RichMessageContent]
|
||||
* (the new `rich_message` field of Message)
|
||||
* - [waitRichMessage] — expectation for a rich message
|
||||
* - [onlyRichMessageContentMessages] — flow filter keeping only rich message content
|
||||
* - [InputRichMessageContent] — usable as InputMessageContent in inline query results
|
||||
*/
|
||||
suspend fun main(vararg args: String) {
|
||||
val botToken = args.first()
|
||||
val isDebug = args.any { it == "debug" }
|
||||
val isTestServer = args.any { it == "testServer" }
|
||||
|
||||
if (isDebug) {
|
||||
setDefaultKSLog(
|
||||
KSLog { level: LogLevel, tag: String?, message: Any, throwable: Throwable? ->
|
||||
println(defaultMessageFormatter(level, tag, message, throwable))
|
||||
}
|
||||
)
|
||||
}
|
||||
|
||||
telegramBotWithBehaviourAndLongPolling(
|
||||
botToken,
|
||||
CoroutineScope(Dispatchers.IO),
|
||||
testServer = isTestServer
|
||||
) {
|
||||
// sendRichMessage with HTML-formatted content
|
||||
onCommand("rich_html") {
|
||||
sendRichMessage(
|
||||
it.chat.id,
|
||||
// InputRichMessageHTML factory — content described using HTML formatting
|
||||
InputRichMessageHTML(
|
||||
"""
|
||||
<a name="chapter-0"></a>
|
||||
<b>bold text</b>, <strong>bold text</strong>
|
||||
<i>italic text</i>, <em>italic text</em>
|
||||
<u>underlined text</u>, <ins>underlined text</ins>
|
||||
<s>strikethrough text</s>, <strike>strikethrough text</strike>, <del>strikethrough text</del>
|
||||
<code>inline fixed-width code</code>
|
||||
<mark>marked text</mark>
|
||||
<sub>subscript text</sub>
|
||||
<sup>superscript text</sup>
|
||||
<tg-spoiler>spoiler</tg-spoiler>
|
||||
|
||||
<a href="#note-1">Reference</a>
|
||||
<a href="https://t.me/">inline URL</a>
|
||||
<a href="mailto:user@example.com">inline e-mail</a>
|
||||
<a href="tel:+123456789">inline phone number</a>
|
||||
<a href="tg://user?id=123456789">inline mention of a user</a>
|
||||
<a href="#chapter-1">in-document link</a>
|
||||
<a name="chapter-1"></a>
|
||||
|
||||
<tg-reference name="note-1">Referenced text</tg-reference>
|
||||
<tg-emoji emoji-id="5368324170671202286">👍</tg-emoji>
|
||||
<img src="tg://emoji?id=5368324170671202286" alt="👍"/>
|
||||
<tg-time unix="1647531900" format="wDT">22:45 tomorrow</tg-time>
|
||||
<tg-math>x^2 + y^2</tg-math>
|
||||
|
||||
#hashtag ${'$'}USD +12345678901, card: 4242 4242 4242 4242, https://t.me t.me a@t.me /command @username
|
||||
|
||||
all the text above was on the same line
|
||||
|
||||
<h1>Heading 1</h1>
|
||||
<h2>Heading 2</h2>
|
||||
<h3>Heading 3</h3>
|
||||
<h4>Heading 4</h4>
|
||||
<h5>Heading 5</h5>
|
||||
<h6>Heading 6</h6>
|
||||
|
||||
<a name="chapter-2"></a>
|
||||
|
||||
<p>Paragraph text</p>
|
||||
<pre>pre-formatted fixed-width code block</pre>
|
||||
<pre><code class="language-python"> print('pre-formatted fixed-width code block written in the Python programming language')</code></pre>
|
||||
<footer>Footer text</footer>
|
||||
<hr/>
|
||||
<ul><li>unordered list item</li></ul>
|
||||
<ol><li>ordered list item</li></ol>
|
||||
<ol start="3" type="a" reversed><li>ordered list item</li></ol>
|
||||
<ol><li value="7" type="i">ordered list item with explicit number</li></ol>
|
||||
<ul>
|
||||
<li><input type="checkbox" checked>Checked checkbox</li>
|
||||
<li><input type="checkbox">Unchecked checkbox</li>
|
||||
</ul>
|
||||
|
||||
<blockquote>Block quotation started<br>Block quotation continued<br>The last line of the block quotation<cite>The Author</cite></blockquote>
|
||||
<aside>Pull quote<cite>The Author</cite></aside>
|
||||
|
||||
<img src="https://telegram.org/example/photo.jpg"/>
|
||||
<video src="https://telegram.org/example/video.mp4"></video>
|
||||
<audio src="https://telegram.org/example/audio.mp3"></audio>
|
||||
<audio src="https://telegram.org/example/audio.ogg"></audio>
|
||||
<video src="https://telegram.org/example/animation.gif"></video>
|
||||
|
||||
<figure><img src="https://telegram.org/example/photo.jpg" tg-spoiler/><figcaption>Photo caption<cite>Photo credit</cite></figcaption></figure>
|
||||
<figure><video src="https://telegram.org/example/video.mp4" tg-spoiler></video><figcaption>Video caption</figcaption></figure>
|
||||
<figure><audio src="https://telegram.org/example/audio.mp3"></audio><figcaption>Audio caption</figcaption></figure>
|
||||
<figure><audio src="https://telegram.org/example/audio.ogg"></audio><figcaption>Voice note caption</figcaption></figure>
|
||||
<figure><video src="https://telegram.org/example/animation.gif" tg-spoiler></video><figcaption>Animation caption</figcaption></figure>
|
||||
|
||||
<tg-map lat="41.9" long="12.5" zoom="14"/>
|
||||
<figure><tg-map lat="41.9" long="12.5" zoom="14"/><figcaption>Map caption</figcaption></figure>
|
||||
|
||||
<tg-collage><img src="https://telegram.org/example/photo.jpg"/><video src="https://telegram.org/example/video.mp4"/></tg-collage>
|
||||
<tg-collage><video src="https://telegram.org/example/video.mp4"/><img src="https://telegram.org/example/photo.jpg"/><figcaption>Collage caption</figcaption></tg-collage>
|
||||
<tg-slideshow><img src="https://telegram.org/example/photo.jpg"/><video src="https://telegram.org/example/video.mp4"/></tg-slideshow>
|
||||
<tg-slideshow><video src="https://telegram.org/example/video.mp4"/><img src="https://telegram.org/example/photo.jpg"/><figcaption>Slideshow caption</figcaption></tg-slideshow>
|
||||
|
||||
<table><tr><th>Header 1</th><th>Header 2</th></tr><tr><td>Value 1</td><td>Value 2</td></tr></table>
|
||||
<table bordered striped><caption>Table caption</caption>
|
||||
<tr><td colspan="2" rowspan="2" align="left">Value</td><td align="center">Value2</td><td align="right">Value3</td></tr>
|
||||
<tr><td valign="top">Value4</td><td valign="middle">Value5</td><td valign="bottom">Value6</td></tr>
|
||||
<tr><td>Value7</td></tr></table>
|
||||
|
||||
<details><summary>Title</summary>Content</details>
|
||||
<details open><summary>Title</summary>Content</details>
|
||||
<tg-math-block>E = mc^2</tg-math-block>
|
||||
""".trimIndent()
|
||||
)
|
||||
)
|
||||
}
|
||||
|
||||
// sendRichMessage with Markdown-formatted content
|
||||
onCommand("rich_markdown") {
|
||||
val sent = sendRichMessage(
|
||||
it.chat.id,
|
||||
// InputRichMessageMarkdown factory — content described using Markdown formatting
|
||||
InputRichMessageMarkdown(
|
||||
"""
|
||||
**bold text**
|
||||
__bold text__
|
||||
*italic text*
|
||||
_italic text_
|
||||
~~strikethrough text~~
|
||||
`inline fixed-width code`
|
||||
==marked text==
|
||||
||spoiler||
|
||||
|
||||
[inline URL](https://t.me/)
|
||||
[inline e-mail](mailto:user@example.com)
|
||||
[inline phone number](tel:+123456789)
|
||||
[inline mention of a user](tg://user?id=123456789)
|
||||
|
||||
|
||||
${'$'}x^2 + y^2$
|
||||
\#hashtag ${'$'}USD +12345678901, card: 4242 4242 4242 4242, https://t.me t.me a@t.me /command @username
|
||||
all the text above was on the same line
|
||||
|
||||
# Heading 1
|
||||
## Heading 2
|
||||
### Heading 3
|
||||
#### Heading 4
|
||||
##### Heading 5
|
||||
###### Heading 6
|
||||
|
||||
Paragraph text
|
||||
|
||||
```python
|
||||
print('pre-formatted fixed-width code block written in the Python programming language')
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
- unordered list item
|
||||
* unordered list item
|
||||
+ unordered list item
|
||||
|
||||
1. ordered list item
|
||||
2. ordered list item
|
||||
|
||||
- [ ] task list item
|
||||
- [x] completed task list item
|
||||
|
||||
>Block quotation started
|
||||
>
|
||||
>Block quotation continued on the next line
|
||||
>Block quotation continued on the same line
|
||||
>
|
||||
>The last line of the block quotation
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
| Header 1 | Header 2 |
|
||||
|:---------|:--------:|
|
||||
| left | center |
|
||||
|
||||
Text with a reference[^id1] and another one[^id2].
|
||||
|
||||
[^id1]: Definition of the first footnote.
|
||||
[^id2]: Definition of the second footnote.
|
||||
|
||||
$${'$'}E = mc^2$$
|
||||
|
||||
```math
|
||||
E = mc^2
|
||||
```
|
||||
|
||||
## Example Nested Syntax Report for _Q1_
|
||||
Intro with <u>underlined text</u>, ==marked text==, and ${'$'}x^2 + y^2$.
|
||||
**Bold _italic <u>underlined italic bold</u> italic_ bold**
|
||||
<u>In inline tags, nested **markdown** is parsed</u>
|
||||
>Quote with **bold text, ~~strikethrough, and <tg-spoiler>spoiler</tg-spoiler>~~**, plus [a link](https://t.me/).
|
||||
|
||||
- List item with `code`, <sup>superscript</sup>, <sub>subscript</sub>, and a footnote[^note]
|
||||
- Another item with **bold <tg-spoiler><code>spoiler code</code></tg-spoiler>**
|
||||
- Another item with ~~strikethrough and <ins>inserted text</ins>~~
|
||||
|
||||
| Metric | Value |
|
||||
|:-------|------:|
|
||||
| Speed | **42** <sup>ms</sup> |
|
||||
| Status | <tg-spoiler>ready</tg-spoiler> |
|
||||
|
||||
[^note]: Footnote with _italic text_ and <u>HTML underline</u>.
|
||||
|
||||
---
|
||||
|
||||
# Details blocks can contain Markdown content:
|
||||
|
||||
<details open><summary>Summary with **bold text**</summary>
|
||||
|
||||
### Details heading
|
||||
- List item with _italic text_
|
||||
- List item with <tg-spoiler>spoiler</tg-spoiler>
|
||||
|
||||
</details>
|
||||
|
||||
# Collages and slideshows can contain Markdown media blocks:
|
||||
|
||||
<tg-collage>
|
||||
|
||||
|
||||
|
||||
|
||||
</tg-collage>
|
||||
|
||||
<tg-slideshow>
|
||||
|
||||
|
||||
|
||||
|
||||
</tg-slideshow>
|
||||
""".trimIndent()
|
||||
)
|
||||
)
|
||||
println(sent)
|
||||
}
|
||||
|
||||
// sendRichMessageDraft: stream partial rich messages sharing one draftId, then finalize
|
||||
// with a full sendRichMessage. Emulates streaming of an AI-generated reply.
|
||||
onCommand("rich_draft") {
|
||||
val chatId = it.chat.id.toChatId()
|
||||
val draftId = 1L
|
||||
val parts = listOf(
|
||||
"Thinking",
|
||||
"Thinking about *rich* messages",
|
||||
"Thinking about *rich* messages and how to _stream_ them"
|
||||
)
|
||||
parts.forEach { part ->
|
||||
sendRichMessageDraft(chatId, draftId, InputRichMessageMarkdown(part))
|
||||
delay(1000)
|
||||
}
|
||||
// finalize the streamed draft with the real message
|
||||
sendRichMessage(chatId, InputRichMessageMarkdown("Done! Here is the *final* rich message."))
|
||||
}
|
||||
|
||||
// EditChatMessageRichText: send a rich message, then edit it with new rich content
|
||||
onCommand("rich_edit") {
|
||||
val sent = sendRichMessage(it.chat.id, InputRichMessageMarkdown("*Original* rich message"))
|
||||
delay(2000)
|
||||
execute(
|
||||
EditChatMessageRichText(
|
||||
chatId = sent.chat.id,
|
||||
messageId = sent.messageId,
|
||||
// the new rich_message parameter of editMessageText
|
||||
richMessage = InputRichMessageMarkdown("*Edited* rich message — now _updated_")
|
||||
)
|
||||
)
|
||||
}
|
||||
|
||||
// waitRichMessage expectation: wait for the user to send a rich message
|
||||
onCommand("wait_rich") {
|
||||
reply(it, "Send me a rich message now")
|
||||
val richMessageContent = waitRichMessage().first()
|
||||
reply(
|
||||
it,
|
||||
"Got rich message with ${richMessageContent.richMessage.blocks.size} block(s)"
|
||||
)
|
||||
}
|
||||
|
||||
// onRichMessage trigger: incoming messages carrying the new rich_message field
|
||||
onRichMessage { message ->
|
||||
val richMessage = message.content.richMessage
|
||||
println("=== Rich message received ===")
|
||||
println(" isRtl: ${richMessage.isRtl}")
|
||||
println(" blocks: ${richMessage.blocks.size}")
|
||||
richMessage.blocks.forEachIndexed { index, block ->
|
||||
println(" [$index] $block")
|
||||
}
|
||||
reply(message, "Received a rich message with ${richMessage.blocks.size} block(s)")
|
||||
execute(
|
||||
message.content.createResend(
|
||||
message.chat.id,
|
||||
)
|
||||
)
|
||||
}
|
||||
|
||||
// InputRichMessageContent as InputMessageContent of inline query results
|
||||
onBaseInlineQuery { query ->
|
||||
answer(
|
||||
query,
|
||||
results = listOf(
|
||||
InlineQueryResultArticle(
|
||||
InlineQueryId("rich_html"),
|
||||
"Rich message (HTML)",
|
||||
// InputRichMessageContent wraps an InputRichMessage and is a valid InputMessageContent
|
||||
InputRichMessageContent(
|
||||
InputRichMessageHTML("<b>Bold</b> rich message sent via inline query")
|
||||
),
|
||||
description = "InputRichMessageContent built from HTML"
|
||||
),
|
||||
InlineQueryResultArticle(
|
||||
InlineQueryId("rich_markdown"),
|
||||
"Rich message (Markdown)",
|
||||
InputRichMessageContent(
|
||||
InputRichMessageMarkdown("*Bold* rich message sent via inline query")
|
||||
),
|
||||
description = "InputRichMessageContent built from Markdown"
|
||||
)
|
||||
),
|
||||
cachedTime = 0
|
||||
)
|
||||
}
|
||||
|
||||
// onlyRichMessageContentMessages: filter a Flow<ContentMessage<*>> down to rich message content
|
||||
allUpdatesFlow
|
||||
.mapNotNull { it.baseSentMessageUpdateOrNull() ?.data ?.contentMessageOrNull() }
|
||||
.onlyRichMessageContentMessages()
|
||||
.subscribeLoggingDropExceptions(scope = this) { richMessageContentMessage ->
|
||||
println("[onlyRichMessageContentMessages] ${richMessageContentMessage.content.richMessage.blocks.size} blocks")
|
||||
}
|
||||
|
||||
setMyCommands(
|
||||
BotCommand("rich_html", "Send a rich message described with HTML"),
|
||||
BotCommand("rich_markdown", "Send a rich message described with Markdown"),
|
||||
BotCommand("rich_draft", "Stream a rich message draft, then finalize it"),
|
||||
BotCommand("rich_edit", "Send a rich message and edit it with new rich content"),
|
||||
BotCommand("wait_rich", "Wait for you to send a rich message"),
|
||||
)
|
||||
|
||||
allUpdatesFlow.subscribeLoggingDropExceptions(scope = this) {
|
||||
println(it)
|
||||
}
|
||||
}.second.join()
|
||||
}
|
||||
@@ -18,5 +18,5 @@ dependencies {
|
||||
implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
|
||||
|
||||
implementation "dev.inmo:tgbotapi:$telegram_bot_api_version"
|
||||
implementation 'io.ktor:ktor-client-logging-jvm:3.2.3'
|
||||
implementation 'io.ktor:ktor-client-logging-jvm:3.5.1'
|
||||
}
|
||||
|
||||
@@ -26,7 +26,7 @@ allprojects {
|
||||
}
|
||||
}
|
||||
|
||||
maven { url "https://nexus.inmo.dev/repository/maven-releases/" }
|
||||
// maven { url "https://proxy.nexus.inmo.dev/repository/maven-releases/" }
|
||||
mavenLocal()
|
||||
}
|
||||
}
|
||||
|
||||
@@ -6,8 +6,8 @@ kotlin.daemon.jvmargs=-Xmx3g -Xms500m
|
||||
|
||||
|
||||
kotlin_version=2.3.20
|
||||
telegram_bot_api_version=35.0.0
|
||||
telegram_bot_api_version=34.0.0
|
||||
micro_utils_version=0.29.1
|
||||
serialization_version=1.10.0
|
||||
ktor_version=3.4.1
|
||||
ktor_version=3.5.1
|
||||
compose_version=1.10.2
|
||||
|
||||
@@ -77,7 +77,3 @@ include ":GuestQueryBot"
|
||||
include ":LivePhotosBot"
|
||||
|
||||
include ":ChatManagementBot"
|
||||
|
||||
include ":RichMessagesBot"
|
||||
|
||||
include ":JoinRequestQueriesBot"
|
||||
|
||||
Reference in New Issue
Block a user