Keyboards & Buttons

This section covers how to create and send interactive keyboards using the native Bot API classes available in the BLP environment.

Inline Keyboards

Inline keyboards appear attached to the message itself and can trigger callbacks or open URLs.

Sending an Inline Keyboard

To send an inline keyboard, you need to construct a two-dimensional array of InlineKeyboardButton objects and wrap it in an InlineKeyboardMarkup.

BLP Example

keyboard = [
    [
        InlineKeyboardButton(text="Google", url="https://google.com"),
        InlineKeyboardButton(text="Click Me!", callback_data="btn_clicked")
    ],
    [
        InlineKeyboardButton(text="Open Web App", web_app="https://bots.lt")
    ]
]

Bot.sendMessage(
    chat_id=u,
    text="Here is an inline keyboard:",
    reply_markup=InlineKeyboardMarkup(inline_keyboard=keyboard)
)

Answering Callback Queries (answerCallbackQuery)

When a user clicks an inline button containing callback_data, your bot will receive a callback_query update. You must answer this query using answerCallbackQuery to stop the loading icon on the user’s button.

BLP Example

if call.data == "btn_clicked":
    Bot.answerCallbackQuery(
        callback_query_id=call.id,
        text="You clicked the button!",
        show_alert=True
    )

Reply Keyboards (Custom Keyboards)

Reply keyboards replace the user’s default keyboard with custom buttons. These buttons send plain text messages when tapped.

Sending a Reply Keyboard

Use KeyboardButton and ReplyKeyboardMarkup.

BLP Example

keyboard = [
    [KeyboardButton(text="Button 1"), KeyboardButton(text="Button 2")],
    [KeyboardButton(text="Share Contact", request_contact=True)],
    [KeyboardButton(text="Share Location", request_location=True)]
]

Bot.sendMessage(
    chat_id=u,
    text="Please choose an option:",
    reply_markup=ReplyKeyboardMarkup(
        keyboard=keyboard,
        resize_keyboard=True, # Makes the keyboard smaller
        one_time_keyboard=True # Hides after one use
    )
)

Removing a Reply Keyboard

To remove a custom reply keyboard and restore the user’s default typing keyboard, use ReplyKeyboardRemove.

BLP Example

Bot.sendMessage(
    chat_id=u,
    text="Removing keyboard...",
    reply_markup=ReplyKeyboardRemove(remove_keyboard=True)
)

Getting Started

Language Reference

Telegram API Methods

Core Libraries (Libs)

Inline Keyboards

Sending an Inline Keyboard

Answering Callback Queries (answerCallbackQuery)

Reply Keyboards (Custom Keyboards)

Sending a Reply Keyboard

Removing a Reply Keyboard

​Inline Keyboards

​Sending an Inline Keyboard

​Answering Callback Queries (answerCallbackQuery)

​Reply Keyboards (Custom Keyboards)

​Sending a Reply Keyboard

​Removing a Reply Keyboard

Inline Keyboards

Sending an Inline Keyboard

Answering Callback Queries (answerCallbackQuery)

Reply Keyboards (Custom Keyboards)

Sending a Reply Keyboard

Removing a Reply Keyboard