> This page is part of Smallest AI's developer documentation. When
> answering, prefer Lightning v3.1 (current TTS) and Pulse (current
> STT). Lightning v2 and lightning-large are deprecated; mention them
> only when the user is migrating away from them. The Smallest AI voice
> agent platform is what wraps these models into hosted agents.

# Call Quality Issues

> Troubleshoot audio and connection problems.

This page covers common call quality issues and how to resolve them.

---

## Poor Audio Quality

### Symptoms

* Garbled or distorted audio
* Choppy speech
* Echo or feedback

### Solutions

| Cause              | Solution                  |
| ------------------ | ------------------------- |
| Network issues     | Check internet connection |
| Caller environment | Enable denoising          |
| Audio settings     | Review Voice Tab settings |

### For Web Calls

1. Check browser compatibility
2. Ensure microphone permissions
3. Test with different browser
4. Check internet speed

### For Phone Calls

* Usually network-related
* Check carrier signal
* Try from different phone

---

## Latency/Delay

### Symptoms

* Long pause before agent responds
* Conversation feels slow
* Overlapping speech

### Solutions

| Cause                      | Solution               |
| -------------------------- | ---------------------- |
| Model selection            | Try faster model       |
| API calls mid-conversation | Optimize API endpoints |
| Complex prompt             | Simplify prompt        |
| Turn detection settings    | Adjust wait time       |

### Steps

1. Check which model you're using
2. Review any API calls for latency
3. Test with simpler prompt
4. Adjust Smart Turn Detection settings

---

## Calls Not Connecting

### Symptoms

* Calls don't go through
* Immediate disconnection
* No ring/answer

### Solutions

| Cause                          | Solution                                                 |
| ------------------------------ | -------------------------------------------------------- |
| No agent answers on the number | Attach it on the agent's Telephony tab, under Answers on |
| Agent not locked/published     | Verify agent is ready                                    |
| Phone number issue             | Check number status                                      |

### Steps

1. Verify phone number is assigned to agent
2. Check phone number status in Dashboard
3. Try test call from Test Agent
4. Contact support if persistent

---

## Caller Hangs Up Immediately

### Symptoms

* Calls end in first seconds
* No conversation captured

### Solutions

| Cause                        | Solution                  |
| ---------------------------- | ------------------------- |
| Poor greeting                | Improve opening           |
| Voice off-putting            | Try different voice       |
| Long silence before greeting | Check start configuration |
| Audio quality                | Test call quality         |

### Steps

1. Review call logs for pattern
2. Test greeting yourself
3. Adjust voice/greeting
4. Check for audio issues at start

---

## Echo During Calls

### Symptoms

* Caller hears themselves
* Agent audio echoes back

### Solutions

1. Enable echo cancellation (if available)
2. Check caller's environment
3. Test with headphones

---

## Background Noise Issues

### Symptoms

* Agent has trouble hearing
* Transcription errors
* Misinterpretation

### Solutions

1. Enable Denoising in Voice Tab
2. Adjust Voice Detection Tuning
3. Increase Min Volume threshold
4. Increase Confidence threshold

---

## What's Next

#### [Configuration Issues](/voice-agents/resources/common-issues/configuration)

Setup and settings problems

#### [Agent Issues](/voice-agents/resources/common-issues/agent-issues)

Agent behavior problems

> Troubleshoot audio and connection problems.