Skip to content
Docs
Voxbi Cockpit APIs
API Guides

Status

A status is one of the availability states your users pick in the status changer. Each carries an availability group that tells call routing how to treat the user, plus optional flags for side-effects like DND or lunch tracking.

Overview

You manage statuses centrally here. Users pick them from the status changer in the Voxbi app or via a phone button. A status lives in two worlds: in telephony its availability group decides whether queues ring the user, and in Tempus some flags change how the time is recorded for reporting.

What it does

Call routing inspects the availability group, never the status name. Every status belongs to one of five groups.

Group Call routing Typical examples
Available Receives queue calls, BLF shows green Available, At desk
Meeting Shows busy on BLFs, some queues skip In a meeting, Client call
Busy Shows busy, queues skip Focus mode
Away Shows away, queues skip, calls may forward Quick break, Coffee
Unavailable Skipped by all queues Lunch, End of day

Behavioral flags stack on top. A Lunch status with Add to lunch time and Activate DND both records lunch time in Tempus and silences calls.

Flag Effect
Add to lunch time Time counts as lunch in Tempus reporting.
Activate DND Turns on Do not disturb while the status is active.
Enable call ringing Lets calls ring despite the user's right-to-disconnect setting.
Payable Time counts as paid work hours.

The sub-status section picks which sub-statuses appear under this status, and whether the user may pick several or must pick one.

See also

Form fields

Fields available in the create and edit forms.

General

Name

Display name shown to users in the status changer and throughout the system.

Status group

Availability group that decides how call routing treats users in this status.

  • available Available User receives queue calls and shows as available.
  • meeting Meeting Visible as busy on BLFs. Some queues may skip.
  • busy Busy Visible as busy. Queues skip this user.
  • away Away Visible as away. Queues skip. Calls may forward.
  • unavailable Unavailable Completely skipped by all queues.
Ring users despite right to disconnect

Only has an effect on statuses in the Unavailable group. A user who has turned on right to disconnect stops receiving twinning calls while in an Unavailable status; turn this on to let their twinnings ring anyway.

Description

Optional context shown to users picking this status, explaining when to use it.

Background color

Background color representing this status in the changer and layouts.

Font color

Text color displayed on top of the background for readability.

Icon

Icon shown next to the status name in the status changer.

Flags

Behavioral flags that stack on top of the availability group, such as adding time to lunch tracking, activating DND, or marking time as payable.

Allow users to select more than one sub-status

When on, users can select more than one linked sub-status simultaneously when activating this status.

Force the user to select a sub-status

When on, the user must pick at least one sub-status before the status becomes active.

Link sub-statuses

Sub-statuses available under this parent. Users see these as additional options when they pick this status.

Mapping

External identifier used to keep this status in sync with integrations such as DSK or Tempus V1.

Locations

Locations where this status is available for selection. Leave empty to allow the status on all locations.

Payable

Whether time spent in this status counts as paid.

Updated