Quick fixes for frequently encountered problems.
Call Issues#
Calls Not Connecting#
Symptoms: Calls fail to connect, "no route" errors
Solutions:
- Check phone number format (include country code)
- Verify telephony provider credentials
- Check if number is DND registered
- Ensure agent is active
Agent Not Responding#
Symptoms: Call connects but agent is silent
Solutions:
- Check LLM provider API key
- Verify agent has a system prompt
- Check for provider outages
- Review error logs in Call History
Poor Audio Quality#
Symptoms: Static, choppy audio, echoes
Solutions:
- Check network connectivity
- Switch TTS provider
- Reduce background noise
- Check caller's connection
Configuration Issues#
Variables Not Working#
Symptoms: {{variable}} shows as literal text
Solutions:
- Check variable name matches CSV column
- Use exact case (variables are case-sensitive)
- Ensure no extra spaces in variable names
Knowledge Base Not Found#
Symptoms: Agent says "I don't have that information"
Solutions:
- Check KB is attached to agent
- Verify documents processed successfully
- Lower minScore threshold
- Check document content quality
Dashboard Issues#
Page Not Loading#
Solutions:
- Clear browser cache
- Try incognito/private mode
- Check browser console for errors
- Try different browser
Changes Not Saving#
Solutions:
- Check internet connection
- Verify you have edit permissions
- Wait and retry
- Contact support if persists
Quick Diagnostic#
Run through this checklist:
- Agent is active
- Phone number assigned
- Provider API keys valid
- Sufficient credit balance
- System prompt configured
- No provider outages