Table of Contents

Telegram Quick Start

JQ Lee Updated by JQ Lee

Telegram Logo

Getting a Telegram Bot

To connect Telegram, a Telegram Bot is required. Read our guide to start.
The Telegram Bot that you want to connect to must not be connected to the Controller Bot. Refer to the FAQ for more information.

Connecting a Telegram Bot

Connecting an existing bot

Watch the video below for a step-by-step guide on How to Connect Your Existing Telegram Account to

Step 1: Go to Settings > Channels

Step 2: Click Add Channel > Telegram > Connect An Existing Bot

Step 3: Message the BotFather

Step 4: Send the command /mybots

Step 5: Select the bot to connect

Step 6: Select API Token from the menu options and copy it

Step 7: Add the API token to the corresponding field on the platform

Step 8: Click Connect to complete the setup

Connecting a new bot

Watch the video below for a step-by-step guide on How to Connect Telegram to

Step 1: Go to Settings > Channels

Step 2: Click Add Channel > Telegram > Create A New Bot

Step 3: Message the BotFather

Step 4: Send the command /newbot and follow the instructions

Step 5: Add the token in the corresponding field on the platform

Step 6: Click Connect to complete the setup

Once you have completed the setup, any messages sent to your Telegram Bot account will now be received in your Workspace.
Once the Channel is connected, scan the QR code to send a test message and make sure everything is working properly.

Channel Configuration

The Telegram Channel can be configured with a unique Channel name. This name will be used internally to identify the account.

Step 1: Click Settings > Channels

Step 2: Locate the Telegram Channel, click Manage

Step 3: Make the necessary configuration

Step 3: In the Telegram Configuration page you will see the following configurations:

  • Chat Link - A click-to-chat link is a shortened URL that directs customers to start or continue a conversation with your Telegram account. You can share this link to refer customers to a new or existing thread, based on whether the user has previously messaged your Telegram account. You can also generate a QR code to share the chat link to your Contacts.
  • Channel Name - The Channel Name can be changed and is used internally to identify the Channel.
Important: Ensure the details are correct for messages to be received successfully in your Telegram account.

Step 4: Click Save Changes to update the Telegram Configuration page

FAQ and Troubleshooting

Can I connect to a personal Telegram account?

To connect a Telegram Channel, a Telegram Bot is required. You can learn how to create a Telegram Bot here.

Why do I get the Forbidden: bot was blocked by the user error message?

If you see this error message next to a message on the platform, it means the Contact has blocked your Telegram bot. Blocking stops a Contact from receiving messages from a business. This often happens due to spam, where Contacts feel the business sends irrelevant content. Once blocked, your business can't send any messages, like broadcasts or 1-to-1 messages, unless the Contact contacts the business again.

I’m having trouble with my Bot Token

If your Telegram Bot token has been lost or if your existing token has been compromised, you may use the token command to generate a new one.

Why can’t I receive an inbound video message?

If you are unable to receive a video, the file size may be too large.

  • Check the size details of the video file
Telegram Bot can only receive video files up to 20MB in size. Learn more about file types supported by Telegram here.

Why can’t I receive inbound messages even though my Telegram Channel is connected?

A test contact may be sending test messages to a personal number instead of the Telegram Bot. Make sure the messages are sent correctly to the Bot.

Another potential reason is that the tokens may be mismatched. Make sure that the token on the platform matches the token provided by the BotFather.

You will also not be able to receive inbound messages if your Telegram Bot is connected to a Controller Bot. it is recommended to disable the Controller Bot to resolve this.

Why can’t I send outbound messages?

This is usually caused by a Telegram API error. Wait a few minutes before trying to send the message again.

Feeling stuck? Do not fear.

Need assistance? Contact us for support. Help is here!

Telegram Overview

Can't find what you're looking for? 🔎

Talk to an expert here!

Contact Support
Status Security
Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)