> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/ai-agents/creating-ai-agents-in-botpenguin/install-ai-agents/install-agents-on-telegram.md).

# Install Agents on Telegram

This section contains essential information and step-by-step guidance for installing and connecting your Agent with Telegram inside BotPenguin.

### What is Install Agent – Telegram?

Installing an Agent on Telegram allows you to automate conversations, manage user queries, and deploy AI-driven chat experiences directly on your Telegram bot.

Once connected, your Agent can respond to messages, trigger workflows, and manage conversations from the BotPenguin Inbox.

***

### Benefits of Install Agent – Telegram

* 🚀 Automate Telegram conversations instantly
* 🤖 Enable AI-powered responses
* 📥 Manage all Telegram chats in one Inbox
* ⚡ Improve response time and efficiency
* 📈 Scale customer engagement seamlessly

***

### Before You Begin

* A Telegram account, to create your bot through **@BotFather**

***

### How to Install Agent – Telegram

Follow these steps to successfully connect your Agent with Telegram:

#### Part A: Create Your Bot with BotFather

1. Open Telegram and search for **@BotFather**.
2. Start a chat with BotFather and enter the command **`/newbot`**.
3. BotFather will ask you to choose a **name** for your bot. Enter and submit a bot name.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FXZN1KvezUVu9jIBrqbEE%2Fimage%20(66).png?alt=media&amp;token=16f9c95c-8489-4537-bcfa-49b17082a4a9" alt=""><figcaption></figcaption></figure>

4. Next, choose a **username** for your bot. The username must end in **"bot"** (e.g., `MySupportBot`).
5. Once the username is accepted, BotFather will generate your **Authentication Token**. Copy it.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F03CRG7yZQeeunvCKXcVt%2Fimage%20(67).png?alt=media&amp;token=addceaf2-f275-457b-bb64-8b91290543e4" alt=""><figcaption></figcaption></figure>

***

#### Part B: Connect Your Bot in BotPenguin

1. Go to the **"AI Agent"** section from the left sidebar. Select the Agent you want to install on Telegram.
2. Once opened, you'll see a menu screen. Click on the third option, **"Install Agent."**

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FDEfwILhKNHsZKyBjkmGg%2Fimage%20(68).png?alt=media&amp;token=5158533b-7685-48a1-bb37-0b3b762d4c5e" alt=""><figcaption></figcaption></figure>

3. You'll see all the platforms where you can install your Agent. Under **Social Platforms**, select **"Telegram."**

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Fsx3E8wtW4skq1vmqrPHA%2Fimage%20(69).png?alt=media&amp;token=5165ad7b-de6a-47a6-b8b6-9b7f86049be9" alt=""><figcaption></figcaption></figure>

4. Enter your Telegram **Username** and the **Authentication Token** you copied from BotFather.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FEuxYxfPbtNFTciw1nGaW%2Fimage%20(70).png?alt=media&amp;token=8ec9f966-ad22-4858-8cf6-a8e7be54945d" alt=""><figcaption></figcaption></figure>

5. Click **"Connect."**

Once verification is successful, your Telegram Agent will be connected and ready to use.

***

#### Troubleshooting

<details>

<summary>Verification fails even though the token looks correct</summary>

Confirm the token was copied in full from @BotFather with no extra spaces, and that it belongs to the same bot as the username entered.

</details>

<details>

<summary>Telegram doesn't appear under Social Platforms</summary>

Refresh the Install Agent screen. If it still doesn't appear, confirm your BotPenguin plan includes Telegram as a supported channel.

</details>

<details>

<summary>Agent connects but doesn't respond to messages in Telegram</summary>

Make sure the bot hasn't been blocked or deleted from @BotFather, and that the Agent is active in BotPenguin.

</details>

<details>

<summary>"Username already connected" error during setup</summary>

This Telegram bot is already linked to another Agent. Disconnect it from the other Agent first, or create a new bot via @BotFather.

</details>

***

#### FAQs

<details>

<summary>Where do I get the Telegram Bot Token?</summary>

You can generate the Bot Token by creating a bot through @BotFather on Telegram.

</details>

<details>

<summary>What if my Bot Token is invalid?</summary>

Ensure you copied the complete token correctly. If the issue persists, regenerate a new token using @BotFather.

</details>

<details>

<summary>What permissions does BotPenguin require?</summary>

BotPenguin requires access to manage messages, view account information, and automate conversations.

</details>

<details>

<summary>Will disconnecting Telegram stop message delivery?</summary>

Yes. Once disconnected, your Agent will no longer send or receive Telegram messages until reconnected.

</details>

<details>

<summary>Is Telegram integration available on all plans?</summary>

Telegram integration is available only on plans where Telegram is enabled.

</details>

***

### Support

If you still have questions for our team, write to us at [**support@botpenguin.com**](mailto:support@botpenguin.com). We'll get back to you within 48 hours.

***

### 🎉 Completion

🎉 Congratulations, you have successfully installed your Agent on Telegram!