Skip to main content

Overview

A routing endpoint is a transfer destination. It joins one location and one department, references a schedule, and points at a single destination. When the assistant transfers a call, it resolves the matching endpoint, checks whether it is open, and dials the destination. The Endpoints tab lists endpoints grouped by location with a live open/closed status that polls in the background.

Fields

FieldTypeRequiredDefaultDescription
NamestringYesEndpoint name, e.g. “Sydney Sales”. Unique per team.
LocationlocationYesThe location this endpoint serves.
DepartmentdepartmentYesThe department this endpoint serves.
SchedulescheduleNoinheritedExplicit schedule override. When empty, the endpoint inherits department → location → team default. See Schedules.
Destination typestringYesphoneOne of phone, member, or sip_uri.
DestinationstringYesThe destination value, matching the type (see below).
ExtensionstringNononeOptional internal short code.
PriorityintegerNo0Tie-breaker when more than one active endpoint matches a location × department. Lowest wins.
ActivebooleanNotrueInactive endpoints are skipped during resolution.

Destination Types

TypeInputNotes
phonePhone numberValidated as a real number (E.164).
memberTeam memberDials the member’s verified mobile on file. Every team member has one.
sip_uriSIP URIMust start with sip:.
Exactly one destination value is set, matching the selected type.

Open / Closed Status

An endpoint is open when it is active, has a valid destination, and its effective schedule reports open right now. It shows closed outside the schedule’s hours, on excluded public holidays, and on date-override closures. An endpoint is flagged broken when its destination cannot be dialled — for example a member whose account is no longer on the team or has no number on file, or a destination value that is missing. Broken endpoints surface on the Overview dashboard.

Resolution

When a transfer targets an endpoint (directly, or by location + department), Voxworks:
  1. Finds the matching active endpoint. If more than one matches, it picks the lowest priority.
  2. Determines the effective schedule (endpoint → department → location → team default).
  3. Checks the schedule. If open, it dials the destination.
  4. If closed, it falls back — voicemail by default.
Every resolution is recorded in the Audit Log with the endpoint chosen, the open/closed state, and the destination dialled, linked to the call.

Next Steps

  • Schedules — Control when an endpoint is open
  • Warm Handoff — The tool that transfers a caller to a human