# Common Issues

> Quick fixes for common problems

Source: https://edesy.in/docs/voice-agent/troubleshooting

Quick fixes for frequently encountered problems.

## Call Issues

### Calls Not Connecting

**Symptoms:** Calls fail to connect, "no route" errors

**Solutions:**
1. Check phone number format (include country code)
2. Verify telephony provider credentials
3. Check if number is DND registered
4. Ensure agent is active

### Agent Not Responding

**Symptoms:** Call connects but agent is silent

**Solutions:**
1. Check LLM provider API key
2. Verify agent has a system prompt
3. Check for provider outages
4. Review error logs in Call History

### Poor Audio Quality

**Symptoms:** Static, choppy audio, echoes

**Solutions:**
1. Check network connectivity
2. Switch TTS provider
3. Reduce background noise
4. Check caller's connection

## Configuration Issues

### Variables Not Working

**Symptoms:** `{{variable}}` shows as literal text

**Solutions:**
1. Check variable name matches CSV column
2. Use exact case (variables are case-sensitive)
3. Ensure no extra spaces in variable names

### Knowledge Base Not Found

**Symptoms:** Agent says "I don't have that information"

**Solutions:**
1. Check KB is attached to agent
2. Verify documents processed successfully
3. Lower minScore threshold
4. Check document content quality

## Dashboard Issues

### Page Not Loading

**Solutions:**
1. Clear browser cache
2. Try incognito/private mode
3. Check browser console for errors
4. Try different browser

### Changes Not Saving

**Solutions:**
1. Check internet connection
2. Verify you have edit permissions
3. Wait and retry
4. Contact support if persists

## Quick Diagnostic

Run through this checklist:

1. Agent is active
2. Phone number assigned
3. Provider API keys valid
4. Sufficient credit balance
5. System prompt configured
6. No provider outages
