Skip to Content
DocsSettingsCalling Window

Calling Window

The calling window defines when BuildVoiceAI is allowed to place scheduled and automated outbound calls. Calls will only execute during the hours you configure, preventing calls from going out late at night or on days you do not operate. Configure this under Settings → Calling Window.

Calling window settings showing timezone selector and daily hour configuration

Setting Your Timezone

Select the timezone your agency operates in. All calling window hours are interpreted in this timezone. If your clients are in different timezones, the calling window still uses the agency timezone as the reference.

💡

If you serve clients across multiple timezones, set the calling window to cover the broadest acceptable range. For example, if you have clients on both US coasts, you might set 9 AM to 8 PM Eastern to cover 6 AM to 5 PM Pacific.

Configuring Operating Hours

For each day of the week, you can set:

  • Start time — The earliest time calls can go out
  • End time — The latest time a call can be initiated
  • Enabled/Disabled — Toggle the day on or off entirely
Weekly schedule grid showing start and end times for each day
Set different hours for each day or disable weekends entirely

Typical Configurations

Standard business hours:

  • Monday through Friday: 9:00 AM - 5:00 PM
  • Saturday and Sunday: Disabled

Extended hours:

  • Monday through Friday: 8:00 AM - 8:00 PM
  • Saturday: 10:00 AM - 2:00 PM
  • Sunday: Disabled

24/7 operation:

  • All days: 12:00 AM - 11:59 PM

What the Calling Window Affects

Scheduled Calls

Calls scheduled via the dashboard or API respect the calling window. If a call is scheduled for a time outside the window, it will be held and executed at the start of the next available window.

For example, if your window ends at 5 PM and a call is scheduled for 6 PM, it will be placed at 9 AM the next business day (assuming a 9 AM start).

Workflow-Triggered Calls

Calls initiated by workflow actions (such as a follow-up call after a form submission) also respect the calling window. The call is queued and placed when the window opens.

Inbound Calls

The calling window does not affect inbound calls. Your agents will answer incoming calls at any time, regardless of the calling window setting. The window only controls outbound call initiation.

If you need to block inbound calls outside business hours, configure that at the provider level (Retell, Vapi, or Bland) or at the phone number level.

Weekend Settings

To disable calls on weekends, toggle Saturday and Sunday off. When a day is disabled:

  • No scheduled calls will go out on that day
  • Queued calls will wait until the next enabled day
  • Inbound calls are still received

Saving and Applying Changes

Changes to the calling window take effect immediately. Any calls already in the queue are re-evaluated against the new window. There is no need to restart or redeploy anything.

⚠️

Be careful when narrowing your calling window. If you have calls scheduled during hours you are about to disable, those calls will be postponed to the next available window, which may surprise your clients.

Interaction with Client Timezones

The calling window uses your agency timezone. BuildVoiceAI does not currently support per-client calling windows. If a client is in a different timezone, factor that into your agency-level window configuration.

Last updated on