Advanced Documentation
Complete guide to using Sorea Bot's powerful features and commands
Overview
Sorea is a powerful Discord bot designed to enhance your server with advanced moderation, invite tracking, and the innovative POJ (Ping on Join) system. This documentation covers all features and commands available.
Current Version: v2.1.0 | Servers: 79+ | Users: 900K+
Setup Guide
1. Invite Sorea to Your Server
Click the invite link and select your server. Make sure you have "Manage Server" permissions.
https://discord.com/api/oauth2/authorize?client_id=1368557398389952572&permissions=8&scope=bot
2. Initial Configuration
After inviting Sorea, run the setup command to configure basic settings:
/setup
Interactive setup wizard for initial configuration
Usage: /setup
Required Permissions
| Permission | Required For | Critical |
|---|---|---|
| Manage Messages | Moderation commands, message cleanup | Yes |
| Kick Members | Kick command | Yes |
| Ban Members | Ban/unban commands | Yes |
| Manage Roles | Role management, mute system | Yes |
| View Audit Log | Invite tracking, moderation logs | Yes |
POJ System Commands
Ping on Join (POJ) System
/poj setup
Configure the POJ system for your server
Usage: /poj setup #channel [role] [message]
/poj toggle
Enable or disable the POJ system
Usage: /poj toggle [true/false]
/poj stats
View POJ system statistics
Usage: /poj stats
Note: The POJ system requires "Mention Everyone" permission to ping roles.
Invite Management
Invite Tracking & Management
/invite leaderboard
Display the top inviters in your server
Usage: /invite leaderboard [limit]
/invite info
Get detailed invite information for a user
Usage: /invite info [@user]
/invite reset
Reset invite counts for a user or entire server
Usage: /invite reset [@user/all]
Moderation Commands
Moderation Tools
/ban
Ban a user from the server
Usage: /ban @user [reason] [delete_days]
/kick
Kick a user from the server
Usage: /kick @user [reason]
/warn
Issue a warning to a user
Usage: /warn @user [reason]
/mute
Temporarily mute a user
Usage: /mute @user [duration] [reason]
/clear
Delete multiple messages at once
Usage: /clear [amount] [@user]
Fun Commands
Entertainment & Games
/8ball
Ask the magic 8-ball a question
Usage: /8ball [question]
/roll
Roll dice with custom sides
Usage: /roll [sides] [count]
/coinflip
Flip a coin
Usage: /coinflip
API Reference
Sorea provides a REST API for advanced integrations and custom applications.
Base URL
https://api.sorea.bot/v1
Authentication
All API requests require authentication using your server's API key.
Authorization: Bearer YOUR_API_KEY
Endpoints
GET /stats
Get server statistics
Returns: member count, invite stats, command usage
POST /poj/trigger
Manually trigger POJ for a user
Body: {"user_id": "123456789", "channel_id": "987654321"}
Webhooks
Sorea supports webhooks for real-time notifications and integrations with external services.
Setting Up Webhooks
Configure webhooks to receive notifications when specific events occur in your server.
Webhook Events
Member Join
Triggered when a new member joins the server
Payload includes: user info, invite used, timestamp
POJ Trigger
Sent when POJ system activates
Payload includes: user info, channel, ping status
Moderation Action
Triggered on kicks, bans, warnings
Payload includes: action type, target user, moderator, reason
Webhook Configuration
/webhook add https://your-endpoint.com/webhook /webhook list /webhook remove [webhook_id]
Integrations
Connect Sorea with popular services and platforms to enhance your server's functionality.
Available Integrations
Third-Party Services
YouTube Notifications
Get notified when your favorite channels upload
Command: /youtube subscribe [channel_url]
Twitch Alerts
Announce when streamers go live
Command: /twitch follow [username]
Reddit Feed
Auto-post from subreddits
Command: /reddit subscribe [subreddit]
Custom Bots
Integrate with other Discord bots
Use webhooks and API for seamless integration
Setup Instructions
Each integration requires specific permissions and configuration:
# Enable integrations module /integrations enable # Configure specific service /integrations setup [service_name] # View active integrations /integrations list
Troubleshooting
Common Issues
Frequently Encountered Problems
POJ not working
Check bot permissions and channel settings
Solution: Ensure bot has "Mention Everyone" and "Send Messages" permissions
Commands not responding
Bot may be offline or lacking permissions
Solution: Check bot status and re-invite with proper permissions
Invite tracking inaccurate
Missing audit log permissions
Solution: Grant "View Audit Log" permission to Sorea
Frequently Asked Questions
Common Questions
Is Sorea free to use?
Yes, Sorea is completely free with all features available to everyone.
How do I get support?
Join our support server or use the /support command for assistance.
Can I customize POJ messages?
Yes, use /poj setup with a custom message parameter.
Does Sorea store user data?
Only necessary data for functionality (invite counts, warnings, etc.). No personal messages are stored.