Bot Menu Setup

Bot Menus define the navigation and user experience of your Telegram bot. They allow users to interact with your bot using buttons instead of commands, making it easy to onboard new traders, verify accounts, share resources, and provide support.

IBWatch allows you to either copy a set of default bot menus to get started quickly or create your own custom menus from scratch.

Prerequisites

Before configuring Bot Menus, ensure that you have completed the following:

• Registered your broker account on IBWatch.

• Created and linked your Telegram bot.

• Logged into your IBWatch dashboard.

Copying the Default Bot Menus

The quickest way to set up your bot is by copying the default menus provided by IBWatch. These menus give you a ready-made navigation structure that you can customize later.

Step 1: Open the Bot Menus Page

From the left sidebar of your IBWatch dashboard, click Bot Menus.

📷 Screenshot: Bot Menus page in the dashboard.

Step 2: Copy the Default Menus

Click the Copy Default Menus button.

A dialog window will appear asking you to choose the Telegram bot you want to copy the menus to.

📷 Screenshot: Copy Default Menus dialog.

Step 3: Select Your Telegram Bot

Choose the Telegram bot from the dropdown list.

If you manage multiple bots, make sure you select the correct one.

Step 4: Copy the Menus

Click Copy Defaults.

IBWatch will automatically create a complete set of default menus for your selected Telegram bot.

Step 5: Review the Generated Menus

Once the process is complete, you'll see a populated list of bot menus.

Each row represents a menu that can be displayed inside your Telegram bot.

Menu Key

The Menu Key is a unique identifier for each menu.

It is used internally when linking one menu to another and must be unique across your bot.

Examples

• main_menu

• verify_account

• join_vip

• contact_support

Note: Menu Keys are not visible to your users.

Title

The Title is the name displayed to users when they open a menu.

Examples include:

• Main Menu

• Verify Account

• Contact Support

• Deposit Funds

• Join VIP

Use short and descriptive titles so users immediately understand the purpose of each menu.

Sort Order

The Sort Order controls the position of the menu.

Menus with lower values are displayed before menus with higher values.

Keeping menus organized improves the user experience and makes navigation more intuitive.

Creating a New Bot Menu

In addition to the default menus, you can create as many custom menus as you need.

Click the New Bot Menu button to open the menu creation screen.

The page consists of two sections:

• Menu Screen

• Buttons

Both sections work together to define how the menu behaves.

Configuring the Menu Screen

The Menu Screen contains the main information for your menu.

Telegram Bot

Select the Telegram bot that this menu should belong to.

If you have multiple bots, ensure you select the correct one before continuing.

Menu Key

Enter a unique Menu Key.

This key identifies the menu internally and is used when other buttons need to open it.

Examples include:

• welcome

• register_account

• deposit_funds

• vip_access

• support

Important: Every Menu Key must be unique.

Title

Enter the title of the menu.

This title is displayed to users inside Telegram.

Examples:

• Register Account

• Deposit Funds

• Trading Course

• Contact Support

• Frequently Asked Questions

Choose titles that are short, descriptive, and easy to understand.

Message Text

The Message Text is the content displayed when a user opens the menu.

This can include:

• Welcome messages

• Registration instructions

• Trading information

• Broker links

• Telegram channel links

• Website URLs

• Support information

• Promotional messages

Example:

Welcome to our trading community!

Please choose one of the options below to continue.

Keep your messages concise and easy to read.

Sort Order

Specify where this menu should appear relative to your other menus.

Lower numbers appear before higher numbers.

A consistent ordering makes your bot easier to navigate.

Configuring Menu Buttons

Buttons allow users to navigate through your bot or perform specific actions.

To create a button, click Add to Buttons.

Each button includes the following fields.

Label

The Label is the text displayed on the button.

Examples include:

• Register Account

• Verify Existing Account

• Join VIP

• Contact Support

• Visit Website

• Back

• Main Menu

Use labels that clearly describe the action that will occur when the button is pressed.

Type

The Type determines what happens when a user taps the button.

IBWatch currently supports the following button types.

Open Menu

Opens another menu within your Telegram bot.

Use this option to build a structured navigation flow.

Example:

Main Menu
    ↓
Register Account
    ↓
Deposit Funds
    ↓
Join VIP

Selecting Open Menu requires you to choose a target menu.

Run Action

Executes a built-in IBWatch action.

Currently, the available action is:

Verify Existing Exness Account

When selected, users will be prompted to enter:

• Email Address

• Full Name

• Phone Number

IBWatch will verify whether the user is registered under your Exness partnership, helping automate your onboarding process.

Open URL

Opens an external website or web page.

Common uses include:

• Broker registration pages

• Company website

• Payment pages

• TradingView

• YouTube tutorials

• WhatsApp support

• Telegram channels

• Google Forms

Simply enter the destination URL.

Go Back

Returns the user to the previous menu they visited.

This provides a smoother navigation experience without forcing users back to the beginning.

Note: If there is no previous menu, this button will have no effect.

Return to Main Menu

Immediately returns the user to the bot's main menu from anywhere within the bot.

This is recommended for most submenu pages to make navigation quick and intuitive.

Target Menu

Depending on the selected button type, you may need to specify a target.

Sort Order

Each button has its own Sort Order.

Buttons with lower values appear before those with higher values.

Example:

Organize your buttons in the order that best guides users through your onboarding process.

Saving the Menu

After completing the Menu Screen and configuring all required buttons:

1. Review the information you've entered.

2. Confirm that the Menu Key is unique.

3. Verify that all buttons point to the correct menus, actions, or URLs.

4. Click Create.

Your new menu will immediately become available within your selected Telegram bot.

Best Practices

Following these recommendations will help you build a professional and user-friendly bot experience.

• Start by copying the default menus before making customizations.

• Use short, descriptive titles and button labels.

• Keep messages concise and easy to read.

• Break large amounts of information into multiple menus instead of one long message.

• Include a Return to Main Menu button on most submenus.

• Use logical sort orders to create a natural navigation flow.

• Test every menu and button after making changes to ensure they behave as expected.

• Regularly review your menus to keep links, messages, and resources up to date.

Next Steps

Once your Bot Menus have been configured, you're ready to begin building a complete onboarding experience for your traders. Continue customizing your menus as your business grows by adding new pages, actions, and navigation paths that guide users from registration through account verification and beyond.