Out Prefixes

Out Prefixes

Overview

Out Prefixes are labels assigned to outbound calls, making it easy to categorize and track them. They are especially useful when managing multiple customers or services within XCALLY. By using Out Prefixes, you can distinguish outgoing calls by customer or service in operational workflows and reporting—ideal for detailed billing reports.

Out Prefixes also allow you to define:

  • The Caller ID and number displayed to call recipients.

  • The context used for routing calls.

This page describes the Out Prefixes configuration on the New Client Experience, available from version 3.48.0.
We recommend using the New Experience web interface to take full advantage of the latest features.

 

In the section, you can easily search, filter, and sort to quickly find and manage the out prefix you need.

Add a New Prefix

Navigate to Voice → Out Prefixes

image-20250306-092431.png

Click Add button to open the form:

  • Name: unique name for the Out Prefix.

The prefix name will appear in the call_report table under the prefix column

 

  • Context (Origin): select the originating context from the list. This context must already exist and relates to the prefix.

  • Context (Destination): select the destination context. The prefix will function correctly only if the associated agents or routes belong to this context

Deleting a context linked to an Out Prefix will delete the prefix as well.
Agents added to an Out Prefix must be within the Origin context.

 

  • Keep Prefix: toggle this option to keep the prefix when the call is placed
    Default behavior: If inactive, calls enter the trunk without the prefix. With keep prefix call enters in the trunk by adding the indicated prefix.
    (Example: agent calls number 1234 with prefix 333:

    • If keep prefix inactive → call goes as 1234

    • If keep prefix active → call goes as 3331234

  • Caller ID: Define the Caller ID and the number (authorized by the provider),visible to the call recipients. Format: 'CallerName' <number>

  • Description: Optional text field



Edit/Delete out prefix

From the Out Prefixes list, click the three-dot menu next to a prefix to:

  • Edit name, context and other parameters

  • Associate Agents/Teams authorized to use the prefix

  • Delete the prefix

 

Associate Agents/Team to Prefix

In the agent/team association modal select agents/teams and use buttons to add or remove them individually or in bulk.

image-20250306-093141.png

> : “greater than” icon to add the selected option

>>: right shift to add all the available elements

< : “less than” icon to remove the selected agent from the right column

<< : double left shift to remove all the selected elements

 

Usage Scenarios

Scenario 1

Company WorldTech manages one trunk handling multiple phone numbers and two groups of agents:

  • Group A calls on behalf of Customer A with Caller ID 123

  • Group B calls for Customer B with Caller ID 456

 

 

To manage this, WorldTech creates two Out Prefixes pointing to the same context but with different Caller IDs:

Customer A:

  • Name: CUSTOMER A

  • Context: from-sip

  • Caller ID: "CustomerA" <123>

Customer B:

  • Name: CUSTOMER B

  • Context: from-sip

  • Caller ID: "CustomerB" <456>

Customer A:

  • Name: CUSTOMER A

  • Context: from-sip

  • Caller ID: "CustomerA" <123>

Customer B:

  • Name: CUSTOMER B

  • Context: from-sip

  • Caller ID: "CustomerB" <456>

  • Associate the Out Prefixes to different Agents or Teams, previously configured. From the Out Prefixes list, click the three-dot menu next to a prefix to:

  • Add Agent/Team to the Prefix for Customer A (e.g. Team1)

  • Add Agent/Team to the Prefix for Customer B (e.g. Team2)

 

Scenario 2

Company TechNow has two trunks (1 and 2) and two agent groups:

  • Customer A agents use trunk 1 with Caller ID 123

  • Customer B agents use trunk 2 with Caller ID 456

image-20250306-092153.png

The company TechNow should:

  • Create two Voice Contexts, one per trunk

    • From the Voice Menu, access the Contexts section.

      Click on Add button to create the New Contexts and fill out the following form:

      • Set Context1

      • Set Context2

  • Create two Out Prefixes linked to these different contexts:

Customer A:

  • Name: CUSTOMER A

  • Context: Context1

  • Caller ID: "CustomerA" <123>

Customer B:

  • Name: CUSTOMER B

  • Context: Context2

  • Caller ID: "CustomerB" <456>

Customer A:

  • Name: CUSTOMER A

  • Context: Context1

  • Caller ID: "CustomerA" <123>

Customer B:

  • Name: CUSTOMER B

  • Context: Context2

  • Caller ID: "CustomerB" <456>

  • Assign each prefix to the respective agents or teams.

    • Add Agent/Team to the Prefix for Customer A (e.g. Team1)

    • Add Agent/Team to the Prefix for Customer B (e.g. Team2)



Out Prefixes for Agents

Out Prefixes are only visible to the agents or teams associated with them. When an agent dials out, XCALLY prompts them to select from their assigned Out Prefixes.

Optionally, the Out Prefix can be made mandatory per agent by enabling the corresponding flag in Agent Settings → Permissions.