# Install Telegram

Telegram can be installed from the Channels Marketplace. Once installed, you can have conversations with your customers over Telegram. 

### What you'll need 

* A Telegram account 

### Step one: Log in to Telegram and verify your phone number

1. On your mobile device, download and install the Telegram app. If you don't already have a Telegram account, you can create one now.
2. With the Telegram app open, click **Start Messaging**.
3. Enter your phone number when requested and complete the verification process. You'll be sent an SMS message containing a verification code. 

### Step two: Create a Telegram bot and copy the Bot Token 

{% hint style="warning" %}
During the Telegram bot setup process, you'll need to name your bot. Remember to use a **customer-friendly name** that demonstrates the bot's purpose, as **the name will be visible to customers** when they communicate with you on Telegram. 

For example, 'Weather Assistant' or 'TechSupport' would make suitable bot names.
{% endhint %}

1. Inside the Telegram app, search for '@BotFather' and click the Telegram profile.
2. Click **Start** to begin a chat.
3. Send the command '`/newbot`' as a message in the chat.
4. BotFather will ask you to name your bot. Reply with the name that you want to use.
5. BotFather will now ask you to choose a unique username for your bot. The name must end with the word 'bot' . For example, 'WeatherAssistantBot' or 'TechSupport \_ Bot' .
6. BotFather will reply with further information about your newly created bot. Copy the token that it shares in the message, and store it somewhere safe. 

### Step three: Install Telegram in MessageBird

1. Go to **Channels** > **Marketplace** and click **Telegram**.
2. Click **Install Telegram** and follow the installation process.
3. When asked for the bot token, enter the token you copied when you made your Telegram bot.
4. Click **Fetch**. The channel name and ID will be created automatically.
5. Click **Install Telegram** to complete the installation process. 

{% hint style="success" %}
You've successfully installed Telegram! Now you can start sending and receiving messages from your customers on Telegram.
{% endhint %}


---

# Agent Instructions: 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.bird.com/applications/channels/channels/supported-channels/telegram/install-telegram.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.