Skip to main content

Make a Hello World

You will need to Log In to your Fonoster account to access the Dashboard.

If you don't have one yet you will need to Sign up with GitHub to create a Fonoster account.

More of a visual learner? Watch the YouTube tutorial.

What you will need:

  • Fonoster Account
  • Node version 16 or above
  • Git

Check the versions by typing --version

git --version
node --version

Setting up our Node.js server

You need to clone this template with everything you need to create a voice application into your local environment.

  • You do not need a dedicated repository to clone it.

Run this command on your terminal

git clone

Go ahead and cd over the directory it made for you named nodejs-voiceapp.

Type into your terminal cd nodejs-voiceapp and install all the dependencies with: npm i or npm install

npm install 

Now you only need a couple more packages to install so run npm install -g ngrok

npm install -g ngrok

For Mac

brew install ngrok/ngrok/ngrok

And npm install --save-dev cross-env

npm install --save-dev cross-env

Now you are ready to start your server!!!

Type npm start into the terminal and hit enter.

npm start

A successful message will show you your server is up and running on port 3000.

Connecting our server to Fonoster

Open a new terminal window do not close the one you have with the server running and navigate towards the directory you created the server on.

To connect our server to Fonoster we need to first make the server public, to do this you need to type ngrok http 3000 and this will make ngrok listen to the port the server is on, port 3000.

ngrok http 3000

A successfull connection will show you the new HTTP URL where our server is up and running:

ngrokksuccess Highlighted yellow because you will need to use this link later on the tutorial.

Create a New Project using your Fonoster account

Without closing any of your open terminals, make your way over to your Fonoster account and create a new project to connect it to your newly created server. You can name it however you want.


Now, select the project you just created so we can have access to the Fonoster Dashboard.


Creating a New Trunk or Provider

Go to the SIP NETWORK tab and create a New Trunk

  • You don't need to have a Provider at this point , you can use placeholders for every input.
  • Set Providers Hostname or IPv4 to localhost and you are ready to click on Add Provider


Creating a New Number

The last step is to create a new number. Head back to the SIP NETWORK tab, select Number and New Number

  • You do not need a number, you can also create random ones that will serve as placeholders
  • First, select the PLACEHOLDER we created as our Provider in the previous step.
  • For Number you can use any number, this is a placeholder but for Webhook URL you need to open back your ngrok terminal and copy the link provided.


Go ahead and Create Number.

And now you are ready to make a test call


Now you will see on the bottom left side of the screen call in progress and that's it!

You've just created your first application using Fonoster 🎉

Need more help?