Error Messages
Reference guide for WizChat error messages.
Document Errors
"Document processing failed"
Cause: The document couldn't be processed.
Solutions:
- Verify the file isn't corrupted
- Check file isn't password-protected
- Ensure file format is supported
- Try re-uploading
"File too large"
Cause: File exceeds plan limits.
Solutions:
- Compress the file
- Split into smaller documents
- Upgrade your plan
"Unsupported file type"
Cause: File format not supported.
Supported formats:
- PDF, DOCX, TXT, MD
- XLSX, CSV
- PNG, JPG, WEBP
- MP4, WebM (videos)
"Storage limit reached"
Cause: You've used all available storage.
Solutions:
- Delete unused documents
- Upgrade your plan
- Check storage usage in Settings
Chatbot Errors
"Chatbot not found"
Cause: The chatbot doesn't exist or you don't have access.
Solutions:
- Check the chatbot ID
- Verify you have access
- Contact the owner if shared
"Deployment failed"
Cause: Chatbot couldn't be deployed.
Solutions:
- Check all required settings
- Verify domain configuration
- Review error details
- Try again after a few minutes
"Model unavailable"
Cause: Selected AI model is temporarily unavailable.
Solutions:
- Try a different model
- Wait and retry
- Check WizChat status page
Authentication Errors
"Invalid credentials"
Cause: Email or password is incorrect.
Solutions:
- Double-check your email
- Reset your password
- Try social login if available
"Session expired"
Cause: Your login session has ended.
Solutions:
- Log in again
- Check session timeout settings
- Clear cookies if repeated
"OAuth authorization failed"
Cause: OAuth connection couldn't be established.
Solutions:
- Check popup blocker
- Verify OAuth app credentials
- Re-authorize the connection
- Check third-party service status
Team Errors
"Invitation expired"
Cause: Team invitation has expired (7 days).
Solutions:
- Request a new invitation
- Accept invitations promptly
"Permission denied"
Cause: You don't have permission for this action.
Solutions:
- Contact team admin
- Check your team role
- Request elevated permissions
"Member limit reached"
Cause: Team has maximum members for plan.
Solutions:
- Remove inactive members
- Upgrade your plan
API Errors
"Rate limit exceeded"
Cause: Too many API requests.
Solutions:
- Wait for rate limit reset
- Implement request throttling
- Upgrade for higher limits
"Invalid API key"
Cause: API key is wrong or revoked.
Solutions:
- Check API key is correct
- Generate a new key
- Verify key permissions
"Quota exceeded"
Cause: Monthly query limit reached.
Solutions:
- Wait for billing cycle reset
- Purchase credits
- Upgrade your plan
Integration Errors
"Connection failed"
Cause: Can't connect to external service.
Solutions:
- Check credentials
- Verify service is accessible
- Re-authenticate
- Check firewall settings
"Database connection error"
Cause: PostgreSQL connection failed.
Solutions:
- Verify host and port
- Check credentials
- Ensure database is accessible
- Check SSL settings
"MCP server error"
Cause: MCP server returned an error.
Solutions:
- Check server is running
- Verify server URL
- Review server logs
- Test server manually
Billing Errors
"Payment failed"
Cause: Payment couldn't be processed.
Solutions:
- Update payment method
- Check card details
- Ensure sufficient funds
- Contact your bank
"Subscription update failed"
Cause: Plan change couldn't be processed.
Solutions:
- Retry the change
- Check payment method
- Contact support
Network Errors
"Network error"
Cause: Connection to WizChat failed.
Solutions:
- Check internet connection
- Try a different network
- Disable VPN if active
- Check firewall settings
"Request timeout"
Cause: Request took too long.
Solutions:
- Try again
- Check internet speed
- Try a simpler request
- Contact support if persistent
Getting Help
If you can't resolve an error:
- Note the exact error message
- Capture the steps to reproduce
- Check Common Issues
- Contact support@wizchat.com with details