Get System Capacity

Get System Capacity is one of the Internal Data Ops operations. It queries how much capacity your system has and how much of it is currently in use, both for extensions and for concurrent calls, and stores those numbers in variables. Later components can read the variables to decide how the call should proceed.

What it does

The component returns four values:

• The maximum number of extensions the system supports, and how many are already in use.
• The maximum number of concurrent calls the system supports, and how many are active right now.

Because the results are held in variables, you can feed them into a following component or test them in a Condition: for example, to play a different message when the system is near its call ceiling.

Note

“Concurrent calls” means the calls happening at the same moment, not the total for the day. When that number reaches the system limit, no further calls can be set up until one ends, so it is a useful figure to branch on.

Configure the component

1. Drag the Internal Data Ops component onto the canvas, then click it to open its settings.

   

2. In the Component Type drop-down list, choose Get System Capacity.

   

3. Click Confirm in the bottom-right corner.

Note

Get System Capacity takes no settings of its own. Selecting it as the component type and confirming is all the setup it needs; the values it collects are then available through the variables below.

Variables

When you add a Get System Capacity component, it writes the current capacity figures into the variables below. Read them from any expression-aware component, Condition, for instance, to act on what the query returned.

Note

A call flow can hold more than one Get System Capacity component, so each is numbered in the order you add it (Get System Capacity 1, Get System Capacity 2, and so on). Include the matching index in the variable name so you read from the right component.

Variable	Type	Description	Example
$GetSystemCapacity{index}.extensionCapacity	Integer	The maximum number of extensions the system supports.	50
$GetSystemCapacity{index}.extensionUsed	Integer	The number of extensions currently in use.	33
$GetSystemCapacity{index}.ccCapacity	Integer	The maximum number of concurrent calls the system supports.	25
$GetSystemCapacity{index}.ccUsed	Integer	The number of concurrent calls active right now.	1

Tip

To branch on how busy the system is, compare the used value against the capacity in a following Condition component. For example, the expression $GetSystemCapacity1.ccUsed >= $GetSystemCapacity1.ccCapacity becomes true once every concurrent-call slot is taken, so you could route those callers to a Prompt that asks them to try again shortly.

What it can connect to

A Get System Capacity component leads to exactly one downstream component. Any of the following can follow it:

Caution

On its own this component does nothing the caller can hear; it only stores the capacity figures in variables. To change how the call behaves, the next component (or a later Condition) must actually read those variables. The query by itself has no effect on the call.

Component	Purpose
Prompt	Play an audio file or a text-to-speech message to the caller.
Business Hours	Route the call to different destinations depending on the time of day.
Menu	Offer callers a set of options and route them by the DTMF (Dual-Tone Multi-Frequency, the touch-tone a phone keypad sends) key they press.
User Input	Collect DTMF digits from the caller, usually paired with Condition to act on what was entered.
Language	Change the system prompt language for the rest of the flow.
Record	Start recording once the caller connects to another party, with optional notification prompts, or turn recording off for a call that would otherwise be recorded.
Dial by Number	Let callers dial a number directly to reach their destination.
Dial by Name	An end component that lets callers reach a user by typing the first three letters of their name.
Transfer	An end component that sends the caller to a chosen destination, with optional prompts announcing the transfer.
Hang Up Call	An end component that disconnects the call.
Condition	Route the call based on logical expressions.
Loop	Repeat a group of components a set number of times or until a condition is met.
Internal Data Ops	Read from and write to the Cloud Voice system’s own database. See Get Extension Presence Status, Set Extension Presence Status, Get Queue Agent, Get Queue Info, Get Agent Status, Set Agent Status, Get System Info, Get System Capacity, Get Extension Info, and Get Company Contact Info.
Email Sender	Send an email for real-time notifications, alerts, or user-specific information.
Database Access	Run a SQL (Structured Query Language) operation against an external database during the call flow.
HTTP Request	Send an HTTP (HyperText Transfer Protocol) request to an external server to exchange data with a third-party service.