Skip to content

Managing a bot

Every bot is created and configured through @GromCore — GROM's @BotFather. It is the command surface for everything a bot's owner does: creation, profile, commands, inline mode, Mini Apps, group settings.

@GromCore isn't in chat yet — but the operations are live

The conversational bot is not up yet. Most of what it will do already exists as an API method you can call today with your bot token; creation itself is POST /newbot. The table below maps each planned command to the call that does the job now, or marks it as waiting on a subsystem. Implementation status.

Creation and tokens

CommandDoesToday
/newbotCreate a bot (name → username → token)LivePOST /newbot
/mybotsList the bots you ownPlanned
/tokenShow the current tokenPlanned — shown once at creation
/revokeRevoke the token and issue a new onePlanned — revoking cuts sessions + webhooks immediately
/deletebotDelete a botPlanned

The username must end in bot (or _bot), and one account may own at most 20 bots. A token is shown once at creation and stored only as a hash — keep it.

Profile

CommandDoesToday
/setnameDisplay name, per languageLivesetMyName
/setabouttextShort line on the profile cardLivesetMyShortDescription
/setdescriptionLong text on the empty chatLivesetMyDescription
/setuserpicProfile photoPlanned — media pipeline

The bot profile page covers the about-vs-description distinction and per-language variants.

Interaction

CommandDoesToday
/setcommandsThe autocomplete command listLivesetMyCommands
/setmenubuttonThe menu button next to the inputLivesetChatMenuButton
/setinline, /setinlinegeo, /setinlinefeedbackEnable and tune inline modePlanned — inline subsystem
/setjoingroups, /setprivacyGroup behaviour and privacy modePlanned — bot-in-group flow

See commands for scopes and per-language lists, and buttons for the menu button.

Mini Apps, games, payments

CommandDoesToday
/newapp, /editapp, /delappDirect Link Mini AppsPlanned — Mini App runtime
/setmainappEnable the Main Mini AppPlanned
/setattachAttachment-menu entryPlanned
/newgame, /listgamesHTML5 gamesPlanned — games subsystem
/setpaymentsConnect a payment providerPlannedpayment model undecided

Why so much is planned

@GromCore is a front-end. A command is only as live as the capability behind it, so the split above is honest: profile and command management run today because their methods do; Mini Apps, games, inline mode and payments wait on subsystems that do not exist yet, and no chat command can conjure them early. Build against the live methods now — the conversational layer arrives on the same calls.