build-inline-keyboard

name	build-inline-keyboard
description	Builds inline keyboards for messages using the telegram-bot DSL. Use when adding buttons under messages, creating callback buttons, URL buttons, or inline keyboard markup for user interaction.

Build Inline Keyboard

Quick Start

Use inlineKeyboardMarkup { } or inlineKeyboardMarkup(block) to create inline keyboards. Attach via markup() or inlineKeyboardMarkup { } on send actions.

message("Choose an option:")
    .inlineKeyboardMarkup {
        "Option A" callback "opt_a"
        "Option B" callback "opt_b"
        newLine()
        "Open link" url "https://example.com"
    }
    .send(user, bot)

Button Types

Type	Syntax	Use case
Callback	"Label" callback "data" or callbackData("Label") { "data" }	Button press sends callback to bot (1-64 bytes)
URL	"Label" url "https://..."	Opens URL when pressed
Web App	"Label" webAppInfo "https://..."	Opens Web App
Switch inline	"Label" switchInlineQuery "query"	Opens inline mode in another chat
Switch inline (current)	"Label" switchInlineQueryCurrentChat "query"	Inserts bot + query in current chat
Pay	"Pay" pay()	Payment button
Copy text	"Label" copyText "text"	Copies text to clipboard

Rows

• Each url(), callbackData(), etc. adds a button to the current row
• Use newLine() or br() to start a new row

inlineKeyboardMarkup {
    "Yes" callback "yes"
    "No" callback "no"
    newLine()
    "Cancel" callback "cancel"
}

Attaching to Messages

Actions with MarkupFeature (e.g. message, sendPhoto, editMessageText) support:

• inlineKeyboardMarkup { ... } — builder block
• markup(inlineKeyboardMarkup { ... }) — explicit markup

Callback Data Limits

• 1-64 bytes for callbackData
• Use prefixes for routing: "action:id", "vote:123"

Reference

• InlineKeyboardMarkupBuilder.kt
• MarkupFeature.kt