Skip to main content

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:
  1. Navigate to Batches
  2. Click on your batch campaign
  3. View real-time statistics and call list
  4. Filter calls by status
  5. 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