Botfather

Available on builds with botfather feature enabled.

A subset of https://discord.com/developers/applications/ implemented as chat-bot.

Bundled, but disabled by default, enable it in server configuration (see below).

Access the bot

Easiest way is to add it to your server. Go to Server Settings -> App Directory -> search for BotFather -> Add App.

Configuration

[botfather]
launch_bundled = true                       # false to disable the bot
restrict_to = [ "1314312507086602240" ]     # list of user ids who is allowed to use the bot (empty = everyone)

Manual start

It is possible to launch bot from terminal or host it on another machine.

To do so:

1. make sure botfather feature is enabled on target server;
2. set launch_bundled = false in server/config.toml of target server;
3. run botfather API_URL WS_URL TOKEN where:
   • API_URL is url of API server (e.g. http://localhost:9000/api/);
   • WS_URL is url of gateway server (e.g. ws://localhost:9001);
   • TOKEN is a token of botfather bot (it would be printed as warning in server log on when server is started);

Notes

• botfather has a hard coded limit of 7 bots per user;
• Current (may 2026) state of bot API can be described as half-baked: bots have exactly the same permissions as regular users. It is recommended to make use of restrict_to cfg field and limit bot owners to a number of people you (server owner) trust;