V3 Trunks

V3 Trunks

What’s about

A Trunk is a SIP connection between your phone system and a VOIP provider for inbound and outbound calls. This section covers topics related to managing trunks.

The SIP trunk configuration will depend on your VoIP provider. There are registration-based SIP Trunks i.e. via username and password, and IP-based trunks, i.e. PBX public IP is linked to the provider.
Please check with your provider the necessary configuration parameters.

For Sample trunk configurations go to:Ā Examples of Trunks

Don't forget to configure theĀ InboundĀ andĀ OutboundĀ routes to properly route the incoming and outgoing calls

How it works

You can find the Trunks section under theĀ ToolsĀ menu:

When you click on it, you can see all the already existing Trunks or configure new ones:

Manage a Trunk

Create

If you want to create a new trunk click on theĀ  Ā button and enter:

  • the Trunk Name

  • the Domain/Host name (ask the Provider)

  • Authentication Password

  • Default User Name

  • Trunk Registry string (which is usually defaultuser:password@host)

Before adding the new trunk, remember to activate it by clicking the ActiveĀ flag

Edit/Modify

Once a trunk has been created, you can edit it to change default values:

You can also duplicate a trunk (Clone Trunk) and modify the copy.

Settings

In the Settings Section, you can change general settings inserted at trunk generation (like name, default user, password, context and so on) plus a set of other parameters (in this section and the Advanced and Other Fields).

In the following example, you have all the default parameters for the demo trunk (configured during installation):

Advanced

image-20240229-132602.png

As indicated in the sip.conf file, the format of Asterisk's register directive is as follows:

register => [peer?][transport://]user[@domain][:secret[:authuser]]@host[:port][/extension][~expiry]

To send the REGISTER using the TCP protocol, it is necessary to explicitly specify the transport in the dedicated field.

E.g.:

register => tcp://username:password@host

Other Fields

Monitor Trunk Status

To monitor the trunk registration status go toĀ RealtimeĀ in the Voice Section:

and then click on the tab Trunks:

Ā 

In the trunk realtime environment you see:

  • Trunk Status, which shows status of a SIP trunk registration to motion server

  • Registry, which shows SIP registration status when Motion registers as a client to the provider.

You can also obtains the same result by clicking on Go to Realtime Trunk on the trunks list command menu:

Trunks on New Client Experience

FROM VERSION 3.45.0

If you enable New Client Experience, you can view this visualisation, with the list of created trunks:

image (8)-20250108-150224.jpg

you can:

  • search for a specific trunk

  • clear all filters

  • manage columns, by selecting or not them

  • activate the advanced search for each field

  • create a new trunk, by clicking on Add and indicate:

    • the relative name

    • active status

    • host

    • secret

    • default user

    • registry

image-20250108-150707.png

Examples of Trunks

Scenario 1: Motion and VoIP provider

image-20250609-083650.png
image-20250609-083710.png
image-20250609-083727.png

Registry string

The format of the registry string is usually:

defaultuser:secret@host or defaultuser:secret@host/callerid (in the most of cases the callerid and the defaultuser are the same).

Scenario 2: SIP Gateway Digium

image-20250609-083827.png
image-20250609-083839.png
image-20250609-083853.png

Ā 

Scenario 3: TWILIO SIP trunk

The following Interconnection Guide provides you with a step-by-step configuration to use XCally Call Center with Twilio Trunks:

image-20250609-083941.png
  1. Access your Twilio account and order the Inbound DID number you want to associate with the SIP Trunk

  1. Locate the Twilio section Elastic SIP Trunk and select the tab Configure, then click on Create SIP Trunk

Ā 

Give a name to the new SIP Trunk and Save

  1. Edit the created SIP Trunk and fill in the:

3.1Ā Termination: create your own Twilio Termination SIP URI (in our exampleĀ training1.pstn.twilio.com)

image-20250609-084200.png

3.2 Click on toĀ + Create IP Access Control ListĀ section to enable only the IP address of your XCALLY server for security reason (in our example 197.22.150.2)

3.3 Click on to the + Create Credential List link and insert the user and password you want to use for this SIP Trunk autenticationĀ 

3.4 SAVE the Termination section configuration
3.5 Select theĀ OriginationĀ tab and create yourĀ Origination URIĀ (We suggest you to fill it with: sip:DIDNumber@XCALLY-IP-ADDRESS)

3.6 Select theĀ NumbersĀ Tab and ADD the number you have bought in order to associate the number to the created Trunk and SAVE

For inbound call being properly routed to your XCALLY server,Ā you need to Whitelist the Twilio IP address, so to accept VoIP traffic from the Twilio servers:
https://www.twilio.com/user/account/sip-trunking/your-network
Check your Firewall and XCALLY server iptables to accept those IP address requests!

Scenario 4: Motion and FreePBX

Create a SIP extension on your FreePBX (your inbound calls will be routed on xCALLY)

Choose an extension number in according to your dial plan, in the example below we used 9000

Pay attention to set Outbound Concurrency Limit to ā€œNo Limitā€ and Call Waiting to ā€œEnableā€.

Change, if you want, the password of the extension. In the example, the password isĀ xcally1234

Ā 

Ā 

Ā 

Ā 

Ā