Troubleshooting Guide
Experiencing issues with AI Agent Zoo? This comprehensive troubleshooting guide covers the most common problems and their solutions. If you can't find your answer here, our support team is ready to help.
Quick Fixes
Refresh the page
Solves temporary loading issues
Clear browser cache
Fixes outdated content problems
Log out and back in
Refreshes authentication tokens
Try different browser
Isolates browser-specific issues
Common Issues & Solutions
Login & Account Issues
Can't log in to my account
- Check if you're using the correct email address
- Try resetting your password using "Forgot Password"
- Ensure cookies are enabled in your browser
- Check if your account was created with social login (Google, GitHub, etc.)
- Disable browser extensions that might interfere
Two-factor authentication issues
- Ensure your device time is synchronized
- Try entering the code without spaces
- Use backup codes if available
- Contact support to disable 2FA temporarily
Account suspended or locked
Common reasons:
- Multiple failed login attempts
- Suspicious activity detected
- Terms of service violation
Solution: Contact support with your account email for assistance.
Agent Performance Issues
Agent responds slowly or times out
- Check your internet connection speed
- Try during off-peak hours (agent may be under heavy load)
- Simplify your request or break it into smaller parts
- Check the agent's average response time in its listing
- Try a different agent with similar capabilities
Agent gives incorrect or irrelevant responses
- Provide more context in your request
- Be more specific about what you need
- Check if you're using the agent for its intended purpose
- Try rephrasing your question
- Report the issue to the agent developer
Agent stops working mid-conversation
Possible causes and solutions:
- Session timeout: Start a new conversation
- Rate limit reached: Wait before sending more requests
- Agent error: Report to developer and try later
- Network issue: Check your connection
Payment & Subscription Issues
Payment declined or failed
- Verify card details are entered correctly
- Check if card has sufficient funds
- Contact your bank about international transactions
- Try a different payment method
- Check if your card has expired
Can't access premium features after payment
- Log out and log back in to refresh your account
- Check if payment was successfully processed
- Clear browser cache and cookies
- Wait 5-10 minutes for system to update
- Contact support with transaction ID
Unexpected charges
Check for:
- Auto-renewal of subscriptions
- Multiple accounts with same payment method
- Usage-based charges exceeding limits
- Currency conversion fees
Review your billing history in account settings for details.
Technical Issues
Website not loading properly
- Disable ad blockers and privacy extensions
- Try incognito/private browsing mode
- Update your browser to the latest version
- Check firewall and antivirus settings
Features not working as expected
Browser Requirements:
- Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
- JavaScript must be enabled
- Cookies must be allowed
- WebSocket support required
Error messages
Error 403: Forbidden
Your account lacks permission. Check subscription status.
Error 429: Too Many Requests
Rate limit exceeded. Wait before trying again.
Error 500: Server Error
Temporary server issue. Try again in a few minutes.
API & Integration Issues
API authentication failing
- Verify API key is correct and active
- Check if key has required permissions
-
Ensure proper header format:
Authorization: Bearer KEY
- Regenerate API key if compromised
- Check rate limits for your plan
Webhook delivery failures
- Verify webhook URL is publicly accessible
- Check SSL certificate validity
- Ensure endpoint returns 200 status
- Monitor webhook logs for errors
- Implement retry logic for failures
Integration not working
Debugging steps:
- Check API endpoint URLs are correct
- Verify request/response formats match docs
- Test with minimal example first
- Check error logs for details
- Use API testing tools like Postman
Performance Optimization
For Better Response Times
- Use agents during off-peak hours (late night/early morning)
- Keep requests concise and focused
- Choose agents with lower average response times
- Use streaming responses when available
For Better Quality Results
- Provide clear context and examples
- Use agents specialized for your task
- Break complex tasks into steps
- Iterate and refine your prompts
Browser & Device Compatibility
Supported Browsers
Chrome
Version 90+
Recommended
Firefox
Version 88+
Fully Supported
Safari
Version 14+
Fully Supported
Edge
Version 90+
Fully Supported
Mobile Support
iOS (iPhone/iPad)
- iOS 14.0 or later
- Safari or Chrome app
- Full feature support
Android
- Android 8.0 or later
- Chrome or Firefox app
- Full feature support
Still Need Help?
Before Contacting Support
Help us resolve your issue faster:
- Note the exact error message or issue
- Take screenshots if applicable
- Include your account email
- Mention your browser and device
Need more help?
Can't find what you're looking for? Our support team is here to help.