Troubleshooting
Common issues and their solutions.
Call Issues
Calls Not Connecting
Possible Causes:
- No phone number provisioned
- Unstable internet connection
- Browser doesn't support WebRTC
- Firewall or network restrictions
Solutions:
- Check that you have an active phone number in Settings → Phone Numbers
- Try manually provisioning a number if auto-provisioning failed
- Use Chrome or Firefox browser (best WebRTC support)
- Check your internet connection speed and stability
- Disable VPN if active, as it may interfere with WebRTC
- Check browser console for error messages (F12 → Console)
Audio Issues (No Sound)
Possible Causes:
- Microphone/speaker permissions not granted
- Wrong audio device selected
- Audio device muted or volume too low
- Browser audio settings
Solutions:
- Check browser permissions: Settings → Privacy → Microphone/Speaker
- Grant permissions when prompted by the browser
- Check your system audio settings and volume levels
- Try a different audio device (headset, speakers, etc.)
- Test your microphone/speakers in another application
- Refresh the page and try again
Call Quality Issues
Possible Causes:
- Slow or unstable internet connection
- High network latency
- Background applications using bandwidth
- WiFi interference
Solutions:
- Use a wired internet connection if possible (more stable than WiFi)
- Close bandwidth-intensive applications (video streaming, downloads, etc.)
- Move closer to your WiFi router or use 5GHz band
- Check your internet speed (recommended: 1 Mbps upload minimum)
- Use a headset to reduce echo and improve audio quality
Contact & Import Issues
Contacts Not Importing
For CSV Imports:
- Ensure your CSV has required columns:
nameandphone_number - Check that phone numbers are in valid format (E.164 recommended: +1234567890)
- Remove any special characters or formatting from phone numbers
- Make sure the CSV file is not corrupted (open it in Excel/LibreOffice first)
- Check the import dialog for specific error messages
For HubSpot Imports:
- Verify your HubSpot connection in Settings → Integrations
- Reconnect if the connection has expired
- Note that only contacts with phone numbers will be imported
- Check that you have the necessary HubSpot permissions
Duplicate Contacts
The system automatically detects duplicates during import, but if you're seeing duplicates:
- Duplicates are detected by phone number or email
- If contacts have different phone numbers but same name, they're treated as separate contacts
- You can manually delete duplicates from the contact list
- Future imports will skip contacts that already exist
Phone Number Issues
Phone Numbers Not Provisioning
Possible Causes:
- Phone number provisioning not enabled for your account
- Insufficient account credits
- Area code not available in your region
- Account limits reached
Solutions:
- Check that phone number provisioning is enabled in your account
- Try a different area code if one is not available
- Manually provision from Settings → Phone Numbers
- Contact support if issues persist - they can check your account configuration
API & Integration Issues
API Key Not Working
Check:
- API key is correctly copied (no extra spaces)
- Authorization header format:
Bearer YOUR_API_KEY - API key hasn't been revoked
- API key has the required permissions for the endpoint
- You're using the correct base URL
HubSpot Connection Issues
Solutions:
- Disconnect and reconnect your HubSpot account
- Verify you have the necessary HubSpot permissions in your HubSpot account
- Check the connection status in Settings → Integrations
- Contact support if the connection continues to fail
System Health
Check your system health status in Settings → System Health for:
- Service status and availability
- Phone number provisioning status
- Integration connection status
- Account configuration status
Still Need Help?
If you've tried the solutions above and are still experiencing issues: