Linking Telegram

Telegram is how the bot recognises you. Your Risbot account reaches your bots through this link - it is what lets this website show them, connect an exchange key to them, and let them trade.

Linking is also what turns trading on. An unlinked Telegram account is fully provisioned - it opens every panel and saves every setting - but the bot will not place an order for it until it is linked. See Plans for the message you get if you try before linking, and for the limits linking then makes you subject to.

Why linking is its own step

Your Risbot account and your Telegram account are separate things, and nothing about signing in tells the bot which Telegram account is yours.

The bot is the one place that knows: every message you send it carries your Telegram id, and nobody else can forge it. So linking works by sending the bot a one-time code, in a chat only you can send from - which is what makes the link trustworthy rather than merely claimed.

Linking

Open your Account page. Before anything is linked, the Telegram identity card is marked Action needed and shows:

No Telegram account linked - the bot will refuse every trade

Send the bot your one-time code and it learns which Telegram account is yours. One tap below, or do it by hand - either way it takes about twenty seconds.

A code is waiting there already - the card mints one as it opens, so there is nothing to press first. Open in Telegram carries it; underneath sits the same code as a command, for the case where the button does not open Telegram for you (a desktop client is the usual one):

Under an or manually divider are two numbered steps, for when the button does not open Telegram for you: Open this bot in Telegram, with the bot's handle, and Send it this code, with the command /start link_<code>. The code itself is masked - a few characters at each end and dots in between - so a page left open, or a screen being shared, is not handing it out. Three buttons sit beside it:

Under it is the part worth reading before you paste it anywhere:

Treat this code like a password. Whoever sends it links their Telegram account to this Risbot account - never share it, screenshot it into a group, or paste it anywhere but the bot. It works once and expires in 15 minutes. It does not hand over your exchange key, the ability to trade, or your funds. But there is no confirmation step and no way to un-redeem: you would have to unlink it and link again from the right account.

Opening the link, or sending the command, sends /start link_<code> to the bot. It acknowledges straight away, before it has looked anything up:

The bot reads your real Telegram id off that message, matches the code, and replaces that acknowledgement with the result:

The account page updates by itself a moment later, as long as it is still open - there is nothing to press. If it does not (the tab lost its connection, say), press Check now. It tells you what it found either way: the link if the bot has it, or No linked account found yet if the code has not reached it.

Once it is linked the card is marked Linked and shows the account it now answers to - your @handle, with the date it was linked and your Telegram id under it, or the id alone if that account has no handle. Unlink sits beside that line.

Changing your @handle in Telegram does not undo the link - the link is your Telegram id, which never changes. The card shows the new handle once you next message the bot.

The same account, with the same Unlink, is also under Connections in the sidebar. The dialog is the same one on both screens.

A link made before Risbot started recording the date shows the id on its own. Nothing is missing; there is simply no date on file to state.

If the code does not work

The bot tells you which of these happened, in the chat where you are standing:

The last one is the only case that needs another step: sign in to the other Risbot account with that Telegram account, unlink it there (see Unlinking below), and try your code again.

Changing which Telegram account is linked

Unlink the account that is there, then link the new one. The card offers no way to mint a code while something is still linked, so the order is always the same: Unlink, then redeem the code the card shows as soon as it is unlinked, from the account you want.

Switching costs you every exchange key. Unlinking revokes the exchange key on every bot you own (see Unlinking below), and linking the new account will not bring them back - an exchange never shows a secret twice. Plan on creating a new API key at your exchange and connecting it again after the switch.

Nothing else on the bot side moves with it. The bot account, its settings, its guardrails and its trade history all stay exactly where they are, under the Telegram account that owns them.

Your plan and account credit are not affected either way: they belong to your website account, so the newly linked Telegram account trades on the plan you already have.

If your code expires while you are still on the page, the refresh button beside the code mints a fresh one and kills the old.

Unlinking

Unlink removes the link without linking a new one, and is always available - unlinking never touches how you sign in, so there is no state where it could lock you out of your account.

It revokes the exchange key on every bot you own first. This is the one thing unlinking destroys, and it is deliberate: the bot server finds your bots through the link, so once the link is gone nothing - not this website, not the bot, not support - can reach those keys to revoke them. A key left behind that way would sit on the exchange with nobody able to take it off.

So the order is always revoke, then unlink. If the keys cannot be revoked, nothing is unlinked at all and the page says so:

Your exchange keys could not be revoked, so nothing was unlinked. Reload the page and try again.

What it asks before it does it

The confirmation names every bot whose key it is about to revoke, so you can see what you are giving up:

Unlinking revokes the exchange key on every bot below.

Those bots stop placing orders until a key is connected again. Everything else stays - settings, guardrails, history, and any position already open keeps the stop and target it was given on the exchange.

An exchange never shows a secret twice, so linking again will not bring these back. Reconnecting means creating a new key at the exchange.

With one bot connected it reads in the singular - the bot below, that bot stops placing orders. The confirm button counts them - Unlink and revoke 2 keys - and when it is done the page reports what actually happened:

Telegram account unlinked, and 2 exchange keys revoked.

With no key connected there is nothing to revoke, the button reads Unlink account, and the dialog says only this:

This website stops recognising that Telegram account as yours. The page can no longer show your bot account.

The bot itself is untouched - it answers to your Telegram account, not to this page. Your settings, guardrails and open positions all stay exactly as they are, and you can link the same account again at any time.

What survives it

Everything except the keys. Your bot account, its settings, its guardrails and its whole trade history stay exactly where they are, and a position already open on the exchange keeps the stop and take-profit it was given when it was placed. What stops is placing new orders, and the panels that act on a position from Telegram, until a key is connected again.

The button only appears once something is linked. If you unlink from one tab while another still shows the old state, pressing Unlink there instead reports:

No Telegram account is linked.

Next

See Deleting Your Account for what happens to your Telegram bot data if you delete your Risbot account instead of just unlinking it.