Discord Bot Setup
Set up the Resonance Discord Bot to automatically reward community engagement in your server. This guide walks through the full flow from Partner Portal to a live, automated engagement system.
Prerequisites
- A Resonance account at partners.rsnc.network
- A Discord server where you have admin permissions
- Funds deposited in your Resonance account
Step 1: Get Your Credentials
- Log in to partners.rsnc.network
- Go to Profile → Account and copy your Brand ID (starts with
0x) - Go to Profile → Security Key and copy your Security Key
Step 2: Add the Bot to Your Server
- In Partner Portal, go to Integrations → Discord
- Click "Add Resonance Bot to Discord"
- Select your server and authorize
Step 3: Connect Your Server
In any channel in your Discord server, run:
/setup connect brand_id:0xYOUR_BRAND_ID security_key:YOUR_SECURITY_KEY
This creates 3 default events:
| Event | What It Does | Reward |
|---|---|---|
daily_checkin | Detects "gm" / "gn" messages | 2 RSNC per day |
news_tracker | Template for announcement reaction drops | 5 RSNC per reaction |
regular_engagement | Rewards quality messages (100+ chars) | 10 RSNC, up to 5/day |
Step 4: Create a Perk
Create what users can redeem their RSNC for:
- In Partner Portal, go to Redeem → Create Perk
- Configure your perk (discount, access, merch, etc.)
- Set the RSNC price and supply
Users can browse perks in Discord with /perks and purchase with /perk-buy.
Step 5: Configure Channel Watch
Bind the news_tracker event to your announcements channel so every post automatically rewards engagement:
/watch start channel:#announcements
Now every message in #announcements will:
- Automatically get a reaction emoji from the bot
- Create an independent reward drop for that message
- Give 5 RSNC to each user who reacts (1 claim per user per message)
Optional overrides:
/watch start channel:#announcements emoji:📰 reward:10
Verify it's set up:
/watch list
Step 6: Configure Daily Check-in
The daily_checkin event is already active. Users who say "gm" or "gn" earn 2 RSNC once per 24 hours.
Adjust the reward:
/config reward daily_checkin 5
Restrict to a specific channel:
- Go to Partner Portal → Events → daily_checkin
- Under Detection Methods, add channel constraint
Step 7: Configure Regular Engagement
The regular_engagement event rewards quality messages (100+ characters, 20+ words) automatically.
Adjust the reward:
/config reward regular_engagement 15
Users can earn up to 5 rewards per day from quality messages.
Admin Commands Reference
/setup
| Subcommand | Description |
|---|---|
wizard or check | Interactive guided setup with permission audit |
status | Show current connection status |
connect brand_id:<ID> security_key:<KEY> | Link server to brand |
disconnect confirm:DISCONNECT | Unlink server (preserves user balances) |
security-key key:<KEY> | Update HMAC security key |
/config
Manage server configuration — events, roles, triggers, and more.
| Action | Example |
|---|---|
| View events | /config events |
| Set reward amount | /config reward daily_checkin 5 |
| Configure roles | /config roles |
| Set up triggers | /config triggers |
| Third-party bots | /config third-party |
| Milestone rewards | /config milestones |
/drop
Create instant reward drops for events:
/drop event_id:announcement_engagement
| Option | Default | Description |
|---|---|---|
type | button | button or reaction |
emoji | 🎁 | Custom emoji for reaction drops |
lifespan | 24h | Duration: permanent, 1h, 5m, etc. |
label | "Claim Reward" | Button text (button drops only) |
description | — | Drop description/rules |
Button drops post a message with a claim button. Reaction drops add an emoji to a message — users react to claim.
/watch
Auto-create reaction drops for every new message in a watched channel:
| Subcommand | Description |
|---|---|
start channel:<CHANNEL> | Bind a template event to a channel |
stop channel:<CHANNEL> | Stop watching a channel |
list | Show all watched channels |
Options: event (default: news_tracker), emoji, reward.
/perk (Admin)
Manage perks directly from Discord:
| Subcommand | Description |
|---|---|
create name:<NAME> price:<RSNC> | Create a new perk |
edit id:<ID> | Edit an existing perk |
delete id:<ID> confirm:true | Soft-delete a perk |
list | List all perks for your brand |
Verify Everything Works
Run the diagnostic suite:
/test all
Then test manually:
- Daily check-in — Type "gm" → should earn RSNC
- News tracker — Post in watched channel → bot adds emoji → react from another account → should earn RSNC
- Regular engagement — Post a quality message (100+ chars) → should earn RSNC
Summary
| Step | Action | Command / Location |
|---|---|---|
| 1 | Get credentials | partners.rsnc.network → Profile |
| 2 | Add bot | Partner Portal → Integrations → Discord |
| 3 | Connect server | /setup connect brand_id:... security_key:... |
| 4 | Create perk | Partner Portal → Redeem → Create |
| 5 | Watch channel | /watch start channel:#announcements |
| 6 | Tune daily check-in | /config reward daily_checkin N |
| 7 | Tune engagement | /config reward regular_engagement N |
Next Steps
- Create Reward Events — Add custom events beyond the defaults
- Integrations — Connect your website, Shopify, and social platforms
- Analytics — Monitor engagement and distribution metrics