Common Issues

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