> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vouchvault.cc/llms.txt
> Use this file to discover all available pages before exploring further.
# Create Custom Discord Bot
> Complete step-by-step guide to creating and configuring your custom Discord bot with VouchVault
**Important**: Follow each step carefully. Missing any step will prevent your bot from functioning properly.
## Prerequisites
Before starting, ensure you have:
* A VouchVault account at [vouchvault.cc](https://vouchvault.cc)
* A Discord server where you want to deploy the bot
* Administrator permissions on your Discord server
## Step 1: Access Bot Settings
1. **Sign in to VouchVault**
* Navigate to [vouchvault.cc](https://vouchvault.cc) and sign into your account
2. **Go to Bot Settings**
* Visit the [Bot Settings page](https://vouchvault.cc/dashboard/bot-settings)
* You'll see a page indicating "No Bots Found" if this is your first bot
3. **Start Bot Creation**
* Click the **"Create Your First Bot"** button
* This will open the bot creation modal with a 3-step process
## Step 2: Create Discord Application
Before configuring your VouchVault bot, you need to create a Discord application:
1. **Visit Discord Developer Portal**
* Go to [discord.dev](https://discord.dev)
* Click **"New Application"** in the top right corner
2. **Create Your Application**
* Choose a name for your bot application
* Accept Discord's Terms of Service
* Click **"Create"**
## Step 3: Configure Bot Details (Step 1 of 3)
Once your Discord application is created, you'll need to gather information for the VouchVault modal:
### Get Bot ID/Client ID
1. **Navigate to General Information**
* In the Discord Developer Portal, go to **"General Information"** tab
* You'll see your application details
2. **Copy Application ID**
* Find the **"Application ID"** field
* Click **"Copy"** button next to it
* This is the same as your Bot ID/Client ID
3. **Enter Client ID in VouchVault**
* Return to the VouchVault modal
* Paste the Application ID into the **"Client ID"** field
### Get Public Key
1. **Copy Public Key**
* On the same General Information page in Discord
* Find the **"Public Key"** field
* Click **"Copy"** button next to it
2. **Enter Public Key in VouchVault**
* Paste the Public Key into the **"Public Key"** field in the VouchVault modal
3. **Continue to Next Step**
* Click **"Next"** to proceed to authentication setup
## Step 4: Authentication Setup (Step 2 of 3)
### Get Client Secret
1. **Navigate to OAuth2 Tab**
* In Discord Developer Portal, click on the **"OAuth2"** tab in the left sidebar
2. **Reset Client Secret**
* Find the **"Client Secret"** section (it will show "Hidden for security")
* Click **"Reset Secret"** to generate a new client secret
* **Important**: Copy the generated secret immediately as it won't be shown again
### Get Client Secret
1. **Navigate to OAuth2 Tab**
* In Discord Developer Portal, click on the **"OAuth2"** tab in the left sidebar
2. **Reset Client Secret**
* Find the **"Client Secret"** section
* Click **"Reset Secret"** to generate a new client secret
* **Important**: Copy the generated secret immediately as it won't be shown again
3. **Enter Client Secret**
* Return to the VouchVault modal
* Paste the client secret into the **"Client Secret"** field
### Set Bot Name
**Naming Guidelines**: Choose a professional name related to your service or business. Avoid generic names like "Vouches", "vouch", or "Vouch" as these will negatively impact your profile display since many users are already using these same names.
1. **Choose Professional Bot Name**
* Enter a unique, professional name (no spaces allowed)
* This name will be used to identify your vouch profile
* Make it relevant to your service or business
* Examples: "TechSupportVouches", "GameBoostingBot", "ServiceReviews"
2. **Continue to Final Step**
* Click **"Next"** to proceed to the setup phase
## Step 5: Final Setup (Step 3 of 3)
### Configure Bot Token
1. **Navigate to Bot Section**
* In Discord Developer Portal, go to the **"Bot"** tab in the left sidebar
2. **Enable Privileged Gateway Intents**
* Scroll down to find **"Privileged Gateway Intents"**
* Enable all 3 intents by toggling them ON:
* ✅ **Presence Intent**
* ✅ **Server Members Intent**
* ✅ **Message Content Intent**
3. **Reset Bot Token**
* Find the **"Token"** section
* Click **"Reset Token"**
* Copy the new token immediately
* Paste it into the **"Bot Token"** field in VouchVault modal
### Get Server ID
1. **Enable Developer Mode** (if not already enabled)
* In Discord, go to User Settings (gear icon)
* Navigate to **Advanced** settings
* Enable **Developer Mode**
2. **Copy Server ID**
* Go to your Discord server
* Right-click on the server name in the server list
* Select **"Copy Server ID"** from the context menu
* Paste it into the **"Server ID"** field in VouchVault
### Set Interactions URL
1. **Copy Interactions URL**
* Use this exact URL: `https://vouchvault.cc/api/interaction/discord`
* Paste it into the **"Interactions URL"** field in VouchVault
2. **Create Bot**
* Review all your entered information
* Click **"Create Bot"** to finalize the setup
## Step 6: Configure Discord Interactions Endpoint
**Critical Step**: This step is mandatory. Failure to complete this will prevent your bot from working properly and all commands will fail.
1. **Return to Discord Developer Portal**
* Go back to your application in Discord Developer Portal
* Navigate to **"General Information"** tab
2. **Find Interactions Endpoint URL Section**
* Scroll down to find the section labeled:
* **"Interactions Endpoint URL"**
* *"You can optionally configure an interactions endpoint to receive interactions via HTTP POSTs rather than over Gateway with a bot user."*
3. **Set Interactions Endpoint URL**
* Enter exactly: `https://vouchvault.cc/api/interaction/discord`
* Click **"Save Changes"**
3. **Set Interactions Endpoint URL**
* Enter exactly: `https://vouchvault.cc/api/interaction/discord`
* Click **"Save Changes"**
This configuration ensures your bot receives interactions properly and all slash commands will work correctly.
## Step 7: Invite Bot to Server
After successfully creating your bot, VouchVault provides an easy way to invite it to your server:
1. **Access Bot Settings**
* After bot creation, you'll be redirected to the Bot Settings page
* You'll see your newly created bot listed under "Your Discord Bots"
2. **Invite Bot to Server**
* Click the **"Invite to Server"** button next to your bot
* This will open Discord's authorization page
* Select your server from the dropdown
* Click **"Authorize"** to add the bot
* Complete any CAPTCHA if prompted
The "Invite to Server" button automatically generates the correct invite link with all necessary permissions and scopes pre-configured.
## Verification Checklist
Your bot should now be properly configured. Verify the following:
* ✅ **VouchVault Bot Created**: Bot appears in your VouchVault dashboard
* ✅ **Discord Application**: Application exists in Discord Developer Portal
* ✅ **Privileged Intents**: All 3 intents are enabled
* ✅ **Interactions Endpoint**: Set to `https://vouchvault.cc/api/interaction/discord`
* ✅ **Bot in Server**: Bot appears in your Discord server member list
* ✅ **Commands Working**: Bot responds to slash commands
## Testing Your Bot
**Important**: VouchVault bots use HTTP interactions, which means they don't show traditional online/offline status indicators like regular Discord bots. This is normal behavior and doesn't indicate any issues with your bot.
### Test Bot Functionality
1. **Test Basic Bot Response**
* In your Discord server, type `/stats`
* If the command appears and executes successfully, your bot is working correctly
* This command will show your server's vouch statistics
2. **Test Vouch Commands**
* Try the main vouch command: `/vouch`
* This should bring up the vouch creation interface
* Follow the prompts to create a test vouch
3. **Verify Command Availability**
* Type `/` in your server to see all available slash commands
* Your VouchVault bot commands should appear in the list
* Commands may include: `/vouch`, `/stats`, and others
### Expected Behavior
✅ **Working Correctly**:
* Slash commands appear when typing `/`
* `/stats` command executes and shows data
* `/vouch` and input the prompts required
* Bot responds to interactions immediately
❌ **Potential Issues**:
* Commands don't appear in the slash command list
* Commands appear but show "Application did not respond" error
* No response when trying to execute commands
### Troubleshooting Command Issues
If commands aren't working:
1. **Check Interactions Endpoint**
* Verify the Discord Developer Portal has the correct endpoint: `https://vouchvault.cc/api/interaction/discord`
2. **Verify Bot Permissions**
* Ensure the bot has "Use Slash Commands" permission in your server
* Check that the bot can send messages in the channels you're testing
3. **Wait for Sync**
* Slash commands can take up to 1 hour to sync globally
* Try using the commands in a DM with the bot for faster testing
## Troubleshooting
### Bot Not Responding
* **Check Privileged Intents**: Ensure all 3 Gateway Intents are enabled
* **Verify Interactions URL**: Confirm it's exactly `https://vouchvault.cc/api/interaction/discord`
* **Token Issues**: Try resetting the bot token and updating it in VouchVault
### Commands Not Appearing
* **Interactions Endpoint**: Double-check the endpoint URL is set correctly
* **Bot Permissions**: Ensure bot has proper permissions in your server
* **Server Sync**: Commands may take a few minutes to sync
### Profile Display Issues
* **Bot Name**: Ensure your bot name is unique and professional
* **Avoid Common Names**: Don't use generic names like "Vouches" or "Vouch"
* **Character Limits**: Keep names within Discord's character limits
### Authentication Errors
* **Client Secret**: Make sure you copied the client secret immediately after resetting
* **Application ID**: Verify the Application ID matches between Discord and VouchVault
* **Public Key**: Ensure the public key was copied correctly
## Best Practices
### Security
* **Keep Tokens Private**: Never share your bot token publicly
* **Regular Updates**: Periodically reset tokens for security
* **Permission Management**: Only grant necessary permissions
### Naming
* **Professional Names**: Use business-appropriate names
* **Unique Identity**: Make your bot name distinctive
* **Brand Consistency**: Align with your service/business branding
### Server Management
* **Dedicated Channels**: Create specific channels for vouch activities
* **Role Permissions**: Set up appropriate role-based permissions
* **Moderation**: Implement proper moderation for vouch content
## Support Resources
### Getting Help
* **Support Server**: Join our [Discord support server](https://discord.gg/vouchvault)
* **Website**: Visit [vouchvault.cc](https://vouchvault.cc) for additional guides
* **Telegram Group**: Join our [Telegram group](https://t.me/vouchvaultt) for real-time assistance
* **Contact Support**: Reach out through the VouchVault dashboard
[//]: # "### Community"
[//]: # "- **User Forums**: Connect with other VouchVault users"
[//]: # "- **Feature Requests**: Submit suggestions for new features"
[//]: # "- **Best Practices**: Share and learn from community experiences"
***
**Congratulations!** 🎉 You've successfully created and configured your custom Discord bot with VouchVault. Your bot is now ready to automate vouch collection and enhance trust in your Discord community.