Scheduling & Retry Logic

Control when calls are made, how failures are handled, and how calls are distributed across multiple phone numbers.

Schedule campaigns: Open the Campaigns page to schedule campaigns and configure retry settings.

Campaign Scheduling

Immediate vs Scheduled Start

Scheduling a Campaign

1. Create campaign in DRAFT status
2. Click Schedule button
3. Select date and time (must be in future)
4. Campaign status changes to SCHEDULED

The campaign will automatically start at the scheduled time.

Unscheduling

To cancel a scheduled campaign:

1. Find the campaign with SCHEDULED status
2. Click Cancel Schedule (or Unschedule)
3. Campaign returns to DRAFT status
4. Modify settings or schedule for different time

Time Windows

Restrict calls to specific hours:

┌──────────────────────────────────────────────────────┐
│                   Call Time Window                    │
├──────────────────────────────────────────────────────┤
│                                                       │
│   00:00 ─────── 09:00 ═══════════ 18:00 ───── 23:59  │
│   ░░░░░░░░░░░░░ █████████████████ ░░░░░░░░░░░░░░░░░░ │
│   (blocked)     (allowed)         (blocked)          │
│                                                       │
│   Campaign pauses outside window, resumes next day    │
│                                                       │
└──────────────────────────────────────────────────────┘

Configuration

Behavior

• Calls only start within the time window
• Active calls complete even if window ends
• Campaign automatically pauses outside window
• Resumes on next valid day/time

Retry Logic

Configure how failed calls are retried.

Retryable Outcomes

Retry Configuration

Retry Timing

Default escalating delays:

Custom delays can be configured per campaign.

Retry Flow

┌─────────────────────────────────────────────────────┐
│                    Retry Flow                        │
├─────────────────────────────────────────────────────┤
│                                                      │
│   Make Call ──► Connected? ──► Yes ──► Mark Success  │
│       │                                              │
│       └──► No ──► Retryable? ──► No ──► Mark Failed  │
│                        │                             │
│                        └──► Yes ──► Attempts Left?   │
│                                          │           │
│                                    No ───┼──► Mark Failed
│                                          │           │
│                                    Yes ──┴──► Queue for Retry
│                                                 │    │
│                                                 ▼    │
│                                          Wait Delay  │
│                                                 │    │
│                                                 └────┘
│                                                      │
└─────────────────────────────────────────────────────┘

Multi-Phone Distribution

Use multiple phone numbers to increase throughput and avoid rate limiting.

Distribution Strategies

Round Robin

Numbers: [A, B, C]
Call 1 → A
Call 2 → B
Call 3 → C
Call 4 → A
Call 5 → B
...

Least Used

Active calls: A=2, B=1, C=3
Next call → B (lowest active count)

Per-Credential Rate Limiting

Each phone number has its own rate limit:

With 3 numbers:

• Total rate: 30 calls/minute
• Total parallel: 15 simultaneous calls

Concurrency Control

Settings

Campaign Size Guidelines

Note: Actual time depends on call duration, answer rates, and retries.

Auto-Pause on Low Credits

Campaigns automatically pause when workspace credits run low:

How It Works

1. System monitors credit balance during campaign
2. When balance falls below threshold, campaign pauses
3. Email notification sent to workspace owner
4. Campaign status: PAUSED
5. Pending calls preserved (not lost)

After Adding Credits

1. Navigate to paused campaign
2. Click Resume
3. Calls continue from where they stopped

Configuration

Credit threshold is workspace-level:

• Default: Pause when credits would go negative
• Custom thresholds available on request

Stuck Call Recovery

Calls that exceed maximum duration are automatically failed:

Why Calls Get Stuck

• Network disconnection during call
• Server crash
• Telephony provider issues

Recovery Behavior

1. System detects call running > 5 minutes
2. Call marked as failed
3. Added to retry queue (if retries remaining)
4. Logged with reason: "timeout"

Best Practices

Timing

1. Business hours: Call 9 AM - 6 PM local time
2. Weekday preference: Avoid weekends for B2B
3. Regional timing: Consider recipient timezones
4. Avoid holidays: Skip major holidays

Retries

1. 3 attempts is sufficient: More may annoy recipients
2. Increasing delays: Don't rapid-fire retries
3. Business hours only: Retry within calling window
4. Skip voicemail: Consider not retrying voicemail

Concurrency

1. Start low: Begin with 5 parallel calls
2. Monitor quality: Check call completion rates
3. Scale gradually: Increase if system handles it
4. Use multiple numbers: Distribute load

Multi-Number

1. Similar numbers: Use numbers from same region
2. Rotate evenly: Prevent single number exhaustion
3. Monitor per-number: Watch for blocked numbers
4. Backup numbers: Have extras ready

Troubleshooting

Campaign Won't Start

• Check credit balance
• Verify at least one phone number selected
• Ensure contacts uploaded
• Check time window (may be outside)

Low Answer Rate

• Try different time windows
• Use local phone numbers
• Check if numbers are DND registered
• Review caller ID display

Slow Progress

• Increase parallel calls
• Add more phone numbers
• Check rate limits
• Review retry settings

Calls Failing Repeatedly

• Verify phone number format
• Check telephony provider status
• Review error messages in call logs
• Reduce concurrency if overloaded

Next Steps

• Creating a Campaign - Full campaign setup guide
• Campaign Analytics - Monitor campaign progress
• Phone Numbers Setup - Configure calling credentials

Ready to schedule a campaign? Open the Campaigns page to get started.