Skip to main content

​
Buy a phone number from Wavix

Before placing or receiving a call, you need to have an active phone number on your Wavix account. If you already have one, you can skip this section.
  1. Sign in to your Wavix account.
  2. Click on Buy under Numbers & trunks in the top menu.
  3. Select the country and region where you wish to purchase a number.
  4. Choose one or more numbers and click Buy now.
  5. Review the Cart and complete checkout.
Some numbers require proof of local address or other documents before activation. Upload any requested documents and wait for the Wavix Provisioning team to approve them before the numbers become active.

​
Create a SIP Trunk on the Wavix platform

  1. In the top menu, go to Numbers & Trunks → Trunks.
  2. Click Create new.
  3. Under Authentication Method, select Digest.
  4. Enter a SIP trunk name, set a SIP trunk password, and choose one of your numbers as the Caller ID.
  5. (Optional) Configure additional limits. If not specified, global account limits apply:
    • Max outbound call duration
    • Max number of simultaneous calls via the SIP trunk
    • Max call cost
  6. Click Create.
Once the SIP trunk is successfully created, it will appear in your account’s SIP trunks list. Configure SIP trunk screenshot
Your 5-digit SIP trunk username is generated automatically and shown in the SIP trunk ID column.

​
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 premise.
  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](## Enable IP Auth for the Wavix SIP trunk) 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.