Managed Vouch Bot Documentation

# About Iluma Vouch Bots

Iluma gives each seller a managed Discord Vouch Bot connected to their Iluma account. The bot collects customer vouches, posts reputation embeds and connects those reviews to the seller's public Iluma profile.

# Quick Start

1. Sign in to Iluma with Discord
2. Make sure your Normal or Premium plan is active
3. Connect your Discord bot token in the Dashboard
4. Set Customer Role ID
5. Set Vouch Channel ID
6. Enable the required Discord intents
7. Invite the bot to your server
8. Start collecting vouches

# Normal vs Premium

# Bot Setup

Discord Bot Connection

Create a Discord application in the Discord Developer Portal, open the Bot section and use its bot token when connecting the managed bot from the Iluma Dashboard.

Server Configuration

# Discord Intents

Open: Discord Developer Portal → Application → Bot → Privileged Gateway Intents

SERVER MEMBERS INTENT   → Required
MESSAGE CONTENT INTENT  → Required only when text prefix commands are enabled

If you only use slash commands, Message Content Intent is not required.

# Optional Command Prefix

Sellers can enable a classic text prefix from the Dashboard. Slash commands stay enabled at the same time.

Prefix: !

/vouch       still works
/profile     still works

!vouch       also works
!profile     also works
!vouches     also works

Supported prefixes include !, ?, #, ., $, %, &, +, -, =, ~ and >.

# Vouch System

Vouch Numbers are separate for every managed bot. Each seller starts from number 1 and continues upward.

Seller A:
Vouch N°: 1
Vouch N°: 2
Vouch N°: 3

Seller B:
Vouch N°: 1
Vouch N°: 2

Public display:

Discord embed → 🔢 Vouch N°: 1
Website       → Vouch Number: 1

Customers can leave a rating, a reason and optional proof. Proof can be used later if Iluma selects the vouch for verification.

# Anti-Fake & Vouch Verification

Normal vouches do not need manual approval. Iluma can send suspicious or selected vouches to verification.

Normal vouch
    ↓
Accepted automatically

Suspicious / selected vouch
    ↓
Pending Verification
    ↓
Seller provides payment proof / chat logs / transaction evidence
    ↓
Iluma Admin reviews it
    ↓
Verified OR Rejected

Suspicious signals may include very new Discord accounts, recent server joins, unusual vouch volume, many sellers in a short period or highly similar review text.

# Premium Bot Customization

Premium sellers can customize how their managed bot appears.

Presence Type:
Playing
Watching
Listening
Competing

Online Status:
Online
Idle
Do Not Disturb
Invisible

Premium also includes supported managed-bot appearance settings and seller backup / restore functionality.

# Troubleshooting

Bot shows PrivilegedIntentsRequired

Enable SERVER MEMBERS INTENT. If a text command prefix is enabled, also enable MESSAGE CONTENT INTENT.

Prefix commands do not work

Check that a prefix is selected in the Dashboard and that Message Content Intent is enabled for that bot.

Slash commands do not appear

Restart the managed bot from the Iluma Dashboard and make sure the bot was invited with application command permissions.

Bot is offline

Check the managed bot status in the Dashboard. Invalid bot tokens or missing privileged intents can prevent the bot from connecting.

A vouch is missing from the public profile

A vouch selected for verification does not count publicly until it is approved by an Iluma administrator.