Command

The command method in GramIO allows you to create handlers for specific bot commands. Commands are specific words or phrases that usually begin with a / and are used to trigger actions or responses from the bot.

Telegram apps will:

• Highlight commands in messages. When the user taps a highlighted command, that command is immediately sent again.
• Suggest a list of supported commands with descriptions when the user enters a / (for this to work, you need to have provided a list of commands to @BotFather or via the appropriate API method). Selecting a command from the list immediately sends it.
• Show a menu button containing all or some of a bot’s commands (which you set via @BotFather).

Commands must always start with the / symbol and contain up to 32 characters. They can use Latin letters, numbers and underscores, though simple lowercase text is recommended for a cleaner look.

IMPORTANT

The command can also be triggered using the full command with the bot's username, such as /start@name_bot.

Basic Usage

Registering a Simple Command

You can use the command method to make your bot respond to specific commands. Here’s a basic example:

bot.command("start", (context) => {
    return context.send(`Hi!`);
});

IMPORTANT

You don't need to include a / when specifying the command name. If you turn it on, you will get an error.

In this example, the bot listens for the /start command. When the command is received, the bot responds with a simple "Hi!" message.

Example with Command Arguments

Here’s an example that demonstrates how to use arguments with commands:

bot.command("start", async (context) => {
    return context.send(
        `You entered the command /start with arguments: ${context.args}`
    );
});

In this scenario, if a user sends /start arg1 arg2, the bot will respond with You entered the command /start with arguments: arg1 arg2.

How command Works

1. Command Recognition: The bot checks the message for a command (e.g., /start). Commands are typically indicated by the bot_command entity in Telegram messages.

2. Command Matching: The bot compares the detected command against the command you specified in the command method.

3. Handling Commands with Bot Username: The command is also recognized if it includes the bot's username, such as /start@name_bot.

4. Command Arguments: If there are additional arguments following the command (e.g., /start arg1 arg2), these are passed to context.args for further processing.