Voice

SMS

3CX SIP trunk setup guide
This guide explains how you can configure your 3CX in order to place and receive telephone calls over the Wavix network
Purchase a DID on the Wavix platform

Before placing or receiving a call, you need to have an active DID on your Wavix account. If you already have an active number on your Wavix account, the below steps are optional.

To purchase a DID on your Wavix account:

1.

Log in to your account

2.

Click on Buy under Numbers & trunks in the top menu

3.

Select a country and region you wish to purchase a DID in

4.

Choose a specific number or numbers and click Buy now button

5.

You will be redirected to the Cart where you can confirm your choice and check out the DID(s).

Fig. 1 Search and buy a number

Note

Some DIDs may require a proof of local address and other documents before they can be activated. To enable these DIDs to receive inbound calls, upload the documents required, and wait until they are approved by the Wavix Number Provisioning team.

Create a SIP Trunk on the Wavix platform
Fig. 2 Configure SIP trunk

To create a new SIP trunk on the Wavix platform

1.

Select Trunks under Numbers & trunks in the top menu

2.

Click the Create new button

3.

Select Digest under the Authentication method

4.

Specify SIP trunk name, set SIP trunk password, and select one of the DIDs on your account as Caller ID

5.

Optionally you can set max outbound call duration, max number of simultaneous calls via the SIP trunk, and max call cost. If these parameters are not set, global account limits apply.

6.

Click Create

After the SIP trunk is successfully created, it will appear on the list of SIP trunks on your account.

Fig. 3 List of SIP trunks and SIP trunk ID

Important

Please be advised that your 5-digit SIP trunk username is generated automatically and displayed in the SIP trunk ID column.

Configure SIP trunk in 3CX

To configure inbound and outbound calls on your 3CX instance, log in to the 3CX Management Console, go to SIP Trunks in the left hand side menu and add a new SIP Trunk.

Fig. 4 List of SIP Trunks in 3CX Management Console
Fig. 5 Add new SIP Trunk

Select your country and select Wavix from the list of Providers in your Country. Put your default Caller ID into Main Trunk No field. Click OK.

After the SIP Trunk is successfully created, you will be automatically redirected to the SIP trunk configuration page.

In the General tab in the Trunk Details section, adjust the name of the SIP trunk or update the field labeled Registrar/Server/Gateway Hostname or IP if needed. We recommend you to put the address of a regional Wavix SIP proxy located near to you in the field labeled Registrar/Server/Gateway Hostname or IP. The full list of the Wavix regional gateways can be found in the bottom of the page https://app.wavix.com/trunks. In the Authentication section provide SIP trunk ID and password set up for the SIP trunk on the Wavix platform.

Fig. 6 3CX SIP Trunk Details
Fig. 7 SIP Trunk authentication details

Note

By default, a new 3CX trunk supports up to 10 calls in parallel. However, for security reasons, all new Wavix accounts can place only 2 simultaneous calls. In case you’d like to adjust the limit, reach out to your account manager or email support@wavix.com

To save SIP trunk configuration click OK on the top of the page. It takes a moment or so for 3CX to register the SIP Trunk.

Fig. 8 Add new SIP Trunk

Click on Options tab and ensure that inbound and outbound calls are allowed and video calls are not in the Call options section.

Scroll the page down and check the Codec Priority. Wavix supports all the codecs listed below and G.711 is recommended for most cases.

Fig. 9 SIP Trunk supported codecs

Green bubble indicates that the SIP Trunk is successfully registered. In case of any issues, check Event logs in the 3CX Management Console dashboard.

Fig. 10 SIP Trunk successfully registered
Activate IP authentication

The Wavix platform supports IP authentication for dedicated IP addresses. To activate IP authentication for your SIP device you need to enable this feature in your 3CX and on the Wavix side.

Fig. 11 SIP Trunk authentication details

Complete the below steps in your 3CX:

1.

Open your 3CX SIP Trunk settings

2.

Set the Type of Authentication to Do not require - IP based in the drop-down menu. Leave all the other fields blank.

3.

Click OK to apply changes

Fig. 12 Wavix SIP trunk ID authentication

To activate the IP authentication on the Wavix platform:

1.

Open the Wavix SIP trunk settings

2.

Select IP Authentication in the Authentication method section

3.

Enter your 3CX dedicated IP and click Submit

4.

Click Save to apply changes

Important

After submitting the IP authentication request, you’ll not be able to update your IP address or change the authentication method.

Once your request is approved by the Wavix ops team, IP authentication will be activated on your Wavix SIP trunk.

Important

By default, an IP address can only be mapped to a single SIP trunk. If you need to have several Wavix SIP trunks sharing the same IP address, please contact support@wavix.com

Configure outbound calls

In order to place outbound calls you need to configure Outbound Rules. Go to Outbound Rules in the left hand side menu and click the “Add” button.

Give your Outbound Rule a name and apply it to the Default extension group by:

1.

Clicking on the Add button in the Apply this rule to these calls section

2.

Selecting the DEFAULT group name

3.

Clicking OK

Fig. 13 Assign an Outbound Rule to extension

Scroll to the Make outbound calls on section, select Wavix and save the Outbound Rule.

Fig. 14 Set route for an Outbound Rule

All destination phone numbers must be in the E.164 international format. E.164 numbers can have up to fifteen digits and are usually formatted as follows: [+][country code][subscriber number including area code]. An example of an US number in E.164 format is +16561223344. Calls to numbers without country code or carrying national access codes will be rejected by the Wavix platform.

Below are typical examples of incorrectly formatted phone numbers

Country
Number
Reason
Number in E.164 format

Country

US

Number

6561223344

Reason

No country code

Number in E.164 format

+16561223344

Country

UK

Number

020 1122 3344

Reason

No country code, national access code with leading 0

Number in E.164 format

+442011223344

Country

Switzerland

Number

0041797000777

Reason

Leading 00 international prefix

Number in E.164 format

+41797000777

Table 1 International E.164 phone number presentation

Depending on your users’ dialing habits, you may want to strip some of the leading digits or prepend the country code. For example, the below configuration can be used to prepend all dialed numbers with the leading 1 in case your users are accustomed to US domestic number in the national format.

Fig. 15 Custom dial rule configuration
Configure inbound calls

Important

If you have enabled IP authentication for your SIP trunk, scroll down to the 'Configure inbound call routing for trunks with IP authentication' section.

In order to receive inbound calls you need to configure Inbound Rules. Go to Inbound Rules in the left hand side menu and click on the Add DID Rule button.

Give your Inbound Rule a name, enter the number and set the extension to route calls to.

Fig. 16 Inbound Rule configuration

Click OK to save the rule. Depending on your business needs, you may set specific office hours for the rule and route calls to different extensions, voice mailbox or automatically drop the call based on the schedule.

For calls to be routed to your 3CX instance, log in to your Wavix account, select My DIDs under Numbers & trunk in the top menu, click on the three dots on the right hand side and select the Edit DID option.

1.

Select the destination trunk in the Destination section

2.

Click Add to add the destination for the DID

3.

Click Save to save the settings

Fig. 17 Wavix DIDs
Fig. 18 Wavix DID configuration

Select the trunk in the Destination section. Click Add to add the destination for the DID and Save to save the settings.

You can also edit several DIDs at the same time. To do so, select multiple numbers to edit and click the Bulk actions button.

Fig. 19 Bulk DID edit

Please be aware that changes will be applied to all selected numbers.

Configure inbound call routing for Trunks with IP authentication

Note

Skip this section if your trunks are configured to use account-based authentication.

When an inbound call reaches Wavix, it can be routed to your SIP trunk, a SIP URI, or a PSTN number.

Important

SIP trunks with IP authentication enabled cannot be used for inbound call routing as they do not maintain registration with Wavix proxies. In order to configure inbound routing for your numbers you must specify a valid SIP URI address instead.

To configure inbound call routing to a valid SIP URI:

1.

Log in to your Wavix account

2.

Select “My DIDs” under Numbers & trunks

3.

Click on the three dots on the right-hand side and select the Edit DID option. Double click is also supported

4.

Select SIP URI in the transport drop-down menu

5.

Enter a valid SIP URI using the following format: +[did]@FQDN:port;transport=connection, where:

a.

FQDN is the fully qualified domain name or IP address of your 3CX instance

b.

The port is the SIP port used by the PBX

c.

The connection could be either udp, tcp, or tls. The default transport is udp

6.

Click Add to add the destination for the DID

7.

Click Save to apply settings

Keep in mind that [did] parameter will be automatically updated with the actual dialed phone number when routing the call.

You can also edit several DIDs at the same time. To do so, select multiple numbers to edit and click the Bulk actions button. Note that changes will be applied to all selected numbers.

Please make sure that all your Wavix DIDs are listed under the DIDs tab of the 3CX SIP Trunk.

Fig. 20 Wavix DID configuration
Verifying the setup

To test the SIP trunk place a call to your mobile phone number. Go to Users in the left hand side menu, click on the default 100 extension and download the application by scanning the QR code on the page. Place a test call using the app.

Fig. 21 3CX extension

If the outbound call fails check the following:

  • You’ve completed all the steps in this guide
  • You’re dialing the phone number in the international E.164 format
  • Max call rate limit set on your SIP trunk or account is enough to call the desired destination. You can find your effective rates in the My account section at https://app.wavix.com
Have a question?