--- title: "Rocket Chat Telegram App Guide" slug: "telegram-app" description: "Set up Telegram app in Rocket Chat. Enable secure messaging, expand omnichannel support, and improve communication workflows." tags: ["Enterprise"] updated: 2026-04-28T16:38:25Z published: 2026-04-28T22:07:27Z canonical: "docs.rocket.chat/telegram-app" excludeFromExternalSearch: true --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.rocket.chat/llms.txt > Use this file to discover all available pages before exploring further. # Telegram App Integration ![](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Enterprise.svg) With the Telegram app, you can send and receive Omnichannel messages in Rocket.Chat using a [Telegram bot](https://core.telegram.org/bots). This allows your workspace to manage Telegram conversations alongside other support channels, with access to full chat history and bot-based replies. **Key features of the Rocket.Chat Telegram app** - **Centralized inbox:** Manage Telegram conversations from a single inbox with unlimited chat history. - **Multimedia support:** Chat with customers using text, images, videos, and more. - **Quick Replies:** Automate responses with bot-powered quick replies. > [!NOTE] > The Telegram app is used specifically for Omnichannel conversations. To use the Telegram bot inside [channels](/v1/docs/channels) or other [rooms](/v1/docs/rooms), see the [Simple Telegram Bot](https://docs.rocket.chat/v1/docs/simple-telegram-bot) integration. --- ## Install Telegram app To install the **Telegram** app in your workspace: 1. Go to **Marketplace** ![](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot 2025-12-23 130453.png) > **Explore**. 2. Search for the **Telegram** app. 3. Click **Install** and approve the required permissions. > [!WARNING] > Before the app can receive messages, you must [enable the Omnichannel feature](https://docs.rocket.chat/v1/docs/omnichannel-admins-guide) and assign [agents](/v1/docs/omnichannel-users#omnichannel-agents) or [managers](/v1/docs/omnichannel-users#omnichannel-managers) to handle Telegram messages. ## Generate your Telegram bot token Before connecting Telegram to your workspace, you need to create a Telegram bot and generate an API token. This token is what allows Rocket.Chat to authenticate and communicate with Telegram on your behalf. To generate a Telegram bot token: 1. Install the Telegram app on your phone or computer. 2. In the search bar, find and select **BotFather**. It's an official, verified Telegram bot (look for the blue checkmark). 3. Tap **Start** to begin the chat. 4. Send the command: `/newbot` 5. Follow the prompts to: 1. Enter your bot's **name**. This is the public display name. 2. Choose a unique username that ends in `bot` , for example, `support_bot`. 6. Once the setup is complete, BotFather will send you a message with the *link to your bot* and your *API token* in the format: `HTTP API: <your-unique-token>` 7. Copy the API token. You’ll need it to connect the bot to your Rocket.Chat workspace.. ## Configure the Telegram app To configure the Telegram app in your workspace, follow these steps: 1. Go to **Marketplace** ![](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot 2025-12-23 130453.png) **> Installed.** 2. Click on the Telegram app to open its **App Info** screen. 3. Navigate to the **Settings** tab and configure the following fields as needed: | Field | Description | | --- | --- | | **Telegram Bot Token** * | The token you received when generating your Telegram bot. | | **Default Department Id or Name** | Add the ID or name of the department that should handle Telegram chats. This limits conversations to agents in that department. | | **Service Unavailable Message** | Message sent when no agents are online. | | **Welcome Message** | Message sent when a customer sends their first message. | | **Conversation Finished Message** | Message sent when an agent closes the conversation. | | **Agents Display Name** | Choose to display the agent’s name, username, or nothing. | | **File Upload Enabled** | Enable or disable file sharing during conversations. | | **Accepted Media Types** | - Enter a comma-separated list of file types that agents and Telegram users can share. - Leave blank to allow all types. - Some media types have limitations, see [Telegram’s documentation](https://core.telegram.org/bots/api#sending-files) for details. | | **Message Text Formatting options** | Select the formatting style for your conversations. Available options are: - `None` - `Html` - `Markdown` - `MarkdownV2` These formats support elements like bold, italic, underline, strikethrough, spoiler text, and more. See [Telegram’s formatting guide](https://core.telegram.org/bots/api/#formatting-options) for details. | 1. Click **Save changes.** After configuring the app, you can send the bot link to your users for them to start sending messages on Telegram. Refer to [Telegram Agent's Guide](/v1/docs/telegram-agents-guide) for more details. > [!NOTE] > - You will only receive messages if you have [set up a department](https://docs.rocket.chat/docs/departments). Only agents assigned to that department will be able to receive and respond to Telegram chats. > - To view incoming or queued chats, go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) **> Omnichannel > Current Chats**. See [Omnichannel Conversations guide](https://docs.rocket.chat/docs/omnichannel-conversations) for more details. --- ## Uninstall Telegram app To delete the Telegram app from your workspace, follow these steps: 1. Go to **Marketplace** ![](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot 2025-12-23 130453.png) > **Installed**. 2. Click the **kebab menu** (three vertical dots) next to the **Telegram app**. 3. Select **Uninstall** and click **Yes** to confirm. > [!TIP] > To learn more about Telegram bots, see the [official Telegram bots guide](https://core.telegram.org/bots#6-botfather).