Telegram App

Article summary

Did you find this summary helpful?

Thank you for your feedback

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

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:

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

To generate a Telegram bot token, follow these steps:

Install and open the Telegram app on your device. Open a new chat, search and select "BotFather".
Click Start. Type /newbot in the chat and Send.
Select a name and a unique username for your bot.
Once the username is accepted, a congratulatory message displays all the bot's details, including the API token.
Copy the bot API token.

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

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

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.

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

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

Was this article helpful?

On this page