Troubleshooting
Campaign Issues
Solve common campaign issues and optimize performance
On this page
Quick solutions for common campaign problems and performance optimization tips.
Campaign Won't Start
Phone Number Not Configured
Error: "Your agent does not have a phone number setup"
Solution:
- Go to your Assistant Settings
- Configure a phone number (Platform number, SIP, or Caller ID)
- Save assistant settings
- Try starting campaign again
Insufficient Balance
Error: "Insufficient balance to start the campaign"
Solution:
- Check your account balance in billing section
- Add funds to your account
- Return to campaign and click start
No Leads to Call
Error: "No leads to call"
Solution:
- Add leads manually or import from CSV
- Verify leads have valid phone numbers
- Check that leads aren't all marked as completed
- Ensure "Mark complete when no leads" setting matches your needs
No Calls / Messages Being Sent
Outside Allowed Hours / Schedule Windows
Issue: Campaign shows as running but nothing is dialing or sending
Check:
- Current time is inside at least one schedule window (or legacy start/end)
- Overnight windows: if end is earlier than start (e.g. 16:00→02:00), midday is outside the window
- Today is an allowed day
- Campaign timezone matches the schedule you expect
Solution: Adjust schedule windows or wait until the next allowed interval
WhatsApp Campaign Not Sending
Check:
- Sender and template are still approved and owned by your account
- Chat credits / balance are sufficient
- Template variable mapping has values for every lead (blank mapped values block sends)
- You have not hit the user-wide pool of 10 in-flight WhatsApp campaign sends (multiple WhatsApp campaigns share this pool)
Solution: Top up chat credits, fix mapping, or wait for in-flight sends to finish
SMS Campaign Won't Start
SMS campaigns may be temporarily disabled on the platform. If start fails with an unavailable-channel message, use WhatsApp or call campaigns until SMS is re-enabled.
All Leads Called
Issue: Campaign appears idle
Check:
- All primary leads have been attempted maximum times
- Secondary contacts have been tried
- Goal completion status if using goal-based retry
Solution: Add more leads or review retry settings
Call Quality Issues
High Failure Rate
Symptoms: Many calls marked as "Failed"
Common causes:
- Invalid phone numbers in lead list
- Network connectivity issues
- Carrier restrictions
Solutions:
- Clean lead data: Remove invalid numbers
- Test single calls: Try calling individual leads manually
- Check number format: Ensure proper formatting (+1234567890)
- Contact support: For persistent technical issues
Low Answer Rate
Symptoms: Most calls go to voicemail or unanswered
Optimization:
- Adjust calling hours: Try different time windows
- Review retry interval: Space out attempts more
- Check lead quality: Verify numbers are current
- Caller ID setup: Ensure professional caller ID display
Retry Logic Problems
Too Many Retries
Issue: Leads complaining about excessive calls
Solutions:
- Reduce max retries: Lower from 5 to 2-3 attempts
- Increase retry interval: Space calls 2-4 hours apart
- Disable voicemail retry: Accept voicemail as contact
- Review goal variables: Ensure proper completion tracking
Not Enough Retries
Issue: Missing potential contacts with limited attempts
Solutions:
- Increase max retries: Up to 5 attempts
- Enable voicemail retry: Continue until human contact
- Adjust retry interval: Try different times of day
- Use goal-based retry: For high-value prospects
Goal Completion Issues
Goal Variable Not Working
Issue: Retry until goal completed not functioning
Requirements:
- Post-call variables must be configured in assistant
- Boolean variable must exist in post-call schema
- Variable name must match exactly in campaign settings
- AI extraction must be working properly
Solution: Test assistant's post-call variable extraction with manual calls
False Goal Completion
Issue: Leads marked complete incorrectly
Debugging:
- Review call transcripts for AI extraction errors
- Test variable definitions with sample calls
- Adjust AI prompt for clearer goal criteria
- Refine variable descriptions in assistant settings
Performance Optimization
Slow Campaign Progress
Causes:
- Conservative retry intervals
- Limited allowed calling hours
- High failure rate reducing available leads
Solutions:
- Parallel processing: Create multiple smaller campaigns
- Optimize timing: Use peak answer hours
- Clean data: Remove problematic numbers
- Increase calling window: Extend allowed hours
System Resource Issues
Symptoms: Delayed calls, processing bottlenecks
Solutions:
- Reduce concurrent campaigns: Limit active campaigns
- Stagger campaign starts: Don't start multiple campaigns simultaneously
- Contact support: For platform performance issues
Lead Management Issues
Duplicate Contacts
Issue: Same person called multiple times from different leads
Prevention:
- Data cleanup: Remove duplicates before import
- Phone number validation: Check for format variations
- Lead deduplication: Use tools to identify duplicates
Secondary Contact Confusion
Issue: Unclear which contact was reached
Solution:
- Clear naming: Use descriptive names for secondary contacts
- Call notes: Review transcripts to identify who answered
- Lead organization: Group related contacts properly
Common Error Messages
"Campaign is already in progress"
Solution: Campaign is already running. Pause it first to make changes.
"Campaign is not running"
Solution: Campaign is paused or stopped. Start it to resume calling.
"Assistant timezone not set"
Solution: Configure timezone in assistant settings before creating campaign.
Getting Help
Before Contacting Support
- Check error messages for specific guidance
- Review campaign settings for obvious issues
- Test with single lead to isolate problems
- Check account status and billing
Information to Provide
- Campaign ID and name
- Error messages received
- Steps taken before issue occurred
- Expected vs actual behavior
- Assistant and phone number configuration
Campaign delays: Allow 10-15 minutes after starting before expecting calls to begin. The system needs time to initialize and queue leads.
For additional help with campaign optimization, see Campaign Best Practices.
Related guides
Troubleshooting
AI Behavior Issues
Troubleshoot and optimize your AI assistant's conversation behavior and responses
Read guide →Troubleshooting
Billing & Credits
Troubleshoot billing issues, understand charges, and learn about refund policies and usage tracking
Read guide →Troubleshooting
Cal.com Issues
Troubleshoot common Cal.com integration issues
Read guide →Troubleshooting
Calendly Issues
Troubleshoot common Calendly integration issues
Read guide →