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

  1. Log out and log back in to refresh your account
  2. Check if payment was successfully processed
  3. Clear browser cache and cookies
  4. Wait 5-10 minutes for system to update
  5. 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:

  1. Check API endpoint URLs are correct
  2. Verify request/response formats match docs
  3. Test with minimal example first
  4. Check error logs for details
  5. 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.