Chat App Message Service:How to create a Telegram bot

Use cases

Chat App Message Service allows you to reach users worldwide through a Telegram channel. Before using a Telegram channel, you must create a bot on the Telegram platform to obtain an API token, which is your access credential. You also need to configure admin rights for the bot to manage groups and channels, enabling scenarios such as broadcast messaging and community operations.

Overview

To create a Telegram bot and configure its permissions, follow these steps:

1. Create a new bot using BotFather.

2. Set the bot's name and username.

3. Obtain and save the API token.

4. Complete the bot's profile (optional).

5. Configure admin rights for groups and channels.

BotFather is Telegram's official bot management tool. You create and configure all bots by chatting with BotFather.

Step 1: Open BotFather and create a bot

Using your registered Telegram account, open BotFather in your Telegram client (mobile, desktop, or web). You can do this in one of two ways:

• Search: In the Telegram search bar, enter BotFather and select the account with the official verification checkmark.

• Link: Go directly to https://t.me/BotFather.

After opening the chat, click Start to begin the conversation. Then, send the following command to create a new bot: /newbot. BotFather will guide you through setting the bot's name and username.

Step 2: Set the bot name

BotFather first asks for the bot's display name (name). This name is shown to end users and supports Chinese, English, or other languages. Enter a name and send it. Examples:

• Customer Support Assistant

• My Shop Assistant

• Order Service Bot

Step 3: Set the bot username

BotFather then asks you to set the bot username (username). The username must meet the following requirements:

• It can contain only English letters, numbers, and underscores.

• It must end with bot.

Examples: my_demo_bot, MyShopHelperBot.

The following usernames are invalid and cannot be used:

If the username is already taken, BotFather prompts you to enter another one. Try adding numbers or underscores, such as my_shop_bot or service_01_bot.

Step 4: Obtain and save the API token

After the bot is created, BotFather returns a message that includes the API token in the following format: 123456789:AAExampleTokenxxxxxxxxxxxxxxxxxxx

The API token is the core access credential for calling the Telegram Bot API and is required to connect your bot to Chat App Message Service. We recommend recording the following information for later use:

Step 5: Complete the bot profile (optional)

After you create the bot, you can further customize its profile in BotFather. The following settings are not required, but they improve the user experience:

Step 6: Configure bot permissions

If you want to use the bot in a group or channel, you must enable the required permissions. Complete all of the following operations in the BotFather chat.

Verify the bot

After you create and configure the bot, perform the following checks to verify that it works as expected:

1. In the Telegram search bar, search for your bot's username (for example, my_demo_bot) to confirm that it is discoverable.

2. Open the bot's profile page and click Start to confirm that it responds correctly.

3. Visit https://t.me/<your_bot_username> to confirm that the link opens correctly.

4. Add the bot to a test group or channel to confirm it has the correct permissions.

Next steps

After you create and configure the bot, create a Telegram channel in the and bind the bot's API token. You can then start sending messages through the Telegram channel.

FAQ