Troubleshooting Common Issues
Solutions to common problems and error messages you might encounter.
Quick fixes
Deployment Issues
Deployment Failed: Invalid Token
Your Discord bot token is not valid or has been regenerated.
Solutions:
- Verify you copied the entire token without extra spaces
- Make sure you're using the Bot token, not the Client Secret
- Check if you accidentally regenerated the token on Discord
- Get a new token from Discord Developer Portal and try again
Bot Shows Offline After Deploy
The bot deployed successfully but appears offline.
Solutions:
- Give it a minute to connect. If it's still offline after a few minutes, check the bot logs
- Enable both privileged gateway intents (Server Members and Message Content) on Discord
- Verify your trial or subscription is still active
- Redeploy the bot
- Check bot logs for error messages
"This integration requires a code grant"
Discord blocks the invite because Requires OAuth2 Code Grantis enabled on your bot's application. It's an advanced OAuth setting a normal bot never needs — it forces a full authorization flow that a standard bot invite doesn't use, so Discord rejects the add.
Fix it in the Discord Developer Portal:
- Open your application and go to the Bot tab
- Turn off "Requires OAuth2 Code Grant" and save
- Re-invite the bot using the invite link from your VibeBot dashboard
Deployment Stuck or Hanging
A deploy doesn't finish.
Solutions:
- A deploy can take up to 15 minutes before it times out. Most finish in under a minute
- If it's still stuck at 15 minutes, the deploy fails with a timeout message
- Refresh the page and check bot status
- Cancel and deploy again
- Contact support if the issue persists
Bot Behavior Issues
Bot Not Responding to Commands
Your bot is online but doesn't respond when users run commands.
Check these:
- Is the behavior enabled? Check the toggle in your dashboard
- Does the bot have permission to read messages in that channel?
- Is Message Content Intent enabled on Discord Developer Portal?
- For slash commands: Did you wait for them to register? (can take 1 hour)
- Are you using the correct command syntax?
- Check bot logs for permission errors
Bot Can't Add/Remove Roles
Bot can't manage roles or gives permission errors.
Solutions:
- Bot's role must be higher than the role it's managing
- Bot needs "Manage Roles" permission
- Check Server Settings → Roles and move bot's role higher
- Ensure the role to manage is not @everyone
Bot Can't Send Messages
Bot appears online but doesn't send messages.
Check permissions:
- Bot needs "Send Messages" permission in the channel
- Bot needs "View Channel" permission
- For embeds: Bot needs "Embed Links" permission
- Check channel-specific permission overrides
Reaction Roles Not Working
Users react but don't receive roles.
Solutions:
- Verify bot has "Manage Roles" permission
- Bot's role must be higher than the role being assigned
- Check that the correct message ID is configured
- Make sure the emoji matches exactly (including custom emojis)
- Re-deploy after making configuration changes
AI Chat Issues
AI Generated Wrong Behavior
The AI didn't understand what you wanted or created something incorrect.
Tips for better results:
- Be more specific in your prompt
- Include channel names with # and role names with @
- Mention exact actions you want the bot to take
- Rephrase your request
Out of AI Credits
Can't generate new behaviors because you've used all your credits.
Options:
- Use Templates instead (they don't use credits)
- Purchase top-up credits that never expire
- On Pro, wait until next month for your monthly credits to reset (Lite credits are one-time — use top-ups instead)
- Edit existing AI-generated behaviors instead of creating new ones
Can't Reference Channels/Roles
AI doesn't recognize #channel or @role references.
Solution:
You must connect your Discord server first. Go to your bot configuration and click "Connect Server" before using AI Chat with channel/role references.
Account & Billing Issues
Trial Expired - Bot Stopped
Your 3-day trial ended and your bot is no longer running.
Solution:
Upgrade to Lite ($5/month) or Pro ($10/month) to keep your bot running. Your bot configuration is saved and will resume immediately after upgrading.
Payment Failed
Your subscription payment was declined.
Steps:
- Check your payment method in dashboard settings
- Update your credit card if it expired
- Contact your bank if card was declined
- Reach out to support if issue persists
Can't Create More Bots
Reached your bot limit for current plan.
Solution:
Only Pro can add extra bot slots, at $5/month each. Go to the pricing page in your dashboard to add more. Lite and Trial are limited to 1 bot.
Connection Issues
Can't Connect Discord Server
Error when trying to connect your Discord server.
Check:
- You have "Manage Server" permissions in Discord
- You're logged in to the correct Discord account
- Authorize again
- Clear browser cache and cookies
Bot Disconnects Randomly
Bot goes offline unexpectedly.
Causes:
- Discord API issues (temporary, usually resolves automatically)
- Bot token was regenerated on Discord
- Subscription payment failed
- Check bot logs and status page for details
Still Need Help?
If your issue isn't listed or the solutions didn't work: