Error Messages
Detailed error explanations and solutions
This guide provides detailed explanations of error messages you may encounter in Ayra, including their causes and specific solutions. Error messages are organized by category for easy reference.
1. Authentication Errors
Error: "Invalid email or password"
Meaning: The email address or password you entered doesn't match our records.
Common Causes:
- Typo in email or password
- Wrong account (multiple accounts)
- Password recently changed but using old password
- Caps Lock enabled
Solutions:
- Verify Email: Check for typos, extra spaces, or incorrect domain
- Check Password: Ensure Caps Lock is off, try copying/pasting password
- Reset Password:
- Click "Forgot Password" on login page
- Enter your email address
- Check inbox (and spam) for reset link
- Click link and create new password
- Try logging in again
- Check Account: If you have multiple accounts, ensure you're using the correct email
Error: "Account temporarily locked due to multiple failed login attempts"
Meaning: After 5 failed login attempts within 15 minutes, accounts are temporarily locked for security.
Duration: 30 minutes
Solutions:
- Wait 30 Minutes: Lock automatically expires after 30 minutes
- Reset Password: If you forgot password, reset it instead of waiting (unlocks account immediately)
- Contact Support: For urgent access, email support@ayra.ai with account email and reason
Error: "API key invalid or revoked"
Meaning: The API key used in your request is not valid.
Causes:
- Key was deleted or revoked
- Typo in API key
- Using test key in production (or vice versa)
- Key doesn't have required permissions
Solutions:
- Verify API Key: Copy key from Settings → API Keys, ensure no extra spaces
- Check Key Status: Verify key shows "Active" (not "Revoked")
- Create New Key: Settings → API Keys → Create API Key, copy immediately, update your application
- Check Permissions: View key permissions, create new key with required permissions if needed
2. Voice Agent Errors
Error: "Voice platform connection failed"
Meaning: Cannot connect to Vapi or Retell to process voice calls.
Impact: Agent cannot receive calls until resolved.
Solutions:
- Check Integration Status: Integrations → Voice AI Platforms, status should show "Connected" (green)
- Reconnect Voice Platform: Click "Reconnect", enter valid API key, click "Verify Connection"
- Verify API Key: Log into Vapi or Retell dashboard, confirm API key is active
- Check Voice Platform Status: Visit status.vapi.ai or Retell status page
- Test Connection: After reconnecting, call your agent's phone number
Error: "Phone number provisioning failed"
Meaning: Could not assign phone number to your agent.
Causes:
- Requested area code unavailable
- Number already in use
- Account limits reached
- Billing issue preventing provisioning
Solutions:
- Try Different Area Code: Agents → Phone Number → Change Area Code
- Check Account Limits: Verify you haven't exceeded plan limits
- Verify Billing: Settings → Billing → Payment Methods, ensure valid payment method
- Port Existing Number: If you want specific number, use Port Number feature (3-5 business days)
3. Integration Errors
Error: "Calendar sync failed: Permission denied"
Meaning: Ayra doesn't have permission to access your calendar.
Solutions:
- Grant Permissions: Integrations → Calendar → Reconnect, check all permission boxes
- Check Google Calendar Permissions: calendar.google.com → Settings → Share with specific people → Find Ayra
- Check Microsoft Outlook Permissions: outlook.office.com → Settings → Privacy and data → Apps
- Admin Consent (Enterprise): Contact IT department if in organization with IT policies
Error: "CRM API rate limit exceeded"
Meaning: You've made too many API requests to your CRM in a short time period.
Rate Limits:
- HubSpot: 100 requests per 10 seconds
- Salesforce: Varies by license (typically 15,000-100,000 per 24 hours)
- Pipedrive: 10,000 requests per day
Solutions:
- Temporary Solution - Wait: Rate limits reset after time period
- Enable Request Batching: Integrations → CRM → Advanced Settings → Enable "Batch API requests"
- Reduce Request Frequency: Review workflows, consolidate updates
- Upgrade CRM Plan: Higher tiers often have higher rate limits
- Distribute Load: Spread operations over time instead of all at once
6. API Errors
Error: "401 Unauthorized"
HTTP Status: 401
Meaning: API request is missing or has invalid authentication.
Solutions:
- Include Authorization Header: Ensure request includes "Authorization: Bearer sk_live_your_api_key_here"
- Check API Key: Verify API key is correct (no typos), ensure using live key for production
- Regenerate API Key: Settings → API Keys → Revoke old key → Create new key → Update all applications
Error: "429 Too Many Requests"
HTTP Status: 429
Meaning: You've exceeded API rate limits.
Rate Limits:
- Free: 100 requests/minute
- Professional: 500 requests/minute
- Business: 1,000 requests/minute
- Enterprise: Custom
Solutions:
- Implement Rate Limiting: Add delay between requests in your code
- Use Pagination: Don't request all data at once, fetch in pages
- Cache Responses: Don't fetch same data repeatedly
- Upgrade Plan: If legitimately need higher rate limits
- Respect Retry-After Header: Wait for specified time before retrying
7. Getting Help
Error Not Listed Here?
- Search Documentation: docs.ayra.ai - Search for error code or message
- Check Common Issues Guide: Troubleshooting → Common Issues
- Contact Support: Email support@ayra.ai with:
- Full error message
- Error code
- Steps that caused error
- Screenshots if applicable
- Request ID (if API error)
Critical Errors
For service-affecting errors, call support (available 24/7 for critical issues). Average response: <1 hour.
Last Updated: January 5, 2025
Error messages are continuously updated as the platform evolves. Check this guide regularly for new error codes and solutions.
Ready to transform your agency?
Start building with Ayra today. No credit card required.