Skip to content
Voxbi Cockpit APIs
API Guides

Schedule steps

A schedule step is one time rule inside a schedule. Each step expresses a single condition (a weekday window, a fixed date, an annual recurrence, or a date range). A schedule is considered to match when any of its steps matches - steps combine with OR logic.

Overview

You rarely create a schedule step directly. The normal entry point is the parent schedule's edit page. A step expresses one condition: the current date or time falls inside this rule. Whether it matches is evaluated by the telephony platform when the call runs.

What it does

Pick the step type by the shape of the recurrence:

Type What it matches Typical use
Days of the week A daily time window on selected weekdays. Office hours: Mon-Fri 08:00-18:00.
Fixed dates A specific calendar date (year-locked) with an optional time window. A one-off closure: 2026-12-24.
Recurring dates A month and day that repeats every year. Annual holidays: Christmas every Dec 25.
Specific periods A datetime range that may span multiple days. Renovation week: 2026-04-01 to 2026-04-07.

For an all-day rule, set a Fixed or Recurring date to the full day (00:00 - 23:59). A step only covers the time window you give it, so expressing "closed all day Christmas Eve" as 09:00-17:00 leaves the hours outside that window (midnight to 09:00 and 17:00 to midnight) outside the rule.

See also

  • Schedules - the parent record that wraps steps and is referenced by call flows.
  • Call flows - where a schedule is attached to gate a routing step.

Form fields

Fields available in the create and edit forms.

General

Status

When off, this step is ignored when the schedule is evaluated. Disable rather than delete to take a rule out temporarily.

Type

The kind of time rule: Days of the week (repeating weekly window), Fixed dates (one-time specific dates), Recurring dates (dates that repeat every year), or Specific period (a precise date-time range). Your choice determines which date fields appear.

Start time

The time of day (HH:mm) when this step becomes active on matching days or dates.

End time

The time of day (HH:mm) when this step stops being active on matching days or dates.

Days of the week

Which days of the week this step applies to. Only visible when the type is Days of the week.

Fixed dates

Specific calendar dates when this step should be active. These dates do not repeat and are one-time only. Only visible when the type is Fixed dates.

Recurring dates

Dates that repeat every year (for example, holidays). Only the month and day are matched. Only visible when the type is Recurring dates.

Specific period

A precise start and end date-time range for this step. Only visible when the type is Specific period.

Updated