# 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.


---

# 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://help.botpenguin.com/ai-agents/creating-ai-agents-in-botpenguin/agent-settings/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.