telegram-app

description
Omnichannel Integration between Rocket.Chat and Telegram.

Telegram App

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

{% hint style="warning" %} To use your Telegram bot in a room, see telegram.md. {% endhint %}

Install Telegram App

To install the Telegram App,

• Go to Administration > Apps > Marketplace.
• Search for the Telegram app.
• Click Install and accept the needed permissions.

{% hint style="warning" %} You must enable the Omnichannel feature with agents and managers assigned to receive and send Omnichannel messages. {% endhint %}

Generate your Telegram Bot Token

To generate a Telegram bot token,

• Launch your Telegram app. Open a new chat, search and select "BotFather".
• Click Start. Type “/newbot” in the chat and Send.
• Select a name and 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.

Configure the Telegram App

To configure the Telegram App,

• On the Telegram App Info screen, navigate to Settings.
• Update the required fields:
  • Bot Token: The bot token you copied when generating the telegram bot.
  • Default Department. Only the agents of this department can serve Telegram conversations.
  • Service Unavailable Message: The message 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.
  • File Upload Enabled: You can enable/disable file sharing.
  • Accepted Media Types: Select the type of files that can be shared between the Agents and your Twitter Contacts.
• Click Save Changes.

{% hint style="info" %} You will only receive messages if you have a department set up. Only the agents of that particular department can receive the chats. {% endhint %}

Uninstall Telegram App

To delete the Telegram app from your workspace,

• Go to Administration > Apps > Installed.
• Click the kebab menu against the Telegram app.
• Select Uninstall.
• Click Yes to confirm the uninstallation.

{% hint style="warning" %} To learn more about Telegram bots, see the official Telegram Bots Guide. {% endhint %}