Internal Routes

Internal Routes

Overview

Internal route is a mechanism to handle internal calls, dialled within the call centre.

The phone numbers for internal routes are usually short and can be used to test your applications like Cally Square IVR or to escalate calls to another Queue or custom application.

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

You can access the Internal Routes section from the Voice menu in the main navigation panel.

In this section you can:

  • search for a specific internal route

  • set and clear filters

  • manage columns

  • activate the advanced search for each field

  • delete internal routes (single or bulk delete)

  • export to CSV, if you select at least one internal route

image-20250416-103422.png

For each route, the displayed information are:

  • Id

  • Phone number

  • Context

  • Company

  • Alias

  • Description

Clicking the three dots button (⋮) next to the route, you can:

  • Edit the route

  • Delete the route

To Delete or to Export in CSV one or more routes, you can select them and the related function icons will appear on the right of the upper bar.

 

Create an internal route

To create a new internal route:

  1. Click the Add button and enter the Route’s details:

image-20250416-103735.png
  • Phone Number: the number on which you receive the calls, usually it's given by your telco provider. It is also called DID.

Phone Number is not limited to a single specific number. It can also be a pattern that represents a series of numbers.

A phone number is a pattern if it starts with the underscore symbol (_) and is followed by character(s). The most useful characters are:

  • X which indicates a number from 0 to 9, and

  • . which indicates 0 or more numbers from 0 to 9.

Examples:

  • “_3X” means from 30 to 39

  • “12X.” means all numbers starting with 12 plus at least one other number, like 124, 120, but not only 12

  • Context: the context associated to the internal route  (Default: from-sip)

  • Company: associate a route to a Company

  • Alias: descriptive name associated to the phone number (optional)

  • Description (optional)

Edit an internal route

To edit an internal route:

  1. Go to the Internal Routes list.

  2. Locate the route you want to edit

  3. Click the three dots button (⋮) next to the route to display the menu with available actions.

  4. Select Edit

  5. Modify the settings of interest:

    1. Settings

    2. Actions

  6. Click the SAVE button located at the top-right corner of the web interface to confirm changes. In the Actions tab a notification appears as reminder to save the changes. 

Settings

In the Settings tab, you can modify the below route’s information:

  • Phone Number

  • Context

  • Description.

Actions

On Actions tab, you can configure the routing, by using the different applications to be executed when the call enters the route. Applications are selectable from the list with drag and drop option.


Add the application

To add an application:

  1. Check the Applications list, on the left of the web interface

  2. Drag and drop the application from the Applications list to the section on the right (Drag & Drop routing)

  3. Fill out the necessary fields per each application you add

Application execution depends on:

  • the position of the application in the actions table. If you add multiple applications for a single route, execution starts from the top application and continues until the bottom. You can drag and drop items in the list to arrange the applications order.

  • the time interval that defines when an application can be executed (by default, it’s set to always).

Applications list

The following table shows the list of applications you can use in internal routes:

Application

Description

Parameters

Application

Description

Parameters

Cally Square

Route the call to an IVR project

  • Cally Square Project name

 Dial 

Establish a new outgoing connection on a channel, and then link it to the calling input channel.

  • Technology/Resource: eg SIP/1003

  • Timeout: Timeout before the application terminates 

  • Options: Refer to the Asterisk's wiki 

  • URL 

Internal Dial

Dial an internal extension, to point directly to a specific agent, selectable from the list

  • Agent name

  • Timeout: Timeout before the application terminates 

  • Options: Refer to the Asterisk’s wiki 

  • URL 

External Dial

Dial a number in the selected trunk

  • Trunk

  • Phone number

  • Timeout: Timeout before the application terminates 

  • Options: Refer to the Asterisk’s wiki 

  • URL 

Ring Group

Dial a list of internal extensions

  • User: group of agents

  • Timeout: Timeout before the application terminates 

  • Options: Refer to the Asterisk’s wiki 

  • URL

Playback

Play a sound

  • Audio File Path 

  • Options (Skip, No Answer, J, Say) : Refer to Asterisk's wiki

  • Answer: If set to YES, the system answers the channel.

Queue

Queues an incoming call in a particular call queue 

  • Queue Name 

  • Options : Refer to Asterisk's wiki

  • URL

  • Announce Override: override the announcement specified in queues setting.

  • Timeout: Time in seconds a call will wait in the queue before it is routed to the next application in the dialplan.

  • Answer: If set to YES, the system answers the channel.

Set

Set value of a variable

  • Variable

  • Value

Voicemail

Leave a voicemail message in one or more mailboxes

  • Mailbox@context

  • Options

GoTo

Jump to a particular priority, extension, or context

  • Context 

  • Extension 

  • Priority 

Hangup

Hangs up the calling channel 

  • Hangup Cause Code

Send DTMF

Play DTMF tones

  • DTMF digits: list of digits accepted 0-9, *#, a-d, A-D, w (for a half second pause), W (for a second pause) , f (for a flash-hook, if the channel supports it). Max 30 digits

  • Timeout between tones: amount of time to wait between tones. expressed in ms (default to .25s - max 60000)

  • Tone duration: duration of each digit, expressed in ms (max 60000)

Custom

Executes an application

  • Application Name 

  • Arguments

Edit or Delete the Application

Clicking the three dots button (⋮) next to the application, you can:

  • Delete the application

  • Edit the application

  • Edit the interval to modify execution time (as alternative click the clock icon) selecting the interval type from the list:

    • always

    • custom: select your custom intervals of hours and days/months

    • list: select a custom interval already defined (in the Section Tools Intervals), containing a complete set of sub-intervals