--- title: "Telegram" slug: "omnichannel-telegram" description: "Enable the Telegram channel for your contact center to receive and reply to messages from your contacts." tags: ["omnichannel", "Telegram", "social media"] updated: 2025-09-24T12:40:45Z published: 2025-09-24T12:40:45Z canonical: "docs.voiso.com/omnichannel-telegram" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.voiso.com/llms.txt > Use this file to discover all available pages before exploring further. # Telegram **Who should read this article**: Administrators Enable the Telegram channel for your contact center to receive and reply to messages from your contacts. ## Introduction Voiso's [Telegram](https://telegram.org) channel enables agents to reply to messages from your contacts and engage in conversations with Telegram users. For more information about the Telegram channel in Voiso, refer to [Telegram interactions](/v1/docs/omnichannel-workspace-telegram-interactions). Watch this video to learn how to add the Telegram channel to your contact center or read the procedures in this article: [Video](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Digital%20Channels%20Adding%20Telegram.mp4) ## Creating a Telegram account for your business To begin, download the Telegram app to your mobile device. Telegram requires a user account registered to a mobile phone number. ## Building a Telegram Bot for your contact center Contact centers rely on Telegram bots to automate tasks and interact with contacts. Telegram bots are special accounts that do not need a phone number to set up. For detailed information, refer to [How do I create a Bot](https://core.telegram.org/bots#how-do-i-create-a-bot). Here are the basic steps for building a Telegram bot: 1. **Get a bot token**: To create a [Telegram bot](https://core.telegram.org/bots), first talk to the **BotFather**, Telegram's bot that helps you create new bots. The first thing you need is a bot token. 2. Start a chat with the **BotFather** by searching for `@BotFather` from your Telegram account. 3. Type `/newbot` to create a new bot. 4. Choose a name and username for your bot. 5. **BotFather** gives you a token. The token is used to authenticate your bot with the Telegram API. This token is needed to access the API and build your bot. Save a copy of your token for later use. Tip Type `/help` to view all possible **@BotFather** commands. ## Connecting Telegram to your contact center To connect Telegram to your contact center, create a new channel in the **Digital channels** page. For more information, refer to [Digital channels](/v1/docs/digital-channels). To connect Telegram you require the following information: 1. Telegram [API token](/v1/docs/omnichannel-telegram#building-a-telegram-bot-for-your-contact-center) you got from **@BotFather** 2. The name to be associated with your contact center Telegram channel ### Channel setup The Voiso Telegram channel enables your agents to reply to messages from your contacts and engage in conversations with Telegram users. If you selected the **Telegram** channel in the **General** section, the **Channel setup** section is displayed. To set up the Telegram channel, enter the [Telegram access token](/v1/docs/omnichannel-telegram#connecting-telegram-to-your-contact-center) from **@BotFather** in the **Access token** field. ![Digital Channels Add Channel Page Telegram](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Digital%20Channels%20Add%20Channel%20Page%20Telegram.png) ### Configuration After you complete the [channel setup procedure](/v1/docs/omnichannel-telegram#channel-setup) and receive the **Channel 'channel name' setup successfully completed** notification, you can configure the channel for use in your contact center. Navigate to **Administration > Digital channels** and click the channel name to open the **Edit channel** page. The **Configuration** section is now available for you to add content to your Telegram profile for the channel. The information you add in this section is displayed to users when they interact with your contact center on this channel. ![Digital Channels Edit Channel Page Telegram Configuration](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Digital%20Channels%20Edit%20Channel%20Page%20Telegram%20Configuration.png) Complete the required information (refer to the table below) for each field, then click **Save**. | Field | Description | Example | Limitations | | --- | --- | --- | --- | | About | The text in the 'About' field of the bot's 'Info' page. | Providing 24/7 customer support for online orders. | Maximum 139 characters. | | Description | A description of the bot displayed to the contact before they start a chat. | We specialize in premium electronics and offer worldwide shipping. | Maximum 256 characters. | | Profile picture | The profile photo from your Telegram channel. This picture is displayed only if you have added it to your Telegram account. | A company logo or storefront image. | The picture should be a square with a max edge of 640px and max size of 5MB. | ## Enabling agents to handle Telegram messages Ensure that the Omnichannel Workspace is enabled for your agents. Refer to [Enabling Omnichannel](/v1/docs/enabling-omnichannel). ## Telegram in the CDR The Telegram channel has specific dispositions you can filter for in the [CDR](/v1/docs/reporting-cdr) **Disposition** menu: - Waiting - Active - Archived ![Digital Channels Telegram CDR Disposition Menu](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Digital%20Channels%20Telegram%20CDR%20Disposition%20Menu.png) ## Related - [Omnichannel Workspace Overview](/omnichannel-workspace-overview.md) - [Omnichannel Workspace](/agent-guide-omnichannel-workspace.md) - [Telegram interactions](/omnichannel-workspace-telegram-interactions.md)