Slack Bot Setup

Step-by-step guide to install and configure the Resonance Slack bot for your workspace.

Prerequisites

• A Resonance brand with a Brand ID and Security Key
• Slack workspace admin permissions
• Access to the Resonance Partner Portal

Step 1: Install the App

Install the Resonance app from the Slack App Directory or use the direct install link provided by your Resonance account manager.

The app requires these permissions:

• Chat — Send messages and ephemeral responses
• Commands — Register slash commands
• Users — Read user info for admin checks
• Channels — Read message history for natural participation detection
• Reactions — Track emoji reactions

Step 2: Connect Your Brand

1. In any channel, run /setup
2. A modal will appear asking for your Brand ID and Security Key
3. Enter both values (find these in the Partner Portal)
4. Click Submit

Admin Only

Only workspace admins and owners can run /setup. This is verified via the Slack API.

Step 3: Verify the Connection

Run /daily in any channel. If everything is connected, you'll see a check-in confirmation with your RSNC reward.

Step 4: Invite to Channels

For natural participation detection (GM/GN rewards, quality messages), invite the bot to channels where you want activity tracked:

/invite @Resonance

Configuration

Cloudflare Worker Secrets

If you're self-hosting, set these secrets via wrangler secret put:

Secret	Description
SLACK_BOT_TOKEN	Bot User OAuth Token (xoxb-...)
SLACK_SIGNING_SECRET	App Signing Secret (for request verification)
SUPABASE_PUBLISH_KEY	Supabase anon/service key
ENCRYPTION_KEY	AES-256 key for security key encryption

Environment Variables

Set in wrangler.toml:

Variable	Default	Description
RESONANCE_API_URL	https://api.rsnc.network	Event Handler API
SHARED_SERVICES_URL	https://services.rsnc.network	Shared Services API
SUPABASE_URL	—	Your Supabase project URL

KV Namespace

Create a KV namespace for cooldowns, caching, and rate limiting:

wrangler kv:namespace create SLACK_KV

Database Setup

Run the SQL migrations in sql/ against your Supabase instance:

1. slack_workspace_configs.sql — Workspace-to-brand mapping
2. slack_user_stats.sql — Per-user engagement stats
3. slack_audit_log.sql — Admin action audit trail

Next Steps

• Getting Started — Configure events and rewards
• Commands Reference — Full command list