> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.flockx.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.flockx.io/_mcp/server.

# Bringing Your AI Agent to Telegram: Setup and Activation

> Connecting your AI agent to interact on Telegram

Connecting your AI agent to Telegram allows it to interact with users directly in their favorite messaging app. Follow these simple instructions to get your agent up and running on Telegram in just a few minutes.

### Connect your Agent to Telegram

## Step 1: Create a Telegram Bot

1. Open the **Telegram app** on your device.
2. In the search bar, type **"BotFather"** and select the verified BotFather account.
3. Tap **Start** to begin a chat.
4. Type `/newbot` to initiate the bot creation process.
5. Follow the prompts:
   * First, provide a display name for your bot.
   * Then, choose a username that ends in `bot` (e.g., `FlockxHelperBot`).
6. BotFather will generate an **API token** (a long string of characters).
7. **Copy this token**—you'll need it to connect your bot in the next step.

> ⚠️ **Important:** Keep your token private. It grants full access to control your bot.

## Step 2: Connect Your Bot to Your Flockx Agent

1. Log in at [flockx.io](https://flockx.io).
2. Go to your **Agent Management** dashboard.
3. Find your agent and click **Settings**.
4. Scroll to the **Integrations** section.
5. Locate **Telegram Integration**.
6. Click **Add Token**.
7. Paste the token you received from BotFather.
8. Enter your bot’s display name.
9. Click **Save** or **Connect** to finalize the link.

## Step 3: Deploy Your Bot in Telegram

Your bot is now live! You can:

* Search for your bot by its username in Telegram and start a chat.
* Add your bot to group chats.

## Step 4: Configure Group Settings (If Applicable)

To allow your bot to interact in groups:

1. After adding the bot to your group, tap on the group name.
2. Go to **Administrators** or **Group Settings**.
3. Add your bot as an **administrator**.
4. Grant permissions to **read messages** and **send responses**.

Your Flockx AI agent will now respond to users in real time, using the knowledge and tone defined in your settings.

## Troubleshooting Tips

* **Bot not responding in group?** Ensure it has admin privileges and proper permissions.
* **Token error?** Double-check you’ve pasted the correct token from BotFather.
* **No response from bot at all?** Verify that your Flockx agent is active and integrations are enabled.
* **Still need support?** Reach out to [contact@flockx.io](mailto:contact@flockx.io)

## Benefits of Telegram Integration

* Enable real-time interaction with users on a familiar, mobile-friendly platform
* Integrate AI support seamlessly into both private and group conversations
* Improve reach and responsiveness without needing to build a custom app
* Deliver 24/7 access to AI-driven answers, guidance, and recommendations
* Customize tone and capabilities through Flockx agent settings