> For the complete documentation index, see [llms.txt](https://docs.csml.dev/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.csml.dev/studio/channels/telegram/installation.md).

# Installation

Creating a Telegram chatbot is particularly easy. You only need to get a regular Telegram account, then to interact with [**@BotFather**](https://t.me/botfather) on Telegram, which is a built-in bot that will help you setup your own bot!

## Telegram's @BotFather

![](/files/-MfyWg8nSGyLoSbXQwf0)

{% hint style="danger" %}
**Very important**: make sure that you never **EVER** show the bot's token to anybody! Otherwise anyone will be able to take control of your chatbot instantly.
{% endhint %}

BotFather lets you customize your bot even more. You can use the following commands:

* `/setname` to change the bot's name
* `/setuserpic` to change the bot's profile picture
* `/setdescription` and `/setabouttext` to change the bot's description/about texts

![](/files/-MfyZaN0gDTR1OjIAO54)

This is also a perfect way to try the Telegram commands feature, which is very powerful!

## CSML Studio Setup

Once you have received the bot's token, go to your bot's **Channels** page and click on **Telegram** to create a new Telegram chatbot.

![(obviously, this token is now revoked!)](/files/-MfyXLFFESjM5LyWe0BD)

Once this is done, you will be able to setup a few commands for your own bot. The `/start` command is mandatory and can not be removed (but you can change its description), and it will always trigger the chatbot's welcome flow. You can add more commands to your bot, which will show if you start typing `/` or click on the corresponding symbol in the Telegram interface:

![](/files/-Mfy_2NaBXZNkyX2VydU)

If you have flows matching the names of the commands, these flows will be triggered automatically. Otherwise, you can set custom rules in the [AI Rules section](/studio/getting-started/nlp/ai-rules.md) to match the given commands (including the leading `/`)

![](/files/-MfyZW2LBq3oy9ZAg_sZ)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.csml.dev/studio/channels/telegram/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.