1
Create the bot in BotFather
Open @BotFather and send
/newbot.Give it a display name and a username. This is what your members will see, so
use your community’s name rather than anything mentioning Ace Up.BotFather replies with a token — a long string of digits, a colon, then
letters. That token is the bot: treat it like a password.2
Start /newvenue
Open @Aceupgamebot and send
/newvenue.You are shown the owner agreement first and asked to accept it before a venue
exists at all. Then you are asked for your venue’s name.3
Paste the token
Paste the BotFather token into the chat when asked.What happens next, in order:
- Ace Up calls Telegram’s
getMewith it, to confirm it is a real bot token and to read the bot’s ID and username. - The token is encrypted at rest under a key used for nothing else.
- Your message is deleted from the chat.
4
Wait for activation
Your venue sits as pending until a person at Ace Up approves it. Nothing
runs under your bot before that.See Activation.
Rotating or revoking the token
You own the bot, so you can take it back whenever you like.- Revoke —
/revokein BotFather invalidates the token. Your venue pauses automatically, because the bot stops answering, and you get a message from @Aceupgamebot telling you so. - Rotate — get a fresh token from BotFather, send
/newtokento @Aceupgamebot and paste it. A bot that was activated once goes straight back live: same venue, same links, the connection reinstalled, no second approval. A bot that was never activated waits for the admin card as usual.
/newvenue again points you at /setup and
/newtoken instead of creating a second venue. A second group is linked to the
same venue and bot, not to a new one.
Token rotation is done in the bot chat, never in a web form. A token typed
into a web page lands in browser history and autofill, which is exactly where a
bot token should not be.
If Ace Up revokes your bot
A platform admin can mark a bot revoked — it stops immediately and no instance runs for it. You recover with/newtoken and a fresh token from BotFather.
Activation
What happens when a person approves your venue.
