Soneium Score — Discord Quick Start

Set up a complete Soneium Score loyalty program in your Discord server. This guide walks through the full flow from Partner Portal to a live, automated engagement system.

Prerequisites

• A Loyalteez account at partners.loyalteez.app
• A Discord server where you have admin permissions
• Funds deposited in your Loyalteez account

Step 1: Get Your Credentials

1. Log in to partners.loyalteez.app
2. Go to Settings → Account and copy your Brand ID (starts with 0x)
3. Go to Settings → Security and copy your Security Key

Step 2: Add the Bot to Your Server

1. In Partner Portal, go to Integrations → Channels → Discord
2. Click "Add Loyalteez Bot to Discord"
3. 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 for you:

Event	What It Does	Reward
daily_checkin	Detects "gm" / "gn" messages	2 LTZ per day
news_tracker	Template for announcement reaction drops	5 LTZ per reaction
regular_engagement	Rewards quality messages (100+ chars)	10 LTZ, up to 5/day

Step 4: Set Up Your Perk

Create what users can redeem their LTZ for:

1. In Partner Portal, go to Perks → Create Perk
2. Configure your perk (discount, access, merch, etc.)
3. Set the LTZ price and supply

Users can browse and buy perks in Discord with /perks and /perk-buy.

Step 5: Configure Channel Watch

This is where the magic happens. Bind the news_tracker event to your announcements channel so every post automatically rewards engagement:

/watch start channel:#announcements

Now every message you post in #announcements will:

• Automatically get a reaction emoji from the bot
• Create an independent reward drop for that message
• Give 5 LTZ to each user who reacts (1 claim per user per message)

Optional overrides:

/watch start channel:#announcements emoji:📰 reward:10

To 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" in any channel earn 2 LTZ once per 24 hours.

To adjust the reward amount:

/config reward daily_checkin 5

To restrict it to a specific channel:

1. Go to Partner Portal → Events → daily_checkin
2. Under Detection Methods, add channel constraint: gm-gn

Step 7: Configure Regular Engagement

The regular_engagement event rewards quality messages automatically. It triggers when a user posts a message with 100+ characters and 20+ words.

To adjust:

/config reward regular_engagement 15

Users can earn up to 5 rewards per day from quality messages.

Verify Everything Works

Run the diagnostic suite:

/test all

Then test each event manually:

1. Daily check-in: Type "gm" → should receive 2 LTZ
2. News tracker: Post in your watched channel → bot adds emoji → react from another account → should receive 5 LTZ
3. Regular engagement: Post a thoughtful message (100+ characters) → should receive 10 LTZ

Summary

Step	Action	Command / Location
1	Get credentials	partners.loyalteez.app → Settings
2	Add bot	Partner Portal → Integrations → Discord
3	Connect server	/setup connect brand_id:... security_key:...
4	Create perk	Partner Portal → Perks → 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

• Drops & Events Guide — Advanced drop strategies and manual drops
• Configuration Guide — Fine-tune all settings
• Commands Reference — Full command index