---
name: telegram
description: Guide users through connecting a Telegram bot — creating a bot via BotFather, finding user IDs, and configuring admin vs public bots.
metadata: {"platform":{"optional":true}}
tools:
  - name: message
    publicAllowlist: false
    adminAllowlist: false
  - name: message-history
    publicAllowlist: false
    adminAllowlist: false
  - name: telegram-webhook-register
    publicAllowlist: false
    adminAllowlist: false
mcp:
  command: node
  args:
    - ${PLATFORM_ROOT}/lib/mcp-spawn-tee/dist/index.js
    - ${PLATFORM_ROOT}/plugins/telegram/mcp/dist/index.js
  env:
    MCP_SPAWN_TEE_NAME: telegram
    LOG_DIR: ${LOG_DIR}
    PLATFORM_ROOT: ${PLATFORM_ROOT}
    ACCOUNT_ID: ${ACCOUNT_ID}
    SESSION_ID: ${SESSION_ID}
mcp-manifest: auto
---

# Telegram Setup

Walks users through connecting Telegram bots. Covers bot creation, token configuration, finding numeric user IDs, and choosing between admin and public bot roles.

## When to activate

- User asks how to connect Telegram or set up a Telegram bot
- User asks about BotFather, bot tokens, or Telegram integration
- User needs to find their Telegram user ID for admin binding
- User asks about admin vs public bot configuration
- User is on the Setup page and asks about the Telegram section

## What it unlocks

- Telegram as a messaging channel — DMs and group conversations routed to the AI assistant
- Multi-bot support — separate admin and public bots with different access policies
- Admin routing — restrict a bot to admin-only access via numeric user ID bindings

## References

| Task | When to use | Reference |
|------|-------------|-----------|
| Guided setup | User wants help connecting Telegram | `references/setup-guide.md` |

Load the reference and follow its instructions.
