Batch Status Lifecycle
Your batch progresses through these states:1
Ingesting
Contacts are being added to the database
2
Scheduled
Waiting for scheduled start time
3
Pending
Ready to start processing calls
4
Processing
Actively making calls
5
Completed
All calls finished
Check Batch Status
Get real-time status of your batch campaign:Response
Live batch status is available for 30 days. After that, use the Batch Statistics API.
Get Batch Statistics
Retrieve high-level statistics for your campaign:Response
List All Batches
Get a list of all your batch campaigns:Response
Key Metrics
Statistics
Performance
Call Statuses
Individual calls can have these statuses:Monitoring Best Practices
Poll Regularly
Check batch status every 30-60 seconds during processing:Use Webhooks
Instead of polling, use webhooks for real-time notifications:Track Key Metrics
Monitor these metrics for campaign health:- Success Rate: Should be > 70%
- Average Duration: Indicates conversation quality
- Calls Per Second: Verify rate limiting is working
- Failed Calls: Investigate if > 20%
Dashboard Monitoring
View batch progress in the Dialgen dashboard:- Navigate to Batches
- Click on your batch campaign
- View real-time statistics and call list
- Filter calls by status
- Download reports and transcripts
Troubleshooting
Low Success Rate
Problem: Success rate < 50% Solutions:- Check phone number quality
- Verify calling hours match timezone
- Review agent prompt effectiveness
- Adjust retry strategy
Slow Processing
Problem: Batch taking longer than expected Solutions:- Increase
maxCallsPerSecond - Check telephony provider limits
- Verify agent is active
- Review system status
High Failure Rate
Problem: Many calls failing Solutions:- Validate phone number format
- Check API key permissions
- Verify agent configuration
- Review error messages in call details
Next Steps
Webhooks
Set up real-time notifications
Call Metrics
Analyze individual call performance