Notifications

Telegram Bot Setup

How to create a Telegram bot and connect it to TradingForge for real-time trade and engine alerts.

TradingForge can send real-time notifications directly to your Telegram account via a personal Telegram bot. This is the recommended notification method — messages arrive instantly and are easy to read on any device. Setup takes about five minutes.

Your Telegram bot token is sensitive. Store it securely and do not share it. Anyone with your bot token can send messages through your bot.

Step 1 — Create a Telegram Bot via BotFather

BotFather is Telegram's official bot for creating and managing bots. All new Telegram bots must be registered through BotFather.

Open Telegram and search for @BotFather

In the Telegram search bar, type @BotFather. Select the verified account (it has a blue checkmark). Start a chat with BotFather by pressing the Start button.

Send /newbot to create a new bot

Type and send /newbot. BotFather will ask you to choose a name and a username for your bot.

Choose a display name

Enter a friendly name for your bot, for example: My TradingForge Bot. This is just a label and can be anything you like.

Choose a username ending in _bot

Enter a unique username that ends in _bot, for example: tradingforge_mybot. If the username is already taken, try adding your initials or a number. Usernames are permanent and unique across all of Telegram.

Copy your bot token

BotFather will reply with a message containing your bot token in the format: 123456789:ABCdef.... Copy this token — you will paste it into TradingForge shortly. Keep this value private.

Start a chat with your new bot

BotFather provides a direct link to your new bot in the confirmation message. Click it, then press Start. This step is required — Telegram will not deliver messages to users who have not started the bot first.

Step 2 — Get Your Telegram Chat ID

TradingForge also needs your Telegram Chat ID so it knows which account to send messages to. The easiest way to get this is with the @userinfobot helper.

Search for @userinfobot in Telegram

In the Telegram search bar, type @userinfobot. Start a chat with it.

Receive your user ID

@userinfobot will immediately reply with your Telegram user information, including your numeric user ID. This number is your Chat ID. Copy it — it will look something like 987654321.

Step 3 — Connect to TradingForge

Open TradingForge Settings → Notifications → Telegram

In TradingForge, navigate to Settings in the top navigation bar, then select the Notifications tab, then Telegram.

Paste your Bot Token

Enter the bot token you copied from BotFather into the Bot Token field. Make sure there are no leading or trailing spaces.

Paste your Chat ID

Enter your numeric Chat ID obtained from @userinfobot into the Chat ID field.

Save and send a test message

Click Save, then click Send Test Message. Within a few seconds you should receive a test notification in your Telegram chat with your bot. If you receive it, setup is complete.

Create a dedicated private Telegram channel for your bot notifications to keep your personal chat clean. Add your bot as an admin of the channel, then use the channel's Chat ID instead of your personal user ID.

Group Notifications

If you want notifications delivered to a Telegram group (for example, to share alerts with a trading partner), follow these additional steps:

Add your bot to the group

Open the group, tap the group name at the top, then select Add Members and search for your bot's username. Add it.

Make the bot an admin

Still in the group settings, find your bot in the member list and promote it to administrator. This is required for the bot to send messages in groups.

Get the group Chat ID

Add @getidsbot to your group temporarily — it will display the group's Chat ID in the format -100xxxxxxxxxx (note the negative number for groups). Copy this ID, then remove @getidsbot from the group.

Enter the group Chat ID in TradingForge

Paste the negative group Chat ID into the Chat ID field in TradingForge's Telegram settings and save. Send a test message to confirm delivery to the group.

Troubleshooting

›Test message not received: Make sure you started a chat with your bot by pressing the Start button. The bot cannot initiate conversations — you must start it first.
›Invalid bot token error: Verify the token was copied in full from BotFather with no extra spaces. The token contains a colon separating the numeric ID from the alphanumeric secret.
›Wrong Chat ID: Double-check your Chat ID from @userinfobot. Group Chat IDs are negative numbers (e.g. -1001234567890).
›Bot was blocked: If you blocked your bot at any point, unblock it and send /start again before testing.

Advanced Settings

Email Notifications