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’ll need a Fonoster account. Sign up at https://app.fonoster.com/auth/signup
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.155Your 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.