Garage Door OS Docs
Jobs & Scheduling

On-Call Schedule

Configure after-hours on-call rotation for your team.
4 min read

On-Call Schedule

Configure after-hours on-call rotation so emergency callers reach the right technician or staff member through your IVR or AI call flows.

Overview

The on-call schedule assigns agents (technicians or staff) to time windows. When a caller triggers an emergency path—via IVR option or AI phrase—the call service routes to whoever is currently on call.
Schedule types:
TypeUse case
Daily (recurring)Same day-of-week and time range every week (for example, Mon 5 PM – Tue 8 AM)
Weekly (date range)Fixed start/end dates with daily time bounds
Specific blocksOne-off or custom datetime ranges
The page shows Current on-call at the top when the call service is reachable.

How to access

  1. Sign in as a user with settings access.
  2. Go to Settings → On-Call Schedule (/settings/on-call-schedule).
Embed routes exist for multi-tenant or external admin tools: /embed/on-call-schedule (see your deployment docs).

What you can do today

  • View who is on call right now (name and phone when available).
  • Add schedules with agent, type, and time configuration.
  • Edit, activate/deactivate, or delete existing schedules.
  • Support daily, weekly, and specific block rotation patterns.
  • Reload schedule data after changes.
Emergency routing integrates with the call service—IVR and AI intake must be configured separately.

Prerequisites

  • Call service running and connected to your API (local dev: pnpm run calls).
  • Users/agents exist in Settings → Team with valid phone numbers for routing.
  • IVR or AI emergency phrases configured to use on-call lookup (see call center / IVR docs: Call Center documentation if linked in your environment).
  • Admin or settings permission to edit schedules.

Step-by-step

Add a recurring nightly rotation

  1. Open Settings → On-Call Schedule.
  2. Under Add / Edit Schedule, choose an Agent.
  3. Set Type to Daily (recurring).
  4. Pick day of week, start time, and end time (overnight ranges supported).
  5. Save. Confirm the row appears in the schedule table and Active is on.

Cover a holiday week

  1. Choose Weekly (date range).
  2. Set start date, end date, and daily start/end times.
  3. Assign the covering agent and save.

Verify live routing

  1. Check Current on-call at the top of the page.
  2. Place a test call through your emergency IVR or AI phrase.
  3. Confirm the call reaches the displayed agent’s phone.
  4. If loading fails, ensure the call service is running—error messages indicate when it is unreachable.

Temporarily disable coverage

  1. Toggle Active off on a schedule row, or delete the row.
  2. Ensure another active schedule covers the same window to avoid gaps.

Current limitations

  • On-call routing requires the call service; the web UI alone does not forward calls.
  • Overlapping schedules depend on call-service resolution rules—avoid duplicate windows for the same business without confirming priority behavior.
  • No mobile push “accept decline” screen in this settings page; routing is phone-based per agent profile.

Related features