Cordiul Docs

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:

  1. Check that you have an active phone number in Settings → Phone Numbers
  2. Try manually provisioning a number if auto-provisioning failed
  3. Use Chrome or Firefox browser (best WebRTC support)
  4. Check your internet connection speed and stability
  5. Disable VPN if active, as it may interfere with WebRTC
  6. 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:

  1. Check browser permissions: Settings → Privacy → Microphone/Speaker
  2. Grant permissions when prompted by the browser
  3. Check your system audio settings and volume levels
  4. Try a different audio device (headset, speakers, etc.)
  5. Test your microphone/speakers in another application
  6. 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:

  1. Use a wired internet connection if possible (more stable than WiFi)
  2. Close bandwidth-intensive applications (video streaming, downloads, etc.)
  3. Move closer to your WiFi router or use 5GHz band
  4. Check your internet speed (recommended: 1 Mbps upload minimum)
  5. Use a headset to reduce echo and improve audio quality

Contact & Import Issues

Contacts Not Importing

For CSV Imports:

  1. Ensure your CSV has required columns: name and phone_number
  2. Check that phone numbers are in valid format (E.164 recommended: +1234567890)
  3. Remove any special characters or formatting from phone numbers
  4. Make sure the CSV file is not corrupted (open it in Excel/LibreOffice first)
  5. Check the import dialog for specific error messages

For HubSpot Imports:

  1. Verify your HubSpot connection in Settings → Integrations
  2. Reconnect if the connection has expired
  3. Note that only contacts with phone numbers will be imported
  4. Check that you have the necessary HubSpot permissions
Duplicate Contacts

The system automatically detects duplicates during import, but if you're seeing duplicates:

  1. Duplicates are detected by phone number or email
  2. If contacts have different phone numbers but same name, they're treated as separate contacts
  3. You can manually delete duplicates from the contact list
  4. 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:

  1. Check that phone number provisioning is enabled in your account
  2. Try a different area code if one is not available
  3. Manually provision from Settings → Phone Numbers
  4. Contact support if issues persist - they can check your account configuration

API & Integration Issues

API Key Not Working

Check:

  1. API key is correctly copied (no extra spaces)
  2. Authorization header format: Bearer YOUR_API_KEY
  3. API key hasn't been revoked
  4. API key has the required permissions for the endpoint
  5. You're using the correct base URL
HubSpot Connection Issues

Solutions:

  1. Disconnect and reconnect your HubSpot account
  2. Verify you have the necessary HubSpot permissions in your HubSpot account
  3. Check the connection status in Settings → Integrations
  4. Contact support if the connection continues to fail

System Health

Still Need Help?

If you've tried the solutions above and are still experiencing issues: