Call Loop
When a contact enters a “call loop,” the system attempts to reach them repeatedly until one of two conditions is met:- The contact answers and has a conversation
- The maximum number of attempts or days is reached
- The web app interface
- The /get-contact API endpoint

Calling Strategies
The auto-dialer offers two strategies for scheduling call retries:1. Smart Calling (Recommended)
Our smart calling strategy dynamically schedules calls at optimal times based on continuous data analysis. Key features:- Maximum 3 calls per contact per day
- Respects dialer window hours
- Configurable maximum duration in days

2. Defined Intervals
This strategy allows manual definition of retry intervals after unsuccessful calls. Let’s look at an example. Suppose we have the following intervals set:
Dialer Windows
Dialer windows define permitted calling hours to ensure contacts are only called during appropriate times.
Timezone Handling
Dialer windows are always interpreted in the contact’s timezone when one is set. If no timezone is specified for a contact, the system defaults to using your account’s timezone shown above the dialer windows. For contacts with specified timezones, here’s how it works:- If your dialer window is set to 9:00 AM - 5:00 PM
- And you have a contact in Los Angeles (PST) and another in New York (EST)
- The Los Angeles contact will be called between 9:00 AM - 5:00 PM PST
- The New York contact will be called between 9:00 AM - 5:00 PM EST
Manual calls triggered via /initiate-call or the
web app bypass dialer window restrictions.
Frequently Asked Questions
When is a contact marked as reached?
A contact is considered reached when they answer and have a conversation. Voicemails, unanswered calls, or connection issues trigger retry attempts.What happens with calling errors?
After two consecutive errors, the call loop ends automatically, regardless of remaining attempts.How do manual calls affect the call loop?
Manual calls are executed immediately. If unsuccessful, the next call follows the defined strategy.What happens when dialer intervals change?
The system dynamically adjusts schedules while maintaining dialer window compliance.How are reached contacts handled?
Manually calling a previously reached contact restarts their call loop.How do maximum attempt changes work?
Changes take immediate effect for active call loops but don’t affect completed ones.What happens when disabling/re-enabling the auto-dialer?
When re-enabled, past-due calls trigger immediately. To prevent this:- Use
/v1/remove-from-auto-dialer
for specific contacts - Adjust maximum intervals to auto-remove contacts