Skip to main content

Troubleshooting

Common issues and solutions for the Resonance Slack bot.

Setup Issues

/setup says "Only workspace admins can use this command"

The bot checks your Slack admin status via the users.info API. You must be a Workspace Admin or Workspace Owner. Regular members cannot run setup.

  • Ensure the bot has the commands OAuth scope
  • Check that interactivity is enabled in your Slack app config
  • Verify the request URL points to your Worker

"Workspace not configured" error on commands

Run /setup first to connect your workspace to a Resonance brand. You need your Brand ID and Security Key from the Partner Portal.

Command Issues

/daily says "already checked in today"

Daily check-ins have a 24-hour cooldown. You can only check in once per day.

/balance shows 0 but I've earned tokens

  • Tokens may still be processing on-chain. Wait a few minutes.
  • Check that the RPC endpoint is responding (Soneium network).
  • Run /daily or /join to ensure your wallet has been created.

Leaderboard shows no data

  • At least one user must have earned RSNC in the workspace
  • Try /leaderboard earnings alltime to see all-time stats

/streak claim says no milestones available

You must reach a milestone day (7, 30, 100, or 365) and not have already claimed it.

Natural Participation Issues

Bot doesn't detect "gm" messages

  • Ensure the bot is invited to the channel (/invite @Resonance)
  • The bot ignores its own messages and other bot messages
  • GM detection has a 24-hour cooldown — you can only earn once per day
  • The message must be in a public channel or private channel where the bot is a member

Quality messages aren't being rewarded

Quality message detection requires messages to meet minimum thresholds for length and word count. Very short messages won't qualify.

App Home Issues

App Home tab is blank

  • Click the bot's name in the sidebar, then click "Home"
  • The tab loads data on app_home_opened — it may take a moment on first load
  • If the workspace isn't configured, the App Home shows a setup prompt

Rate Limiting

Getting rate limited or temporarily banned

The bot uses behavior-based abuse detection. Rapid command spam may trigger throttling. Normal usage will not be affected. Temporary bans expire after 5 minutes.

Cross-Platform

Can I use the same wallet across Discord and Slack?

Not automatically — each platform creates a separate wallet (discord_{id} vs slack_{id}). Cross-platform wallet linking is planned for a future release.

Getting Help

If you're still having issues:

  1. Check the Resonance Status Page
  2. Contact support via the Partner Portal