Telegram App
    • Dark
    • PDF

    Telegram App

    • Dark
    • PDF

    Article summary

    With the Telegram app on Rocket.Chat, your customers can send and receive Omnichannel messages from your workspace through a Telegram bot.

    Key features of the Rocket.Chat Telegram app

    • Manage Telegram conversations from a single inbox with unlimited chat history.

    • Engage with clients via multimedia chat.

    • Option to set up quick replies using bots.

    The Telegram app is used for Omnichannel conversations. To use your Telegram bot in rooms, see the Simple Telegram Bot integration.

    Install Telegram app

    To install the Telegram app in your workspace, follow these steps:

    1. Go to Administration > Apps > Marketplace.

    2. Search for the Telegram app.

    3. Click Install and accept the needed permissions.

    You must enable the Omnichannel feature with agents and managers assigned to receive and send Omnichannel messages.

    Generate your Telegram bot token

    To generate a Telegram bot token, follow these steps:

    1. Install and open the Telegram app on your device. Open a new chat, search and select "BotFather".

    2. Click Start. Type /newbot in the chat and Send.

    3. Select a name and a unique username for your bot.

    4. Once the username is accepted, a congratulatory message displays all the bot's details, including the API token.

    5. Copy the bot API token.

    Configure the Telegram app

    To configure the Telegram app in your workspace, follow these steps:

    1. On the Telegram App Info screen, go to the Settings tab.

    2. Update the following fields:



    Telegram Bot Token *

    The bot token you copied when generating the telegram bot.

    Default Department Id or Name

    Only the agents of this department can serve Telegram conversations.

    Service Unavailable Message

    The message that is sent to your customer when no agents are available online.

    Welcome Message

    The message sent to customers when they send their first message.

    Conversation Finished Message

    The message sent to your customer when an agent closes the conversation.

    Agents Display Name

    You can display the agent's name, or username, or not display anything.

    File Upload Enabled

    Enable or disable file sharing.

    Accepted Media Types

    Select the type of files that can be shared between the agents and your Telegram customers.

    Enter the values as a comma-separated list of media types. Leave it blank to accept all media types. There are some limitations for media types. For details, see

    Message Text Formatting options

    Select the text formatting option for your conversations. You can select one of the following values:

    • None

    • Html

    • Markdown

    • MarkdownV2

    The Bot API supports basic formatting for messages, like bold, italic, underlined, strikethrough, spoiler text, and more. For details, see

    1. Click Save changes.

    Send messages to your bot to test the configuration.

    You will only receive messages if you have a department set up. Only the agents of that particular department can receive the chats.

    Uninstall Telegram app

    To delete the Telegram app from your workspace, follow these steps:

    1. Go to Administration > Apps > Installed.

    2. Click the kebab menu against the Telegram app.

    3. Select Uninstall.

    4. Click Yes to confirm the uninstallation.

    To learn more about Telegram bots, see the official Telegram bots guide.

    Was this article helpful?


    Eddy AI, facilitating knowledge discovery through conversational intelligence