Common Issues

Quick fixes for common problems

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