Telegram App

Prev Next

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:

Field

Description

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 https://core.telegram.org/bots/api#sending-files

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 https://core.telegram.org/bots/api/#formatting-options

  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.