Skip to main content

Discord Bot Setup

Get the Loyalteez 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 Loyalteez 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 Loyalteez API.

Step 3: Connect Your Server to Loyalteez​

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 all default events in the database with sensible defaults:

  • GM/GN Check-ins (25/15 LTZ, 24h cooldown)
  • Server Join Bonus (50 LTZ, one-time)
  • Server Boost (500 LTZ)
  • Voice Activity (25 LTZ)
  • Daily Check-in (10 LTZ)
  • And more...

These events are stored in monitoring_rules and can be fully customized via /config events or the Partner Portal.

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 LTZ reward!

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 LTZ 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