📚 Welcome to SagaBot Documentation

SagaBot is a comprehensive Discord engagement bot built for the SagaDAO community. It combines Twitter engagement tracking, NFT verification, gaming systems, raffles, and community management into one powerful platform.

🌊

Dao Drops (Discord)

Earn Drops through Discord participation: daily claims, chatting, voice chat, reactions, and events.

🎫

Tickets (Twitter)

Earn Tickets by engaging with promoted tweets: likes, retweets, comments, follows. Auto-verified!

🎟️

Live Raffles

Spend Tickets on raffle entries with animated live drawings and instant prize delivery.

🎮

Rumble Battles

Wager Drops in Solana-themed trading battles. Last trader standing wins!

🖼️

NFT Verification

Connect Solana wallet, verify NFT ownership, earn bonus Drops, and get exclusive roles.

🔧

Admin Dashboard

Wallet-based authentication, analytics, user management, and currency controls.

🚀 Quick Start

Get started with SagaBot in just a few steps:

💡 First Time Users

Make sure you have the necessary Discord permissions and a Twitter account for full feature access.

Step 1: Register Your Account

                    Discord
                    /register
                

Creates your SagaBot account and initializes your point balance.

Step 2: Link Your Twitter Account

                    Discord
                    /profile-wizard
                

Opens your profile management panel. Click "Link Twitter" to connect your account for automatic engagement verification.

Step 3: Connect Your Solana Wallet (Optional)

                    Discord
                    /wallet connect
                

This command provides a secure link to the Web Dashboard where you can connect your Solana wallet for NFT verification and Web3 features.

Step 4: Start Earning!

🌊 Earn Dao Drops (Discord):

                    Discord
                    /daily-claim
                

Claim daily Drops, then earn more by chatting, reacting, joining voice, and participating!

🎫 Earn Tickets (Twitter Raids):

                    Discord
                    /promoted-posts
                

View raids, complete actions (like/repost/reply/follow), verify each action, then /daily-claim!

✅ You're All Set!

Use /balance to check both currencies: 🌊 Drops (Discord) and 🎫 Tickets (Twitter)!

⚙️ Server Setup (Admins)

Configure SagaBot for your Discord server. Start by setting up all bot channels:

Step 1: Create Bot Channels

                    Discord
                    /setup-channels
                

Set up all dedicated bot channels including admin panel, user dashboards, raffles, raid channel, NFT verification, and support tickets. This is required before using bot features.

✅ Channels Created

This command creates a "🤖 SagaBot Dashboard" category with the following channels:

📊 user-dashboards - Personal user statistics
🛒 points-store - Purchase items with points
🎲 raffles - Active raffles and results
🚀 raid-channel - Twitter/X engagement posts
🛡️ nft-verification - Wallet connection and NFT verification
🎫 support - Create support tickets
⚙️ bot-admin-panel - Admin controls (Admin Only)

Step 2: Access the Bot Administration Panel

                    Discord
                    /admin
                

Opens the interactive ⚙️ Bot Administration Panel in your admin channel with buttons to manage all server settings.

📢

Channel Configuration

Click "📢 Channel Configuration" to set up dedicated channels for promotions, raffles, and announcements.

⚙️

Bot Settings

Click "⚙️ Adjust Bot Settings" to customize point values, rewards, and bot behavior.

🎨

NFT Verification

Click "🎨 NFT Collections" to add NFT collections for verification and role gating.

🌐

Web Dashboard

Click "🌐 Open Web Dashboard" for comprehensive server management and analytics.

💡 Pro Tip

All admin features are accessible through the /admin command's interactive panel. No need to remember individual commands!

💰 Dual Currency System

SagaDao uses two separate currencies to reward different types of community engagement:

🌊

Dao Drops (Discord Engagement)

Earned ONLY from Discord participation:

📅 Daily check-ins (10-50 Drops)
💬 Chatting in server (1-5 per message)
😊 Reacting to messages (1 per reaction)
🎤 Voice chat time (5 per 15 min)
🖼️ Holding Seeker NFT (20 daily bonus)
⚔️ Winning battles (10-100 Drops)

Used for: Marketplace, Battles, Roles

🎫

Tickets (Twitter/X Raid Rewards)

Earned ONLY from Twitter/X raids:

❤️ Like tweet (3 Tickets)
🔁 Repost/Retweet (5 Tickets)
💬 Reply/Comment (7 Tickets)
👤 Follow account (5 Tickets)
🚀 Complete all actions = 20 Tickets!

Used for: Live Raffles, Premium Events

💡 Key Differences

🌊 Drops = Discord engagement (chatting, voice, battles, daily claims)
🎫 Tickets = Twitter/X raids ONLY (like, repost, reply, follow)
💰 Drops used for: Marketplace, battles, roles
🎟️ Tickets used for: Raffles and premium events
Neither currency can be converted or traded. Earn both separately!

Checking Your Balances

                    Discord
                    /balance
                

View both your Dao Drops and Tickets in one command. Shows current balance, total earned, and leaderboard rank.

🎮 Rumble Battles

Compete in thrilling Solana-themed last-man-standing trading simulations where community members battle market volatility!

Command	Description
/battle	Join or view active Rumble battles and compete for glory
/rumble	Participate in community Rumble events
/createrumble	Create a new Rumble battle event (admin only)

What is Rumble?

Rumble is a Solana-focused trading simulation where SagaDao community members compete to survive crypto market scenarios. Navigate through realistic Solana ecosystem events and prove your diamond hands!

🚀

Survival Events

Made 10x on a gapper token • Got whitelist for hot projects • Sold the top and bought a Ferrari • Launched a successful DAO

💀

Defeat Events

Got rugged • Sold the bottom • Didn't HODL and missed a 10x • Paper hands panic sold

🏆

Community Competition

Last trader standing wins! Compete with SagaDao members for bragging rights and rewards.

📊

Leaderboards

Track your Rumble stats, wins, and climb the community rankings.

🌊 Dao Drops - Discord Economy

Earn Dao Drops through Discord participation! Check balances, claim daily rewards, and climb leaderboards.

✅ What are Dao Drops?

Drops (also called "Droplets" for small amounts) are earned through Discord community engagement. Spend them on marketplace items, custom roles, and battle wagers. 1 Drop = 1 Point in your balance.

Command	Description
/balance	Check your Dao Drops (🌊 Discord) and Tickets (🎫 Twitter) balance
/daily-claim	🌊 Claim daily Dao Drops with streak bonuses (2x at 7 days, 3x at 30 days!)
/leaderboard [type]	View top earners (drops, tickets, combined, battles, NFTs)
/marketplace	🋍️ Browse and purchase items/roles with Dao Drops
/profile-wizard	Link Twitter (for Tickets) and wallet (for NFT Drop bonuses)

How to Earn Dao Drops

📅

Daily Check-in

10-50 Drops per day
Streak bonuses up to 5x!

💬

Chat Messages

1-5 Drops per message
1 min cooldown

😊

Reactions

1 Drop per reaction
All emoji supported

🎤

Voice Chat

5 Drops per 15 minutes
AFK detection included

🖼️

Seeker NFT Bonus

+20 Drops daily
Auto-verified holders

⚔️

Battle Wins

10-100 Drops per win
Based on wager amount

💡 Pro Tip - Streak Bonuses

Maintain your daily claim streak to earn massive multipliers! 7-day streak = 2x Drops, 30-day streak = 3x Drops, 100-day streak = 5x Drops + special role.

🎟️ Raffles & Events

Spend 🎫 Tickets (not Drops!) on raffle entries for a chance to win amazing prizes!

Command	Description
/raffles	Browse all active raffles (shows 🎫 Ticket costs)
/raffle buy <id> [tickets]	Purchase raffle entries using 🎫 Tickets (not Drops!)
/raffle entries	View all your raffle entries across events
/raffle info <id>	Get detailed raffle information (prize, cost, draw time)
/raffle-wizard	Create and manage raffles via a guided interface (Admin Only)

⚠️ Important: Raffles Use Tickets (Not Drops!)

Raffles require 🎫 Tickets, which you earn from Twitter/X raids (not Discord Drops). Use /promoted-posts to view raids, complete actions (like, repost, reply, follow), then verify to earn Tickets!

Live Raffle Drawings

Watch raffle drawings live with our animated ticket system! Winners are announced with:

🎟️ Animated ticket drawing with 3D effects
🎉 Confetti celebration
📢 Instant Discord notifications
🏆 Prize delivery automation

✨ Live Stream Integration

Raffle drawings can be streamed live! Visit the raffle page at /raffle/:id/live to watch in real-time.

🐦 Twitter/X Raids - Earn Tickets!

Earn 🎫 Tickets by completing raid actions on promoted posts! Link your Twitter for instant auto-verification.

✅ What are Tickets?

Tickets are SagaDao's premium currency earned ONLY from Twitter/X raids (like, repost, reply, follow). More valuable than Drops, Tickets are the primary currency for live raffles and special events. All raid actions are auto-verified via Twitter API!

Command	Description
/promoted-posts	View active raids on Web Dashboard
/promote	Create a promoted post (buy with Points, Credits, or Payment)
/daily-claim	Claim your verified Tickets from completed raids (past 24hrs)
/profile-wizard	Link Twitter account for auto-verification of raid actions

Ticket Rewards Per Raid Action

❤️

Like Tweet

3 Tickets per like

🔁

Repost/Retweet

5 Tickets per repost

💬

Reply/Comment

7 Tickets per reply

👤

Follow Account

5 Tickets per follow

🚀

Complete All Actions

20 Tickets Total!
(3+5+7+5)

✅

Auto-Verified

All actions verified via Twitter API instantly!

⚠️ How Raid Verification Works

1. Link Twitter with /profile-wizard
2. Click raid from /promoted-posts to open raid panel
3. Complete actions on Twitter (like, repost, reply, follow)
4. Return to Discord and click "✅ Verify [Action]" buttons
5. Bot auto-verifies via Twitter OAuth API instantly
6. Tickets are stored and claimed with /daily-claim!

🔑 OAuth Token Refresh: Tokens expire after 2 hours. If verification fails, click the "🔑 Refresh Auth" button (always visible on raid posts) to renew your OAuth connection. One click reconnects and you're back to raiding!

🎫 Support & Tickets

Get help from the team through our comprehensive support ticket system!

Command	Description
/support	Create a support ticket with category selection
/support-setup	Set up the support channel (Admin only)
/support-config [category] [role]	Configure which roles get pinged for each category (Admin only)
/ticket-manage list	List all open support tickets (Admin only)
/ticket-manage close [ticket_id]	Close a specific ticket by ID or channel mention (Admin only)
/ticket-manage stats	View comprehensive ticket statistics (Admin only)

Support Categories

💬

Discord Support

Discord server and bot issues

🌐

Website Support

Website and dashboard problems

⚙️

Development

Technical and development issues

🔓

Unlock Program

Unlock program questions

📢

Marketing

Marketing and promotion inquiries

💼

Business

Business partnerships and proposals

🦅

SDAC

Saga DAO Alpha Club support

How Tickets Work

Create Ticket: Click the "Create Ticket" button in the support channel or use /support
Select Category: Choose the category that best matches your issue
Provide Details: Fill out the subject and description in the modal
Private Channel: A private ticket channel is created where only you and admins can see
Get Help: Team members will respond to your ticket
Resolution: Admin closes the ticket when resolved, channel auto-deletes after 10 seconds

Ticket Management Tools (Admin)

Administrators have powerful tools to manage and track support tickets:

📋

List Tickets

View all open tickets with details and timestamps

🔒

Close Tickets

Close tickets by ID or channel mention, auto-deletes after 10s

📊

Statistics

Track total tickets, resolution times, and category breakdown

🏷️

Category Roles

Configure which team roles get pinged per ticket category

Ticket Data Tracking

The system automatically tracks comprehensive ticket information:

🆔 Unique Ticket IDs: Every ticket gets a unique identifier for reference
👤 User Information: Tracks who created each ticket
📁 Category Tracking: Records which category was selected
⏱️ Timestamps: Creation time, response time, and resolution time
💬 Message Transcripts: All ticket messages are logged for records
📈 Status Updates: Tracks ticket state (open, closed, resolved)
🔗 Channel Linking: Associates tickets with their Discord channels

                    Admin Examples
                    /ticket-manage list
/ticket-manage close ticket_id:12345
/ticket-manage stats
/support-config category:technical role:@TechSupport
                

💡 Pro Tip

The support channel is created automatically when you run /setup-channels. Users can create tickets by clicking the button or using /support. Use /ticket-manage stats to monitor your team's response effectiveness!

📢 Promoted Posts

Promote your Twitter/X content to the SagaDao community and reward members for engagement!

Commands

Command	Description
/promote buy	Purchase a promoted post package ($25 USDC via Solana)
/promote add	Add your tweet to promote after purchasing package
/promote list	View active raids on Web Dashboard
/admin promoted-posts	Admin view: manage, approve, or remove promoted posts

How It Works

💳

Purchase Credits

Buy promotion credits with Solana USDC ($25 per post)

🚀

Add Your Post

Submit your Twitter/X URL to promote for 24 hours

🎯

Get Engagement

Community members engage and earn points

📊

Track Results

Monitor engagement through the dashboard

Engagement Rewards (Tickets)

Community members earn Tickets for interacting with promoted posts:

❤️ Like: 3 Tickets
🔁 Repost/RT: 5 Tickets
💬 Reply: 7 Tickets
👤 Follow: 5 Tickets
✨ Complete All: 20 Tickets Total!

Promotion Features

📢 Featured Placement: Your post appears in the community feed
⏰ 24-Hour Duration: Active promotion period for maximum visibility
💰 Engagement Incentives: Built-in rewards encourage community interaction
🎯 Targeted Audience: Reach active Solana & NFT traders
📈 Analytics Dashboard: Track engagement metrics in real-time
🧪 Test Credits: Admins can grant test credits for trial promotions

Usage Workflow

Buy Package: Use /promote buy to open Solana USDC payment page
Complete Payment: Pay $25 USDC through secure Coinbase Commerce checkout
Add Tweet: Use /create-promoted-post with your Twitter/X URL
Verification: Bot validates the URL and creates raid post
Go Live: Post appears in /promoted-posts for 24 hours
Community Raids: Members earn Tickets by engaging with your tweet
Track Metrics: View engagement stats in admin dashboard

💡 Pro Tip

Promoted posts automatically expire after 24 hours. Plan your promotion timing for maximum community engagement! Use /promoted-posts to see all currently active raids and participate to earn Tickets.

⚠️ Admin Controls

Administrators can manage promoted posts using /admin promoted-posts. This opens an interactive dashboard to view, approve, or remove promoted posts. Use this to moderate content and ensure quality raids for the community.

🖼️ NFT Verification

Connect your Solana wallet and verify NFT ownership for exclusive roles!

Command	Description
/verify-nft [collection]	Verify you own NFTs from a specific collection
/wallet connect	Connect your Solana wallet via web interface
/wallet disconnect	Disconnect your wallet from SagaBot

Supported Wallets

👻 Phantom Wallet
🌊 Solflare
🪙 Glow
📱 Any Solana-compatible wallet

                    Example
                    1. Use /wallet connect
2. Click the link to open the secure Web Dashboard
3. Click "Connect Wallet"
4. Approve in your wallet
5. NFTs verified automatically!
                

🔒 Security

SagaBot never asks for your private keys. We only verify NFT ownership through your public wallet address.

👥 Community & Roles

Engage with the community and unlock special roles!

Command	Description
/roles	View all available roles in the server
/role-shop buy	Purchase a role with your points
/community poll	Create a community poll for voting
/afk [message]	Set your AFK status with optional message
/invite-quest	View invite rewards and your progress

🔧 Admin Tools

Powerful administration commands for server owners and moderators.

Command	Description
/admin	Open ⚙️ Bot Administration Panel with interactive buttons for all admin functions
/admin-dashboard	Open web dashboard for comprehensive server management and analytics
/admin-audit [user]	View comprehensive audit logs for user actions and system events

⚠️ Admin Permissions Required

These commands require Administrator or specific admin role permissions in your server.

📊 Web Dashboard

Access powerful analytics and management tools through the web interface.

Dashboard Features

📈 Real-time server statistics and analytics
👥 User management and moderation tools
🎟️ Raffle management and live drawing interface
🐦 Promoted post management
🖼️ NFT collection configuration
⚙️ Bot settings and customization
📊 Engagement metrics and reports

                    Access
                    Use /admin-dashboard in Discord
or visit: https://www.sagadaobot.app/dashboard
                

⚡ Solana Integration

SagaBot integrates with the Solana blockchain for wallet connections, NFT verification, and payments.

Features

👛

Wallet Connection

Connect any Solana-compatible wallet

🖼️

NFT Verification

Automated NFT ownership verification

💳

USDC Payments

Pay for promotions with USDC on Solana

🔐

Secure & Private

No private keys required, read-only access

                    RPC Endpoint
                    Using Helius RPC for fast and reliable Solana access
Mainnet Beta | Token22 Support | NFT Metadata
                

🔌 API Reference

For developers integrating with SagaBot.

🚧 Coming Soon

Public API endpoints are under development. Join our Discord for updates!