Get Extension Info

This topic provides an overview of the Get Extension Info component, and describes its configuration as well as supported connections.

Component introduction

Get Extension Info component allows you to query extension information, including extension number, extension name, email address, and mobile number.

You can either specify the extension directly, or configure expressions to dynamically specify the target extension. The query results are stored in variables, which can be used as input for subsequent components or for condition evaluation.

Note: If multiple matches are found, the system returns the information of the most recently created extension.

Component configuration

After adding Internal Data Ops component to a call flow, click Internal Data Ops component to proceed with the configuration.
In the Component Type drop-down list, select Get Extension Info.

Specify the target extension using the following filters.


Filter	Description
Keyword	Enter a keyword to search an extension by first name, last name, email address, or extension number. Alternatively, click and configure an expression to dynamically specify the extension.
Name	Enter extension's first name or last name, or click to configure an expression.
Email	Enter extension's email address, or click to configure an expression.
Number	Enter extension number, or click to configure an expression.
Extension Group	Select extension group(s) to search extensions in these groups. Note: If no groups are configured, the system searches across all extension groups.
Organization	Select departments(s) to search extensions in these departments. Note: This option is available only when Organization Management is enabled (Path: PBX Settings > Preferences > Organization Management). If configured, the system searches extensions within the selected department(s) and their sub-departments. Otherwise, the system searches across all departments.

At the bottom-right corner, click Confirm.

Component variables

When a Get Extension Info component is added to a call flow, the system stores extension information in variables. These variables can be referenced in expression-supported components (such as Condition) to retrieve the extension information and respond accordingly based on the result.

Note: Since Get Extension Info component can be added multiple times in a call flow, an index is appended to each component (e.g. Get Extension Info 1, Get Extension Info 2) based on the order in which the components are added. To retrieve data from the right component, the component variable must contain the corresponding index.


Variable	Type	Description	Example Value
$GetExtensionInfo`{index}`.number	String	Extension number.	"1001"
$GetExtensionInfo`{index}`.name	String	Extension name.	"Phillip Huff"
$GetExtensionInfo`{index}`.email	String	Extension's email address.	"phillip@sample.com"
$GetExtensionInfo`{index}`.mobileNumber	String	Extension's mobile number.	"15880123456"

Component connections

Get Extension Info component can be connected to one component, which can be any of the components listed below.


Component	Description
Prompt	Prompt component allows you to play audio prompt(s) or a text-to-speech message to callers. For more information, see Prompt.
Business Hours	Business Hours component allows you to route calls to different destinations based on the time of day. For more information, see Business Hours.
Menu	Menu component allows you to present callers with a set of menu options, and route calls based on the DTMF digit they press. For more information, see Menu.
User Input	User Input component allows you to collect DTMF digits from callers, typically used with Condition component to evaluate user input and route calls. For more information, see User Input.
Language	Language component allows you to change the system prompt language for subsequent components in a call flow. For more information, see Language.
Record	Record component allows you to start recording a call upon the caller being connected to another participant, and optionally configure prompts to inform call participants at the start and during the recording. Alternatively, you can use the component to disable call recording for calls that are supposed to be recorded. For more information, see Record.
Dial by Number	Dial by Number component allows callers to directly dial a number to reach the destination. For more information, see Dial by Number.
Dial by Name	Dial by Name component is one of the end components to terminate caller's connection to the current call flow. It allows callers to reach extension user by entering the first three letters of the user's name. For more information, see Dial by Name.
Transfer	Transfer component is one of the end components to terminate caller's connection to the current call flow. It allows you to transfer callers to a designated destination, and optionally configure prompts to inform them of the transfer. For more information, see Transfer.
Hang Up Call	Hang Up Call component is one of the end components to terminate caller's connection to the current call flow. When callers are routed to the component, the call will be disconnected. For more information, see Hang Up Call.
Condition	Condition component allows routing calls based on logical expressions. For more information, see Condition.
Loop	Loop component allows a group of components to be executed repeatedly, either for a specified number of times or until a condition is met. For more information, see Loop.
Internal Data Ops	Internal Data Ops component allows you to query and update data from PBX-native database. For more information, see the following topics: 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 Get Company Contact Info
Email Sender	Email Sender component allows you to send emails, enabling real-time notifications, alerts, or delivery of user-specific information. For more information, see Email Sender.
Database Access	Database Access component allows you to interact with database during a call flow. You can execute SQL operations to retrieve or update data as needed. For more information, see Database Access.
HTTP Request	HTTP Request component allows you to send HTTP requests to external web servers, enabling data exchange with third-party services. For more information, see HTTP Request.