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

# Telegram

> Connect a Telegram bot to your Pawz agents.

# Telegram

Connect a Telegram bot to your Pawz agents.

## Setup

1. Create a bot via [@BotFather](https://t.me/BotFather) on Telegram
2. Copy the bot token
3. In Pawz, go to **Settings → Channels**
4. Select **Telegram**
5. Paste your bot token
6. Configure:
   * **DM policy** — open / allowlist / pairing
   * **Allowed users** — Telegram usernames (for allowlist mode)
7. Start the channel

## Configuration

| Field         | Required      | Description               |
| ------------- | ------------- | ------------------------- |
| Bot token     | Yes           | From @BotFather           |
| DM policy     | Yes           | Who can message the bot   |
| Allowed users | For allowlist | Comma-separated usernames |

## Features

* Direct messages and group chats
* Per-user sessions with memory
* Long messages auto-split for Telegram's 4096 char limit
* Prompt injection scanning on all incoming messages
* Agent routing via channel routing rules

## Routing

By default, all Telegram messages go to your default agent. To route specific users or groups to different agents, add routing rules in **Settings → Channels → Routing**.

## Tips

* Set your bot's description and about text in @BotFather for a polished experience
* Use `/setcommands` in @BotFather to add command hints
* For group chats, set the bot to **Group Privacy: disabled** so it can see all messages
