> ## Documentation Index
> Fetch the complete documentation index at: https://docs.relayhub.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Messaging Hub

> Bring RelayHub into Slack, Microsoft Teams, Discord, and Google Chat

The **Messaging Hub** connects RelayHub to the chat platforms your team already uses. Once connected, teammates can @mention the RelayHub bot in a channel, get streamed AI answers in a thread, and use your company's knowledge without opening RelayHub.

Open it from **Messaging Hub** in the sidebar (administrators only).

## Supported Platforms

<Columns cols={2}>
  <Card title="Slack" icon="slack">
    Mention the bot in any channel; replies stream into the thread.
  </Card>

  <Card title="Microsoft Teams" icon="microsoft">
    A Teams bot your organization sideloads and chats with in channels.
  </Card>

  <Card title="Discord" icon="discord">
    Connects over Discord's gateway; no public URL required.
  </Card>

  <Card title="Google Chat" icon="google">
    Responds to mentions in Google Chat spaces.
  </Card>
</Columns>

## Connecting a Platform

<Steps>
  <Step title="Click Connect a Platform">
    Choose your platform. A step-by-step setup guide expands with exactly what to create on the platform side and which values to copy.
  </Step>

  <Step title="Enter credentials">
    Each platform asks for its own identifiers (bot token, app ID, signing secret, and similar). RelayHub encrypts everything you enter.
  </Step>

  <Step title="Connect">
    Click **Connect Platform**. The installation card appears showing linked users, mapped channels, and the install date. Use **Disconnect** to remove a platform later.
  </Step>
</Steps>

## Linking Users

Messages from a platform need to map to RelayHub accounts so permissions and context apply correctly. The **User Linking** tab manages this:

* **Auto-Link All** matches platform users to RelayHub users by email address in one click
* **Link** manually pairs a platform user with a RelayHub account via search
* **Unlink** removes a pairing

A platform user who is not linked yet gets a polite reply telling them to ask their admin to link their account.

## Mapping Channels

The **Channel Mapping** tab maps platform channels to RelayHub workspaces. When a channel is mapped, the bot answers using that workspace's files and knowledge, so the #sales channel can draw on the Sales workspace.

* **Sync Channels** discovers channels the bot has joined
* **Map** assigns a channel to a workspace; **Unmap** removes it
* Channels the bot first sees via a mention are added automatically

## Using the Bot

Once set up, anyone linked can:

1. **@mention the bot** in a channel; the answer streams into a thread
2. **Reply in the thread** to continue, no re-mention needed
3. Use the `/rh` command to control the thread:

| Command            | Effect                                                                             |
| ------------------ | ---------------------------------------------------------------------------------- |
| `/rh help`         | List available commands                                                            |
| `/rh model <name>` | Switch the AI model for this thread (for example `gpt-5.4` or `claude-sonnet-4-6`) |
| `/rh company`      | Toggle Company Data mode (answers only from your knowledge base)                   |
| `/rh web`          | Toggle web search                                                                  |
| `/rh status`       | Show the current thread settings                                                   |