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.

​
Receive calls with Wavix and LiveKit

​
Create LiveKit inbound trunk

  1. Sign in to your LiveKit project.
  2. In the left-hand side menu, select Telephony → Configuration.
  3. Select Create new and choose Trunk.
  4. Enter a comma‑separated list of Wavix numbers to associate with this trunk.
Configure LiveKit telephony screenshot
For instructions on creating a LiveKit inbound trunk using the CLI or code, see the LiveKit documentation.

​
Create a dispatch rule

Dispatch rules determine how inbound calls are routed to LiveKit rooms.
  1. Click Create new and select Dispatch rule.
  2. (Optional) Under Match trunks, associate the rule with a specific trunk; otherwise, it applies to all inbound calls in the project.
LiveKit dispatch rule screenshot
For more information about dispatch rules and instructions for creating them using the LiveKit CLI or code, see the LiveKit documentation.

​
Set up inbound call routing on Wavix

Wavix can route inbound calls to a SIP trunk on the platform, SIP URI, or forward them to a phone number. LiveKit requires calls to be routed to a SIP URI.
  1. In your LiveKit project, go to Settings → Project.
  2. Copy the value from SIP URI (e.g., sip:2mpbww13htk.sip.livekit.cloud).
LiveKit SIP URI screenshot To route calls from your Wavix number to the LiveKit platform:
  1. In Wavix, open Numbers & trunks → My numbers.
  2. Select your number by clicking the ⋯ menu → Edit number.
  3. Set the inbound call destination type to SIP URI, and enter the destination in the format of:
[did]@[LIVEKIT_SIP_URI]
In the example above, it would be: 
[did]@2mpbww13htk.sip.livekit.cloud
  1. Save your changes.
Make sure you entered the correct LiveKit SIP URI.
Now, all calls to your Wavix number are routed to your LiveKit AI project. Deploy a LiveKit agent to answer the calls. Check the LiveKit recipes for voice AI and LiveKit Agent use cases.
You can choose to encrypt call media. To enable encryption on your Wavix numbers, contact support@wavix.com and provide a list of numbers.

​
Place calls with Wavix and LiveKit

To place outbound calls, you need both a Wavix SIP trunk and a LiveKit outbound trunk.

​
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.

​
Create an outbound trunk on LiveKit

  1. Sign in to your LiveKit account.
  2. Go to Telephony → Configuration.
  3. Select Create new and replace the following variables:
    • Replace YOUR_SIP_TRUNK_ID and YOUR_SIP_TRUNK_PASSWORD with the SIP trunk credentials configured at Wavix.
    • Replace 61290597521 with the phone number purchased at Wavix.
LiveKit new trunk screenshot
For instructions on creating a LiveKit outbound trunk using the CLI or code, see the LiveKit documentation.
You can encrypt call media on your Wavix trunk. Contact support@wavix.com and provide your SIP trunk ID.
You’ve connected LiveKit with Wavix and now can place outbound calls. Check the LiveKit recipes for voice AI and LiveKit Agent use cases.

​
Transfer a call

Wavix supports using the SIP REFER command. To transfer a call, you need two Wavix numbers, one for an active call and one to receive the transferred call. Make sure inbound call routing is set up on the second number. To transfer an active LiveKit call, use the TransferSIPParticipant server API: 
import { SipClient } from 'livekit-server-sdk';
// ...
async function transferParticipant(participant) {
  console.log("transfer participant initiated");
  const sipTransferOptions = {
    playDialtone: false
  };

  const sipClient = new SipClient(process.env.LIVEKIT_URL,
                                  process.env.LIVEKIT_API_KEY,
                                  process.env.LIVEKIT_API_SECRET);

  const transferTo = "sip:+<YOUR_WAVIX_NUMBER>@<WAVIX_SIP_GATEWAY>"; // e.g., sip:+61290597520@au.wavix.net

  await sipClient.transferSipParticipant('open-room', participant.identity,
                                          transferTo, sipTransferOptions);
  console.log('transfer participant');
}
Replace transfer_destination with your Wavix number. Use the following formatsip:+[YOUR_WAVIX_NUMBER]@[WAVIX_SIP_GATEWAY] . Example: sip:+61290597520@au.wavix.net
Choose the primary Wavix gateway with the lowest ping from your location. A list of regional gateways is shown at the bottom of the Trunks page in the Wavix console.
Learn more about LiveKit call transfer in the LiveKit documentation.

​
Troubleshooting

  • 603 Declined can occur if the destination’s per‑minute rate is higher than your account’s Max call rate (check the value on the Trunks page). Contact support@wavix.com to request a change if needed.
  • 603 Declined can also occur if there is no active registration on your SIP trunk. Verify registration status as described above.
  • Wrong number format. Dial the full international E.164 number, e.g. 19085594899 (US) or 4408001218915 (UK). Do not dial local formats like 9085594899. Strip prefixes like 0, 00, or 011 before the dialed number.
⌘I