Skip to main content

Quick Start

TL;DR

Bot to first reward in 10 minutes.

Step 1: Add the Bot

Use the invite link below to add Resonance to your server. You must have Manage Server permission to complete this step.

https://discord.com/oauth2/authorize?client_id=YOUR_APP_ID&permissions=2416045137&scope=bot%20applications.commands

Replace YOUR_APP_ID with your application ID from the Partner Portal.

When prompted, grant the following permissions:

PermissionPurpose
Send MessagesPost reward notifications and responses
Add ReactionsReact to eligible messages
Manage RolesAssign reward tier roles
Use Slash CommandsEnable / commands
Read Message HistoryEvaluate message context for rewards
Embed LinksDisplay rich reward cards

Step 2: Connect to Resonance

Run the setup command in any channel where the bot is present:

/setup connect brand_id:<your-brand-id> security_key:<your-key>

Both values are available in your Partner Portal dashboard under Integrations → Discord.

Once connected, the bot syncs your brand's event definitions and creates a set of default reward rules. No additional configuration is required to start earning.


Step 3: Verify Setup

Run a full diagnostics check:

/test all

Expected output confirms API connectivity, role permissions, and event sync status. Any failures are flagged with a short reason code.

To review your connection details at any time:

/setup status

This returns your brand ID, connected server, last sync timestamp, and active event count.

note

If /test all reports a permissions error, re-invite the bot using the link in Step 1 and confirm all six permissions are checked.


Step 4: Try It

Trigger a daily check-in by typing gm in any monitored channel. The bot reacts and awards 5 RSNC to your account.

If the message trigger does not fire (e.g., you have already checked in today), use the slash command directly:

/daily

Confirm your balance updated:

/balance

What's Running Automatically

Three reward events are enabled by default after setup:

EventTriggerReward
daily_checkinGM / GN messages5 RSNC
news_trackerQuality on-topic messages10 RSNC
regular_engagementConsistent daily participation3 RSNC

These defaults are a starting point. You can adjust triggers, amounts, and eligibility windows at any time.


What's Next