Messenger

Messenger lets you talk to your LobeHub agents through the official LobeHub bot on Telegram, Slack, and Discord. Link your LobeHub account once, choose which agent should answer, and you're done — every message you send to the bot is routed to your agent and replied to in the same conversation.

You manage everything from Settings → Messenger in LobeHub.

[!NOTE]

Messenger is for personal use of LobeHub agents from your favourite chat app. If you want to expose an agent to a public community with your own bot identity, set up a Channel on the agent instead.

Messenger vs. Channels

	Messenger	Channels
Bot identity	Official @LobeHub bot, hosted by LobeHub	Your own bot, you bring the token
Setup effort	Tap Connect, send /start, pick an agent	Create the bot on the platform, paste credentials, configure policies
Scope	Personal — only you talk to the bot	Public — anyone in the channel/server can talk to it
Active agent	One per platform link, switchable any time	One agent per channel binding
Configured at	Settings → Messenger	Agent → Channels

Supported Platforms

Platform	Setup model	Guide
Telegram	Global bot — any account can DM directly	Use LobeHub on Telegram
Slack	Per-workspace install + per-member link	Use LobeHub on Slack
Discord	Per-server install + per-member link	Use LobeHub on Discord

If a platform card does not appear at Settings → Messenger, it has not been enabled on your deployment yet — check back later or ask your administrator.

How It Works

1. You link your LobeHub account to a platform account through a short OAuth-style flow.
2. You pick a default agent during linking. Every message you send to the bot from that platform routes to this agent.
3. To switch agents, send /agents inside the bot or open Settings → Messenger in LobeHub.
4. Disconnect any time from the same screen — inbound messages stop until you /start again.

Each LobeHub account can hold one link per platform (Slack also tracks one link per workspace).

Switching the Active Agent

You can switch the agent that answers your messages at any time:

• From the bot — send /agents and pick a different agent.
• From LobeHub — open Settings → Messenger, select the platform, and use the agent picker on your link row.

Changes take effect immediately for the next message you send.

Disconnecting

There are two distinct disconnect actions per platform:

Action	Effect
Disconnect on a user row	Unlinks your LobeHub account from the platform account. Inbound messages stop until you /start again.
Disconnect on a workspace / server row	Removes the install audit entry. On Slack, this also freezes the workspace bot for everyone. On Discord, the bot stays in the server until a server admin kicks it.

You can re-link at any time by repeating the Connect flow.

Common Errors

These messages can appear during linking regardless of platform:

• "This link is already used" — The one-time confirm link can only be used once. Return to the bot and send /start again to issue a new link.
• "This account is already linked" — The platform account is bound to a different LobeHub account. Sign in to that account to manage it, or unlink it there before retrying.
• "Another <platform> account is already linked" — Your LobeHub account already has a link on this platform. Disconnect the existing link in Settings → Messenger before linking a new one.

For platform-specific issues, see the troubleshooting section on each platform's guide.