Advanced Methods

This section covers advanced interaction methods and configuration options.

Inline Mode

Inline mode allows users to interact with your bot from any chat by typing @your_bot_username followed by a query.

answerInlineQuery

Use this method to send answers to an inline query. No more than 50 results per query are allowed.

BLP Example

results = [
    {
        "type": "article",
        "id": "1",
        "title": "Welcome to Bots.LT",
        "input_message_content": {
            "message_text": "Bots.LT is the best platform for Bot creation!"
        }
    }
]

Bot.answerInlineQuery(
    inline_query_id=raw_message.get("id"),
    results=jsondumps(results),
    cache_time=300
)

Bot Configuration

setMyCommands

Use this method to change the list of the bot’s commands. These commands appear in the Telegram menu button.

BLP Example

commands = [
    {"command": "start", "description": "Start the bot"},
    {"command": "help", "description": "Get help"},
    {"command": "settings", "description": "Configure settings"}
]

Bot.setMyCommands(commands=jsondumps(commands))

deleteMyCommands

Use this method to delete the list of the bot’s commands for the given scope and user language.

BLP Example

Bot.deleteMyCommands()

getMyCommands

Use this method to get the current list of the bot’s commands.

BLP Example

result = Bot.getMyCommands()
Bot.sendMessage(u, f"Current commands: {result.result}")

setChatMenuButton

Use this method to change the bot’s menu button in a private chat, or the default menu button.

BLP Example

menu_button = {
    "type": "web_app",
    "text": "Open App",
    "web_app": {"url": "https://bots.lt"}
}

Bot.setChatMenuButton(
    chat_id=u,
    menu_button=jsondumps(menu_button)
)

Bot.Transfer

Use this method to programmatically transfer the ownership of the bot to another user via their registered email or username on the Bots.LT platform. By default, it transfers the current bot, but you can also transfer another bot you own by passing bot_id.

BLP Example

# Transfer current bot using username
Bot.Transfer(username="new_owner_username")

# Transfer current bot using email
Bot.Transfer(email="owner@example.com")

# Transfer a specific bot you own
Bot.Transfer(bot_id="your_other_bot_id", email="owner@example.com")

Bot.Clone

Use this method to programmatically create an exact copy of the bot, including all its commands and code. If you provide a bot_token, the new bot will be attached to that token immediately.

BLP Example

# Clone current bot to a new BotFather token
Bot.Clone(bot_token="YOUR_NEW_BOT_TOKEN")

# Clone current bot and start it automatically
Bot.Clone(bot_token="YOUR_NEW_BOT_TOKEN", run_now=True)

# Clone a specific bot you own
Bot.Clone(bot_id="your_other_bot_id", bot_token="YOUR_NEW_BOT_TOKEN")

Internal BLP Engine Methods

Next Command Handling

You can explicitly tell the BLP engine which command to execute on the user’s next message using Bot.handleNextCommand().

BLP Example

# Command 1 (/ask_name)
Bot.sendMessage(u, "What is your name?")
Bot.handleNextCommand("/save_name", {"temp": "data"})

# Command 2 (/save_name)
name = message.text
Bot.sendMessage(u, f"Saved! Hello {name}.")

Triggering Other Commands

You can programmatically trigger another command’s code from within your current command using Bot.runCommand().

BLP Example

# Triggers the code inside the /help command
Bot.runCommand("/help")

Getting Started

Language Reference

Telegram API Methods

Core Libraries (Libs)

Inline Mode

answerInlineQuery

Bot Configuration

setMyCommands

deleteMyCommands

getMyCommands

setChatMenuButton

Bot.Transfer

Bot.Clone

Internal BLP Engine Methods

Next Command Handling

Triggering Other Commands

​Inline Mode

​answerInlineQuery

​Bot Configuration

​setMyCommands

​deleteMyCommands

​getMyCommands

​setChatMenuButton

​Bot.Transfer

​Bot.Clone

​Internal BLP Engine Methods

​Next Command Handling

​Triggering Other Commands

Inline Mode

answerInlineQuery

Bot Configuration

setMyCommands

deleteMyCommands

getMyCommands

setChatMenuButton

Bot.Transfer

Bot.Clone

Internal BLP Engine Methods

Next Command Handling

Triggering Other Commands