This guide will walk you through connecting your SIP provider to Fonoster by setting up authentication, configuring a SIP trunk, and creating your virtual number. Follow the steps below to link any virtual number to your application.

For Twilio numbers, consider using the dedicated command fonoster sipnet:numbers:linkTwilioNumber for a simplified process.

1

Request early access

To get started, you need to request early access to Fonoster. You can do this by visiting the GitHub Discussions and following the instructions.

2

Set Up Authentication (If required)

If your VoIP provider requires SIP authentication, run the following command and follow the interactive prompts:

fonoster sipnet:credentials:create

Before running this command, please request the necessary credentials from your provider.

If your provider uses static IP authentication, provide them with the following IP address:

165.22.7.155

Your provider will use it to verify the origin of the signaling.

3

Configure Your SIP Trunk

Before creating your trunk, verify with your provider the preferred transport protocol (e.g., TCP or UDP). Use the same protocol when specifying your Outbound URI. Use the following command to create your trunk:

fonoster sipnet:trunks:create

Follow the prompts to complete the configuration. Ensure your Inbound URI ends with .sip.fonoster.com. For example, if your company is Acme Corp, you might use acme.sip.fonoster.com

Inbound URIs are globally unique. If you receive an error, please try using a different value.

4

Create and Verify Your Virtual Number

With your trunk in place, create a virtual number to route incoming SIP traffic. Execute the command below:

fonoster sipnet:numbers:create

You will be prompted for the details of your virtual number. Ensure that this number exactly matches the value your provider sends in the FROM header of the SIP traffic. Any discrepancy may prevent proper traffic matching.

If you encounter an error such as “Number already exists,” please contact the Fonoster support team. They will help resolve any conflicts with existing numbers.

Finally, to check that your virtual Number has been linked successfully by listing your Numbers with:

fonoster sipnet:numbers:list

Once the Number is linked, try calling it to ensure the voice application is accessible.