Navigation
ELOWEN · Documentation

Last updated: October 27, 2026

Browse documentation · Chat Platform Plugins
Channels and chatbots

Chat Platform Plugins

The Discord, Telegram and WhatsApp plugins connect Chetty to those chat platforms, and they share the same rules for access, conversations and notifications.

Before you start

  • Chetty 0.30.47 or newer, with shared API version 16. Check the registry for each plugin's current version.
  • An administrator, because only an administrator can install, enable or configure these plugins.
  • The plugin's own credential: a bot token for Discord or Telegram, or a paired WhatsApp device.

Discord and Telegram tokens are stored as secrets, so their settings show whether a token is set, not its value. WhatsApp uses the linked device's saved session. Discord and Telegram register their tools once a token is configured, and WhatsApp's tools need a paired device to reach the platform.

How platform access works

A role policy on Discord or Telegram, or a sender policy on WhatsApp, decides who the bot answers and can add extra instructions for a shared room.

  • Configure at least one policy, or the bot answers nobody.
  • The first matching named policy applies, and a * catch-all is evaluated after the named rules whatever its position.
  • A sender who matches no policy is ignored.
  • A policy does not replace identity. The sender also needs a linked Chetty account, whose Project access and tool permissions apply to the turn.

Each chat or channel has its own conversation and can have its own model and display settings. Use /new to start a fresh conversation there, and /context to bring one of your own Chetty conversations into a platform chat.

Images go to the configured vision model; other attachments follow the plugin's media limits. The bots can show tool progress and status reactions, depending on the platform and its settings.

Set a notification destination to receive proactive messages such as scheduled results. Leave it empty to turn those messages off.

Commands in a chat

A room's /compact, /fast and /restart are recorded in that chat's conversation, so the agent sees that they ran. A reply to a failed command names the actual error instead of a generic message. All three plugins share this command handling, so the behaviour is the same everywhere.

Operator commands need a policy with the administrator flag; each plugin page lists which commands those are.

Plugin pages

  • Discord Plugin — bot setup, connection, access, replies, media, voice and the 25 server tools.

Message and attachment limits

Platform Reply is split at Caption limit Shared files per reply
Discord 1,990 characters — Four
Telegram 4,000 characters 1,024 characters Four
WhatsApp 4,000 characters 1,024 characters Four
  • Audio up to 25 MiB uses Chetty's shared voice service. A native voice message gets a text answer followed by an OGG/Opus voice reply; an ordinary Discord or Telegram audio upload gets text only.
  • Voice must be enabled, and permission and spending limits belong to the linked account. A refused or failed transcription keeps the attachment note, and a refused or failed speech leaves the text answer.
  • Telegram and WhatsApp numbered menus, such as /model, expire after six minutes by default. Change this with Menu timeout.
  • A question the agent asks stays open until someone answers it or Chetty closes it.
  • A platform can reject an action when the bot or the paired account lacks permission.
  • Discord ignores direct messages and group DMs. Telegram tools need a connected bot, and WhatsApp tools need a paired device.