> 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/agent-settings/telegram.md).

# Telegram

The **Telegram Agent Settings** allow you to connect your AI agent with **Telegram** so it can automatically respond to user messages, qualify leads, answer questions, and hand over conversations to human agents when required.

If Telegram is not yet connected, you will see the message **“No Telegram integration found”** along with options to integrate.

### Accessing Telegram Agent Settings

To open Telegram settings for an agent:

1. Log in to your **BotPenguin Dashboard**
2. Go to **Agents**
3. Select the agent you want to configure
4. Open **Agent Settings**

<figure><img src="/files/9YX3B66ovjV2oIH787Z6" alt=""><figcaption></figcaption></figure>

5. Click on the **Telegram** tab

<figure><img src="/files/5ZRjgEqWBVl1ER0JiVn6" alt=""><figcaption></figcaption></figure>

6. Click on Integrate Telegram to integrate the agent .

### Why Integrate Telegram with Your Agent?

Connecting Telegram allows your agent to:

* Reply instantly to Telegram messages
* Automate customer support and lead qualification
* Handle FAQs 24/7
* Reduce response time
* Transfer chats to live agents (if enabled)

***

### Prerequisites Before Integration

Before integrating Telegram, ensure you have:

* A **Telegram account**
* A **Telegram Bot Token** created using **BotFather**
* Permission to manage the Telegram bot

***

### Steps to Integrate Telegram

#### Step 1: Click Integrate Telegram

On the Telegram Agent Settings page, click **Integrate Telegram**.

Then select the Telegram option.

<figure><img src="/files/ClFtMB7tMHMxMybb6AAX" alt=""><figcaption></figcaption></figure>

***

#### Step 2: Enter Bot Token

Paste the Username and Authentication Token generated .

<figure><img src="/files/gp5lDduZFwM7qa1RWyw6" alt=""><figcaption></figcaption></figure>

***

#### Step 3: Confirm Integration

Once validated:

* Telegram will be connected to the selected agent
* The integration status will update automatically

***

### After Successful Integration

Once Telegram is connected, your agent can:

* Receive messages from Telegram users
* Respond using AI and configured flows
* Trigger live chat handoff
* Log conversations in the Inbox

***

### Testing Your Telegram Agent

1. Open Telegram
2. Search for your bot by username
3. Start a chat and send a message
4. Verify the agent response
5. Check message logs in **Inbox**

***

### Agent Preview Panel

The **Agent Preview** on the right allows you to:

* Test agent responses
* Preview greeting messages
* Validate quick replies and flows

> Note: Preview is for testing logic; real Telegram testing must be done inside Telegram.

***

### Managing Telegram Agent Behavior

After integration, you can:

* Customize welcome messages
* Enable or disable AI replies
* Configure live chat handoff
* Pause or resume Telegram automation anytime

### FAQs

<details>

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

Telegram integration availability depends on your BotPenguin subscription plan.

</details>

<details>

<summary>Can I disconnect Telegram later?</summary>

Yes. You can remove or reconnect Telegram anytime from Agent Settings.

</details>

<details>

<summary>Will my bot respond instantly?</summary>

Yes, as long as the agent is active and properly configured.

</details>

<details>

<summary>Can I use the same bot token for multiple agents?</summary>

No. A single Telegram bot token can be used for only one agent.

</details>

### Need Help?

If your agent doesn’t show up after installation or you encounter code-related issues, contact us at [**support@botpenguin.com**](mailto:support@botpenguin.com) or reach out directly via the WhatsApp Support option. We typically respond within 48 business hours.