Troubleshooting Common Issues
Solutions to common problems and error messages you might encounter.
Before Troubleshooting
Try these quick fixes first:
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:
- Wait 1-2 minutes - bots can take time to fully start
- Check if Privileged Gateway Intents are enabled on Discord
- Verify your trial or subscription is still active
- Try redeploying the bot
- Check bot logs for error messages
Deployment Stuck or Hanging
Deployment process doesn't complete.
Solutions:
- Wait up to 2 minutes for deployment to complete
- Refresh the page and check bot status
- Cancel and try deploying again
- Contact support if 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
- Try rephrasing your request
Out of AI Credits
Can't generate new behaviors because you've used all your credits.
Options:
- Use Builders instead (they don't use credits)
- Purchase top-up credits that never expire
- Wait until next month for monthly credits to reset
- 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 7-day trial ended and your bot is no longer running.
Solution:
Upgrade to 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:
Pro users can add extra bot slots for $5/month each. Go to the pricing page in your dashboard to add more bots.
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
- Try authorizing 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 covered here or the solutions didn't work, we're here to help.