Create Custom Discord Bot

​

Prerequisites

Before starting, ensure you have:

• A VouchVault account at 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 and sign into your account

2. Go to Bot Settings

• Visit the Bot Settings page
• 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
• 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

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

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

​

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

​

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
• Website: Visit vouchvault.cc for additional guides
• Telegram Group: Join our Telegram group for real-time assistance
• Contact Support: Reach out through the VouchVault dashboard

---

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.