Navigation
ELOWEN · Documentation

Last updated: October 27, 2026

Browse documentation · Telegram Plugin
Channels and chatbots

Telegram Plugin

Connect a Telegram bot so Chetty answers your chats, keeps its own conversation in each one and can manage groups.

Where to find it

Install and configure the plugin in Settings → Plugins. The bot token goes in Settings → Access → Telegram; everything else is on the plugin's detail view. Installing, enabling or disabling the plugin takes effect after Chetty restarts, and some settings and per-chat overrides apply live.

Only an administrator can install, enable or configure this plugin. The token is stored as a secret, so its setting shows whether one is set, not its value. Without a token the plugin registers no tools; with a token, the tools return an error until the bot has connected.

The plugin requires Chetty 0.30.47 with shared API version 16.

Install and connect

  1. Create the bot with @BotFather and copy its token.
  2. Turn off BotFather's Group Privacy setting if the bot must receive every message in groups.
  3. Install and enable the plugin, then enter the token in Settings → Access → Telegram.
  4. Configure at least one role policy, and optionally allowlisted chats and a notification chat.

Read Connect the bot for the settings and the command menu.

Connection and access

The bot uses long polling, so it needs no public webhook and no open port.

Replies and media

Each chat has its own conversation, model and display settings. Use /new to start a fresh conversation there, and /context to continue one of your own conversations in a chat. Images go to the configured vision model, and voice notes are transcribed when voice is enabled.

Read Replies, media and voice for every setting, the file rules and the menu timeout.

Tools and permissions

The plugin provides 16 tools for chat information, members, messages, moderation and forum topics, plus a raw Bot API call. The bot can do only what its rights in the chat allow.

Read Telegram tools for the tool list and the limits.