> ## Documentation Index
> Fetch the complete documentation index at: https://noorle.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram Channel

> Deploy your agent as a Telegram bot. Support groups and direct messages.

Integrate your agent with Telegram for user interactions via bot.

## Setup Steps

<Steps>
  <Step title="Create Telegram Bot">
    1. Open Telegram
    2. Chat with @BotFather
    3. Send /newbot
    4. Follow prompts
    5. Copy bot token (save it)
  </Step>

  <Step title="Add Channel to Agent">
    1. **Agents** > Select agent
    2. **Settings** > **Channels**
    3. Click **Add Channel**
    4. Choose **Telegram**
  </Step>

  <Step title="Enter Credentials">
    Paste bot token from @BotFather
  </Step>

  <Step title="Test">
    1. Find your bot on Telegram
    2. Send /start
    3. Wait for response
    4. Verify it works
  </Step>

  <Step title="Deploy">
    Toggle **Enabled**. Bot now active.
  </Step>
</Steps>

## Features

* **Individual chats** - Direct messages with users
* **Group chats** - Bot in group conversations
* **Mention support** - Respond when mentioned in groups
* **Image/file** - Share results with users
* **4,096 char** - Message size limit (auto-splits)

## Commands

Telegrambot commands (optional):

```
/start - Initialize bot
/help - Show available commands
/status - Check agent status
```

Configure in @BotFather.

## Group Chat Usage

Add bot to Telegram group:

1. Add bot to group (admin permission needed)
2. Bot receives all messages
3. Responds when mentioned: "@botname question"
4. Or configure keyword responses

## Webhook Configuration

Noorle automatically configures webhook to receive messages.

* Webhook URL: Secure HTTPS endpoint
* Updates pushed in real-time
* \~100ms latency typical

## Rate Limits

* 30 messages/second per bot (Telegram limit)
* Long messages auto-split
* Each split counts as separate message

## Message Types

### Text

```
"What is 2+2?"
Agent responds: "2+2 equals 4"
```

### With Images

Agent can send images in responses (if using Image capability).

### With Files

Agent can share files (PDFs, docs, etc.).

## Limitations

* Can't edit sent messages
* Can't delete messages
* 4,096 character limit (splits automatically)
* No reactions/emojis (text only)

## Troubleshooting

### Bot not responding

* Check bot token is correct
* Verify bot is enabled
* Test agent in Console first
* Check Activity log for errors

### Messages delayed

* Telegram server delay (rare)
* Network latency
* Agent processing slow
* Check timeout settings

### Bot offline

* Verify webhook connected
* Check agent is active
* Restart agent if needed

## Privacy & Security

* All messages encrypted (Telegram -> Noorle -> Telegram)
* User data not stored (unless agent stores it)
* Bot token kept secret
* Configure privacy mode in @BotFather

## Cost

For current pricing details, see [Pricing](https://noorle.com/pricing/).

## Next Steps

* [Slack Channel](/docs/run/channels/slack)
* [SMS Channel](/docs/run/channels/sms)
* [Creating Agents](/docs/run/agents/creating-an-agent)