---
title: Messenger Overview
description: >-
  Connect your LobeHub account to the official LobeHub bot on Telegram, Slack,
  and Discord. Link once, pick an active agent, and chat with your assistants
  from the chat apps you already use — no bot setup required.
tags:
  - Messenger
  - Telegram
  - Slack
  - Discord
  - Integration
---

# 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](/docs/usage/channels/overview) 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](/docs/usage/messenger/telegram) |
| **Slack**    | Per-workspace install + per-member link  | [Use LobeHub on Slack](/docs/usage/messenger/slack)       |
| **Discord**  | Per-server install + per-member link     | [Use LobeHub on Discord](/docs/usage/messenger/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.

{/* TODO: screenshot — Settings → Messenger landing screen showing the three platform cards */}

## 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.
