Skip to content

Telegram setup ​

The example config has no Telegram; first add the telegram section and the persona's telegram account from Optional features.

  1. Create one bot per character with /newbot at @BotFather and put the token in .env (e.g. TELEGRAM_LUNA_TOKEN: …).
  2. Use /setprivacy to set privacy mode to Disable, or make the bot a group admin; otherwise it only sees commands and messages addressed to it. After changing it, remove the bot from the group and add it again. The privacy_mode_enabled warning in the startup log points at this.
  3. Add the bot to the group and put the group ID (supergroups look like -100…) in telegram.chatIds. If you don't know it, start with any placeholder, send a message in the group, and read chat_id from the chat_ignored log event.

Telegram limitation: bots cannot see other bots' messages. With several characters in one group they do not see each other's replies; each one knows only what members said and what it said itself. Discord has no such limit.

Telegram replies convert Markdown into message entities and are split above 4096 characters. Characters put long explanations and lists in a ```fold block, shown as a quote that stays collapsed until tapped (inside it only bold/italic/strikethrough survive, code shows as plain text and links are written as "label (url)"). Reactions are limited to the emoji set allowed by the Bot API (which has no 😂).

BSD 2-Clause License