GramDesk GramDesk
en
Connect

Setup guide

How to Set Up a Telegram Bot for Customer Support

GramDesk turns a regular Telegram bot into a shared support inbox. Customers write to your bot, while your team replies from a private Telegram group where every customer gets a separate topic. You do not need code: create a bot in BotFather, connect the token to GramDesk, add the bot to a group and test the first conversation.

No coding
Setup in minutes
One customer - one topic
Team replies in Telegram

Only need a website button? Open the Telegram Button Generator.

1

@BotFather

/newbot → token

2

@GramDeskBot

Add bot → Connect group

3

Private Telegram group

Topics → team replies

What you need for setup

You do not need to create a separate CRM or write an integration. The basic setup happens inside Telegram: create a bot, connect it to GramDesk and add it to a private support group.

Still choosing the right workflow? See examples for website support, online stores, freelancers, small teams.

Telegram account

To create the bot and manage the group

Bot from BotFather

Customers will write to it for support

Bot token

Required to connect the bot to GramDesk

Private group

Your team will reply to customers there

Enabled topics

Every customer gets a separate conversation

Step-by-step GramDesk setup

This is the basic launch flow. After it, a customer can write to your Telegram bot and the message will appear in the support group as a separate topic.

1

Step 1. Create a Telegram bot with BotFather

Open Telegram and find @BotFather. Send /newbot, choose a bot name and username. BotFather will send a token. Save it because you will need it to connect the bot to GramDesk.

/newbot

Do not publish the token publicly. It gives a service access to your bot.

2

Step 2. Connect the bot to GramDesk

Open @GramDeskBot, press Start and choose Add bot. Paste the token you received from BotFather. GramDesk will be able to receive messages from your bot and link them to a support group.

@GramDeskBotOpen @GramDeskBot
3

Step 3. Create a private support group

Create a separate private Telegram group for customer support. Add your teammates and your Telegram bot. Avoid using a regular work chat so customer conversations and internal messages do not mix.

4

Step 4. Enable topics in the group

Open group settings and enable Topics. This is the key GramDesk layer: every customer gets a separate topic, so the team sees history and does not mix conversations.

Group settings -> Topics -> Enable
5

Step 5. Give the bot admin permissions

Add the bot as a group administrator and enable permissions needed for topics and messages. At minimum, it needs to manage topics and send messages. If Telegram shows Manage topics, Delete messages and Pin messages, enable them for stable operation.

These permissions are used to organize support conversations, not to control your team chat.

6

Step 6. Connect the group in GramDesk

Return to @GramDeskBot and choose Connect group. Select the support group you created. GramDesk will link the Telegram bot with the group, and new customer messages will appear there as separate topics.

Connect group
7

Step 7. Test the first conversation

Open your customer-facing bot as a normal user and send a test message. A new topic should appear in the support group. Reply inside that topic - the user should receive your reply in the bot chat.

How work looks after setup

1

Customer writes to bot

The customer sends a question to your support bot.

2

GramDesk creates a topic

A separate conversation appears in your private group.

3

Team replies in Telegram

Any teammate can answer inside the customer topic.

4

Customer gets the reply

The response goes back to the same bot chat.

The customer never sees managers’ personal accounts. For them, it looks like a normal chat with your Telegram bot, while your team works from a private group.

Common setup mistakes

Bot is in the group, but messages do not arrive

Check that the bot is connected to GramDesk with the token and that the group was selected through Connect group. Also make sure you are testing the customer bot, not @GramDeskBot.

Topics are not created

Check that Topics are enabled in the group and that the bot has permission to manage topics. Without topics, GramDesk cannot separate customers cleanly.

Team replies in the group, but the customer does not receive it

Make sure the reply is sent inside the customer topic, not in the general group chat. Also check that the bot is still connected and has not been removed.

I lost the BotFather token

Open @BotFather, choose the bot and regenerate the token. Then update the token in GramDesk.

Ready to connect your first bot?

Create a Telegram bot, connect it to GramDesk and test the first customer conversation in your support group. Your team replies from Telegram, while customers write to your bot.

What customers can send through the bot

The basic workflow works for more than text questions. Customers can send files, photos, voice messages and other Telegram message types when support needs context.

TextPhotosFilesVoiceVideo messagesStickers

FAQ

Do I need programming?

No. For the basic setup, Telegram, BotFather and the GramDesk management bot are enough. Code is only needed for custom integrations.

Will customers see my personal Telegram?

No. Customers write to your Telegram bot. The team replies from a private group, so managers’ personal accounts do not need to be published.

Can I add several teammates?

Yes. Add employees to the private support group. They can see customer topics and reply without a separate per-agent charge.

What if I have several projects?

You can use separate bots and groups for different projects, or design the workflow so the team sees where each customer came from. Clear bot and group names help a lot.

Can I put the bot link on my website?

Yes. After setup, add a Telegram link or button to your website. For a simple option, use the Telegram Button Generator.

How much does GramDesk cost?

One active bot costs about $0.10 per day, roughly $3 per month. Teammates are included without separate payment.