Guide
Getting Started
From zero to a running bot in 5 minutes. There are two paths: Free and Starter use the shared Astero bot — no token, no Developer Portal, so skip steps 2–3. From Pro up you can create your own custom branded bot (your name + avatar), which needs a Discord application token — that's what steps 2–3 cover.
Prerequisites
- ✓A Discord account (signs you into Astero via OAuth — no separate password)
- ✓A Discord server where you have Manage Server permission
- ✓Only for a custom branded bot (Pro and up): a Discord application + bot token, created in the Discord Developer Portal (steps 2–3). Free and Starter use the shared bot and skip this entirely.
Steps
Sign in with Discord
Go to astero.gg/register and click Continue with Discord. Astero stores your Discord user id, username, email, avatar URL, and encrypted (AES-256-GCM) access / refresh tokens to keep your session alive. No password — Discord OAuth handles authentication.
Create a Discord application (Pro+ — custom branded bot only)
To run your own branded bot, you need a Discord application to host its identity :
- Open the Discord Developer Portal
- Click New Application → name it (this is the bot name your community will see)
- Open the Bot tab → click Reset Token → copy the token shown
- In the Privileged Gateway Intents section, enable
Server Members Intent+Message Content Intentif you plan to use Moderation / Leveling / AutoMod / Welcome / Tickets — Astero requests intents dynamically per enabled module (seeapps/bot-engine/src/bot/index.js). - Copy the Application ID from the General Information tab
Create the bot on Astero
From your dashboard click Create a bot. The wizard asks for :
- Bot name — shown internally on Astero
- Discord token — pasted from step 2
- Application ID — pasted from step 2
After the bot is linked to a guild, you can apply the Streamer Starter Kit preset from /dashboard/[guildId] to merge baseline welcome / leveling / anti-raid configs in one click (separately, the Twitch integration also has a preset/twitch-creator endpoint that wires 3 EventSub mappings).
Invite the bot to a Discord server
Once the bot is created, Astero generates an OAuth2 invitation URL with scoped permissions — only the bits you enabled in the wizard are requested. No Administrator bit unless you explicitly opt-in.
https://discord.com/oauth2/authorize ?client_id=YOUR_APPLICATION_ID &scope=bot+applications.commands &permissions=<computed-from-enabled-modules> &state=<csrf-token>.<botId> &response_type=code &redirect_uri=https://astero.gg/api/auth/discord/bot-callback
Click the link, select your server, accept the permissions. Astero detects the join and links the guild to your bot automatically.
Enable modules from the dashboard
Open your bot from the dashboard → click any module to configure it. Modules are independent — enable only what you need :
Start the bot
Click Start from the bot's page. Astero connects to Discord, registers your slash commands globally (propagation : 1-5 min), and your bot appears online.
Creator Edition (PRO) : your bot identity, your name + avatar. Discord users see your bot.
Multi-Creator Network / Studio Edition : 3 to 10 dedicated bot identities.
(Optional) Connect stream notifications
From the dashboard, open Stream notifications and connect a platform (Twitch / YouTube / Kick / Rumble / Reddit). For Twitch, you can apply the Streamer Starter Kit preset (endpoint POST /api/bots/:botId/integrations/:installId/preset/twitch-creator) to create the 3 standard mappings — sub announce, follow welcome, raid alert — in one click. Live SLA monitored at /status.