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 (the deploy pill, top right) 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:
Any paid plan — Lite or Pro — can add extra bot slots at $5/month each. Go to the pricing page in your dashboard to add more. Trial and free accounts 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: