Docs›Telegram bot›Link your account
Telegram bot

Link your account

The Nextbridge bot is bound to a single Telegram chat per account using a USER-scoped API key. No QR codes, no OAuth — paste the key once and you’re done.

~30 secondsRevocable from /settings/security
1

Generate an API key

Open Settings → Security → API keys and create a USER-scoped key. Name it something obvious likeTelegram. The plaintext is shown once — copy it now.

2

Open the bot in Telegram

Search Telegram for the official Nextbridge bot and open the chat. The bot username is published in the bot overview once it ships. Hit Start if Telegram prompts you to — that just opens the chat, it does not link your account yet.

3

Send /start with your key

Paste your API key after the /start command:

textin the Telegram chat
1/start nbx_user_REPLACE_WITH_YOUR_KEY

The bot validates the key against its USER scope, then creates a one-to-one binding between this chat and your Nextbridge user. You should see ✓ Linked to your-email@…come back within a second. Sending /start with a new key from the same chat replaces the binding — there is exactly one linked chat per account.

Telegram messages are not end-to-end encrypted by default. After linking, delete the message that contained the key from both sides of the chat. The bot does not need it again — it knows you by chat id from this point on.
4

Unlinking

Two ways to revoke access:

  • From Telegram, send /unlink. The binding is deleted; the API key itself is left intact for other clients.
  • From the web, revoke the API key in Settings → Security. All clients using that key — Telegram, Claude Desktop, scripts — stop working immediately.