Skip to main content

Setup the Telegram Bot

TL;DR

Four steps: (1) copy your Access Key from TVH, (2) open @TvHub_Bot in Telegram, (3) send /start and paste your Access Key, (4) configure at least one Trade Setting. Total time: about five minutes.

You only link the bot to your TVH account once. After that, every device where you are signed into Telegram receives notifications and can issue commands.

Enabling happens in Telegram, not on the website

There is no on/off switch on the settings page. The Telegram Bot card there only shows the current status (Enabled / Disabled) and the how-to steps. You actually enable the bot by sending /start and your Access Key inside Telegram (Steps 2-3 below); to disable it you send /stop.

Step 1 — Copy your Access Key​

  1. Sign in at tv-hub.org.
  2. Open Account → Settings.
  3. Find the Access Key card and click the copy button. This is the string the bot uses to verify ownership — treat it like a password.

The same Access Key links the Chrome Extension and the Telegram bot to your account. See Account & API Keys for the full overview.

Step 2 — Open the bot in Telegram​

Open Telegram (mobile or desktop) and search for the bot username exactly:

@TvHub_Bot

Tap the result, then Start at the bottom of the chat. Telegram will send the /start command automatically the first time.

Step 3 — Authorize with /start + Access Key​

After /start, the bot will prompt:

Please send your Access-Key to enable the bot.

Paste the Access Key you copied in Step 1. Once accepted, the Telegram Bot card on the settings page flips to Enabled, and the bot replies with a confirmation:

Telegram bot successfully enabled!

If you instead see Access-Token invalid., re-copy from the TVH settings page — Telegram clients sometimes insert a trailing space when pasting from the clipboard. Strip whitespace and resend.

Step 4 — Configure at least one Trade Setting​

The bot will not execute any forwarded signals until you have configured at least one Trade Setting. This tells it which API key to use, how to size trades, and which leverage and margin mode to apply.

Go to Account → Telegram Trading, click Add Trade Setting, and complete the form. Full field-by-field guide in Trade Settings & Filters.

If you only want trade notifications and command access (no auto-execution from forwarded signals), you can skip this step — notifications and /trade commands work as soon as the account is linked.

What the bot does after activation​

Once you complete Steps 1-3, the bot becomes active immediately:

  • Trade logs. Every trade fired by any TVH integration (TradingView webhook, Chrome Extension, copy-trading broadcast) sends a confirmation message to your chat.
  • Signal listening. When you forward a message from a supported channel, the bot parses and executes it using your configured Trade Settings.
  • Command response. /trade opens the position-management menu.

Verify it's working​

Quick smoke test:

  1. Send /trade to the bot — it should respond with the position-management menu (Close Position, Set to break-even, Cancel DCA, Cancel all orders).
  2. Fire a trade from your usual entry point (TradingView alert, Chrome Extension button, or a manually-built TradeCommand). Within a few seconds, the bot should send a trade-log message confirming the order.
  3. If you configured a Trade Setting, forward any message from one of the public signal channels — the bot replies with <SYMBOL> trade detected. Executing signal.. once the message parses and a matching Trade Setting is found.

Common setup issues​

SymptomFix
Access-Token invalid.Re-copy the key from TVH settings. Strip leading/trailing whitespace before pasting. The Access Key is a UUID with hyphens — no spaces, no quotes.
Bot does not reply to /startSend /start again. If still silent, check that you are messaging the correct bot username (@TvHub_Bot, not a similarly-named impostor).
Trade settings for Telegram are not found. You must configure your settings on the website to use the trade bot.You linked the account but skipped Step 4. Add at least one Trade Setting.
Multiple TVH accounts on one TelegramOnly one TVH account can be linked per Telegram chat. To switch accounts, send /stop to unlink, then send /start again and paste the new Access Key.
Bot stopped responding to signals or commandsThe link may have been disabled (a previous /stop). Send /start in the chat and re-paste your Access Key to re-enable it.

Next​

Configure your first Trade Setting → Trade Settings & Filters.