SwiftBot connects to your server through your own Discord application. You create the application once, hand SwiftBot the bot token, and optionally reuse the same application for Web UI sign-in.
1. Create the application
Open the Discord Developer Portal, choose New Application, and give it a name your members will recognize in Discord.
2. Add the bot and copy its token
-
Open the Bot page:
Select your application, then open its Bot page.
-
Add or reset the token:
Click Add Bot, or Reset Token if a bot already exists.
-
Copy the token immediately:
Discord only shows the token once. Copy it before leaving the page.
-
Paste it into SwiftBot:
During onboarding, paste the token. SwiftBot stores it in the macOS Keychain, not in a plain text file.
3. Enable gateway intents
On the application's Bot page, enable these privileged gateway intents:
- Server Members Intent — for join and leave events.
- Message Content Intent — for message rules and AI features.
- Presence Intent — for voice and online-status tracking.
4. Configure OAuth for the Web UI
Open OAuth2 > General in Discord, then copy the Client ID and Client Secret into SwiftBot > Settings > Web UI > Authentication.
5. Register redirect URIs
| Access mode | Redirect URI |
|---|---|
| Local-only dashboard | http://localhost:8090/auth/discord/callback |
| Public dashboard | https://your-bot.example.com/auth/discord/callback |
Keep it disabled unless you specifically need it. If it is on, SwiftBot can generate working invite URLs only after Discord OAuth is configured.