ContextQMD
Back to Lobehub

Use LobeHub on Telegram

docs/usage/messenger/telegram.mdx

2.2.02.4 KB
Original Source

Use LobeHub on Telegram

Telegram is the simplest Messenger platform: there is one global LobeHub bot, and any Telegram account can DM it. You only need to link your LobeHub account once.

Prerequisites

  • A LobeHub account
  • A Telegram account on any device

Step 1: Open Settings → Messenger

In LobeHub, open Settings → Messenger and click the Telegram card.

Step 2: Click Connect

On the Telegram detail page, click Connect in the top-right corner. A modal opens with two ways to reach the bot.

Step 3: Open the bot in Telegram

Either tap Open in Telegram in the modal, or scan the QR code with your phone. Telegram opens the official LobeHub bot.

Step 4: Send /start

Inside the bot, send the /start command. The bot replies with a one-time confirmation link.

Tap the link in the bot's reply. You'll be taken back to LobeHub. Sign in if asked, then choose a default agent — every message you DM the bot from now on will route to this agent.

After confirming, the Telegram detail page shows your link as a "user" row with the active agent.

Switching the Active Agent

Two equivalent ways:

  • In Telegram — send /agents to the bot and pick a different agent.
  • In LobeHub — open Settings → Messenger → Telegram and use the agent picker on your link row.

The change takes effect on the next message you send.

Disconnecting

In Settings → Messenger → Telegram, click Disconnect on the link row. The bot will stop accepting your messages until you re-link by sending /start again.

Disconnecting from LobeHub does not remove the bot from your Telegram chat list — you can manually delete the chat in Telegram if you no longer want to see it.

Troubleshooting

  • The bot does not reply to /start — Check that the platform card actually exists in Settings → Messenger. If your deployment hasn't enabled Telegram yet, the bot won't respond.
  • "This link is already used" — One-time links can only be used once. Send /start again to get a new link.
  • "This account is already linked" — Your Telegram account is bound to a different LobeHub account. Sign in to that LobeHub account to manage the link, or unlink there first.
  • "Another Telegram account is already linked" — Your LobeHub account already has a Telegram link. Disconnect it in Settings → Messenger → Telegram before linking a new Telegram account.