Skip to main content

Discord Bot Setup

Get the Resonance bot running in your Discord server in under 5 minutes.

Step 1: Add the Bot to Your Server​

  1. Go to Partner Portal → Integrations → Channels → Discord
  2. Click "Add Resonance Bot to Discord"
  3. Select your server and authorize the bot

The bot requires these permissions:

  • Send Messages
  • Embed Links
  • Add Reactions
  • Read Message History
  • Use Slash Commands
  • Manage Roles (for role rewards)

Step 2: Get Your Security Key​

  1. Go to Partner Portal → Settings → Security
  2. Click the copy icon next to your Security Key
  3. Copy the entire key (it's a long hex string)
Security Key Required

You must provide your Security Key when connecting your server. This authenticates your server and enables secure communication with the Resonance API.

Step 3: Connect Your Server to Resonance​

In your Discord server, run:

/setup connect brand_id:0xYOUR_BRAND_ADDRESS security_key:YOUR_SECURITY_KEY
Where to find your Brand ID

Your Brand ID is your wallet address shown in Partner Portal → Settings → Account (/settings/account). It starts with 0x and is 42 characters long.

Security Key Format

Your Security Key is a long hexadecimal string. Make sure you copy the entire key from Partner Portal → Settings → Security. If you don't have one, click "Regenerate" to create a new Security Key.

Default Events Auto-Created

When you run /setup connect, the bot automatically creates 3 focused events:

  • Daily Check-in (2 RSNC, 24h cooldown) — detects GM/GN messages
  • News Tracker (5 RSNC, 1 per user per message) — template for channel watch auto-drops
  • Regular Engagement (10 RSNC, 5 per day) — rewards quality message contributions

These events are stored in monitoring_rules and can be fully customized via /config events or the Partner Portal. Use /watch start channel:#announcements to activate the News Tracker on a channel.

Step 4: Configure Rewards​

After setup, visit the Discord tab in Partner Portal to configure:

  • Event reward amounts
  • Streak bonuses and grace periods
  • Voice time rewards
  • Third-party bot integrations
  • Role-based multipliers

Step 5: Check Connection Status​

Verify your server is connected:

/setup status

This shows:

  • ✅ Server name and Brand ID
  • ✅ Connection status
  • ✅ Bot permission status

Step 6: Run Full Diagnostics​

Run the diagnostic command to verify everything is working:

/test all

This will check:

  • ✅ Bot permissions
  • ✅ Service connectivity
  • ✅ Configuration validity
  • ✅ Event processing

Step 7: Test with a Reward​

Try claiming a daily reward:

/daily

You should see a success message with your RSNC reward!

What's Active Now​

After completing setup, your server is immediately live with these features:

No configuration required

These features work out of the box — your members can start earning right away.

Active reward events:

  • GM/GN detection — Members earn 2 RSNC by saying "gm" or "gn" (24h cooldown)
  • Quality message rewards — 10 RSNC for thoughtful messages (100+ characters, 5/day max)
  • News Tracker template — Ready for /watch start channel:#announcements

Available member commands: /join, /daily, /balance, /streak, /leaderboard, /perks, /help, /voice

Available admin commands: /config, /stats, /reward, /drop, /watch, /kpi, /test, /export, /audit

Safe Testing

Enable test mode before making changes to a live server:

/config test-mode enable:true

This lets you experiment with settings without affecting your members.

Want a pre-built program? The Partner Portal Program Wizard offers one-click templates — see Sample Programs for details.

Troubleshooting Setup​

Bot Not Responding​

  1. Check bot permissions with /setup check
  2. Verify bot role is above managed roles
  3. Check channel permissions specifically
  4. Ensure /setup was completed successfully

"Brand ID Not Found"​

  1. Verify your Brand ID is correct (42 characters, starts with 0x)
  2. Ensure you have an active subscription in Partner Portal
  3. Check that your brand has RSNC balance for rewards

"Security Key Required" or "Security Key Validation Failed"​

  1. Get your Security Key from Partner Portal → Settings → Security
  2. Make sure you copied the entire Security Key (it's a long hex string)
  3. Verify the Security Key matches the Brand ID you're using
  4. If you don't have a Security Key, click "Regenerate" in Partner Portal
  5. Run /setup connect again with both brand_id and security_key parameters

Next Steps​

Last updated on