Skip to main content

​
Prerequisites

Before you begin, ensure you have:
  1. An active phone number on your Wavix account. If you need to purchase one, see our guide on how to buy a phone number.
  2. A SIP trunk (How to create a SIP trunk).

​
Configure a SIP trunk in FreePBX

For this guide, we will use nl.wavix.net as the primary SIP gateway.
Choose the primary gateway with the lowest ping from your location. A full list of Wavix regional gateways is available at the bottom of the page: https://app.wavix.com/trunks
To configure outbound calls on your FreePBX server:
  1. Sign in to your FreePBX instance.
  2. In the top menu, go to Connectivity → Trunks.
  3. Click Add trunk and select Add SIP (chan_pjsip) Trunk.
  4. Enter a Trunk Name, set an Outbound CallerID, and specify Maximum Channels:
    • Trunk Name - the name of your FreePBX SIP trunk.
    • Outbound CallerID should be an active or verified phone number from your Wavix account.
    • Maximum Channels limit the maximum number of concurrent calls for this trunk. FreePBX SIP trunk general configuration
  5. Navigate to pjsip Settings and open the General tab:
    • Username and Auth username should contain a 5-digit Wavix SIP trunk username.
    • Secret: Your Wavix SIP trunk password.
    • SIP server: Wavix regional SIP gateway with the lowest ping from your location.
    • Port: Set to 5060.
  6. Keep the default values for all other parameters.
  7. Click Submit. FreePBX pjsip settings

​
Enable IP Authentication

You may wish to enable IP Authentication on Wavix SIP trunks. When IP Authentication is enabled, Wavix will accept all calls originating from a specified IP address without requiring login credentials.
You must have a dedicated IP for this option to work correctly.

​
Activate IP Auth on Wavix SIP trunk

To enable IP Authentication on your Wavix SIP trunk:
  1. Create new or open an existing Wavix SIP trunk settings.
  2. Under Authentication Method, select IP Authentication.
  3. Enter a public static IP address of your FreePBX and click Submit.
  4. Click Save to apply the changes.
Once submitted, the Wavix Support team will review and enable IP Authentication on the SIP trunk.
After submitting the IP authentication request, you won’t be able to update your IP address or change the authentication method.
  • When IP Authentication is enabled, the SIP trunk cannot be used as a destination for a DID (phone number). You must use a SIP URI instead.
  • By default, an IP address can only be mapped to a single SIP trunk. If you need several Wavix SIP trunks sharing the same IP address, please contact support@wavix.com.

​
Activate IP Auth in FreePBX

To enable IP Authentication on your FreePBX SIP trunk:
  1. Create new or open an existing FreePBX SIP trunk settings.
  2. Navigate to pjsip Settings and open the General tab:
    • Set Authentication to None.
    • Set Registration to None.
    • Make sure SIP server contains a domain name of Wavix’s SIP proxy with the lowest ping from your premises.
  3. Click Submit to apply the changes.

​
Configure outbound calls in FreePBX

To configure outbound calls:
  1. In the top menu, go to Connectivity → Outbound Routes.
  2. Select Add Outbound Route:
    • Specify the Route Name.
    • Select the Wavix trunk in the Trunk Sequence for Matched Routes.
    FreePBX Outbound Route configuration
  3. Select Dial Patterns and define the rules for routing calls to the Wavix trunk. If the dialed number matches one of these patterns, no other routes are checked. FreePBX Dial Patterns configuration
Wavix only allows phone numbers in the E.164 international format. This format can handle numbers with up to 15 digits and is usually written as [+][country code][subscriber number including area code]. For example, a US number in E.164 format would be +16561223344. The Wavix platform will reject calls to numbers without a country code or carrying national access codes.
CountryNumberReasonNumber in E.164 format
US6561223344No country code+16561223344
UK020 1122 3344No country code, national access code with leading 0+442011223344
Switzerland0041797000777Leading 00 international prefix+41797000777

​
Configure inbound calls

​
Configure inbound calls on Wavix

If you have enabled IP authentication for your SIP trunk, scroll down to the Configure inbound call routing for trunks with IP authentication section.
  1. Sign in to your Wavix account.
  2. In the top menu, go to Numbers & Trunks → My numbers.
  3. Click on the three dots next to the number you want to edit (right-hand side) and select Edit number.
  4. Select the destination trunk in the Destination section.
  5. Click Add to add the destination for the phone number.
  6. Click Save to apply the settings.
Wavix DID configuration You can also edit multiple numbers simultaneously. To do this, select the multiple numbers you want to modify, then click the Bulk actions button. The changes will apply to all selected numbers.

​
Configure inbound call routing for trunks with IP authentication

Skip this section if your trunks are configured to use digest authentication.
SIP trunks with IP authentication enabled cannot be used for inbound call routing, as they do not maintain registration with Wavix proxies. To set up inbound routing for your numbers, you must use a valid SIP URI address instead.
To configure inbound call routing to a valid SIP URI:
  1. Log in to your Wavix account
  2. Navigate to My numbers under the Numbers & trunks in the top menu
  3. Click on the three dots next to the number you want to edit (right-hand side) and select Edit number
  4. Select SIP URI in the Transport drop-down menu
  5. Enter a valid SIP URI in the following format: +[did]@FQDN:port;transport=connection, where:
    • a. FQDN is the fully qualified domain name or IP address of your Asterisk PBX
    • b. Port is the SIP port used by the PBX
    • c. A connection can be udp, tcp, or tls, with udp as the default transport
  6. Click Add to set the destination for the phone number
  7. Click Save to apply the settings
The [did] parameter will be automatically updated with the actual dialed phone number when routing the call.

​
Configure inbound calls in FreePBX

To configure inbound call routing:
  1. Sign in to your FreePBX instance.
  2. In the top menu, go to Connectivity → Inbound Routes.
  3. Select Add Inbound Route:
    • Specify the route Description
    • Set the DID Number, if needed
    • In Set Destination, choose where to route inbound calls from the Wavix trunk. This can be an IVR, extension, agent queue, or another destination.
  4. Select Submit to apply changes. FreePBX Inbound Route configuration
Leave DID Number blank to apply this route to any phone number on your Wavix account.

​
Troubleshooting outbound calls

  • 603 Declined response might be received when calling the destination with the per-minute rate higher than the Max call rate set for your account. You can find your effective Max call rate on the Trunks page. Please contact support@wavix.com to request a change to your Max call rate.
  • The destination phone number is in an incorrect format. Please make sure the number is dialed in the international E.164 format. Strip prefixes like 0, 00, or 011 before the dialed number if needed.