Overview

Vivy is an all-in-one Discord bot offering moderation, leveling, economy, giveaways, voice rooms, auto-moderation, verification, applications, and more — all configurable through a web dashboard.

Step 1: Invite Vivy

Invite Link

https://discord.com/oauth2/authorize?client_id=1481773011668434975&permissions=8&scope=bot%20applications.commands

Required Permissions

Permission Reference

Authentication Flow

First Steps

• Prefix: Ensure your prefix matches your preferred style. The default prefix is ?.
• Logs Setup: Route moderation and message updates to logs channels under Server Logs dashboard tab.
• Admin Safeguards: Set up your Security Owner Role under Security & Prefix tab to secure configurations.

The Vivy Web Dashboard consists of 20 modular tabs. Select your server to load configuration options immediately.

Configuration

• Channel Routing: Choose where welcome embeds are sent.
• Canvas Join Card: Upload custom canvas background image. Vivy paints the user avatar, nickname, and server join count dynamically on the card.
• DM Welcome: Send direct message alerts to newly joining members.

Ensure new members receive default roles immediately on join (e.g. "Member"). You can also configure separate roles for bot accounts.

Prefix Configuration

Modify your bot's text command prefix (default: ?). You can also set a backup prefix.

Security Owner Roles

Designate a specific role as the Security Owner. Only server administrators or members with this role can run sensitive protection toggles.

Defense Shields

• Anti-Bot: Automatically kick or ban newly joining unverified bot accounts.
• Anti-Webhook: Automatically destroy newly created webhooks to prevent token-leaks spam.

Whitelist & Filters

Enable the Link Filter shield to delete link messages. You can configure whitelisted roles that bypass this shield, as well as whitelisted domains (e.g. youtube.com, spotify.com).

Filters Configuration

Set limits for caps percentage, repeat messages (spam), emoji spam, and mass mentions. Configure punishments like deletion, warning, or automatic temp-mutes.

Set a role to assign to warned members, select a log channel, and create escalation thresholds (e.g. 3 warnings = temp mute, 5 warnings = server kick, 7 warnings = perm ban).

Select the muted role assigned during a mute command. Ensure the role has Send Messages permissions denied in all channels. Logs are routed to the specified mute logs channel.

Assign the jail role and set the default jail channel. While jailed, members lose all regular roles and can only view and type in the jail channel to submit appeals.

Channel Routing

You can route specific events to dedicated channels:

Browse all past warnings, mutes, timeouts, bans, kicks, and jails. Filter entries by action type, moderator name, or targeted user.

Roles Setup

Manage verification gate setup by configuring roles:

• Verificator Role: Staff allowed to approve member verification appeals.
• Unverified Role: Applied automatically on join to lock out general channels.
• Verified Role (Male/Default): Normal verified member role assigned on approval.
• Verified Female Role: Separate verified role available for female members.
• Verification Logs Channel: Channel routing verification events.

Post custom application panels in channels. Users click Apply, answer questions in a Discord modal, and their application is routed to review channels where staff can accept or decline with a button.

Configure server coin multipliers, daily coin rewards, and transaction tax rates (e.g. 5% coin tax on transfers). Set up items in the Server Shop that users buy using their virtual balance.

XP Modifiers

Adjust the XP gained per message and configuration of XP cooldown timers. Configure specific roles as Level Boosters to receive custom XP multipliers (e.g. 1.5x XP).

Level Up Rewards

Create automatic role rewards assigned to users once they reach specific levels (e.g. level 10 grants "Veteran" role).

Create, monitor, and cancel server giveaways from the dashboard. Whitelist specific roles to permit entries or set blacklisted members (using the ?vb command) to forbid entries.

Configure a "Join-to-Create" voice channel. When a member joins, Vivy automatically creates a private voice channel under the designated category. The channel is auto-deleted once empty.

Settings

• Join Voice Channel: Trigger voice channel.
• Room Category: Directory category where voice rooms spawn.
• System Logs Channel: Logs channel for session creations and joins.
• Staff Role: Role allowed to join and moderate help channels.
• Manager Role: Notified in logs when channels are generated.

Create text triggers and responses. When a member invokes the trigger (e.g. ?ip), the bot sends the custom response text. Perfect for providing quick links, rules, and server FAQs.

Generate, scope, and revoke secure API keys. Keys permit REST API access (e.g. reading logs, warning tables, or leveling statistics) on behalf of your guild.

Premium Perks

Enabling Premium activates advanced commands allowing users to spin up personal premium voice rooms. Premium rooms can be renamed, customized with emoji icons, assigned custom colors, and whitelist specific users.

Features

• Generate and delete API keys.
• Monitor REST API requests rates and limit resets.
• Inspect detailed usage charts.

Base Endpoint

https://yourdomain.com/api/v1

HTTP Headers Authorization

Authorization: Bearer YOUR_API_KEY
Content-Type:  application/json

Available Endpoints

API keys generated under Developer API Keys dashboard tab scopes restrict capabilities to specific database actions:

Configure webhook URLs to receive JSON payloads whenever the following events execute:

Bot offline or silent

Dashboard login errors

• Try logging out and back in to clear OAuth sessions.
• Enable browser cookie support (disabled cookies block OAuth handshakes).
• Disable private browsing or VPN filters if they block authorization tokens.

Response Errors