Create a webhook server

When an inbound call is received, Vonage makes a request to a publicly accessible URL of your choice - we call this the answer_url. You need to create a webhook server that is capable of receiving this request and returning an NCCO containing a connect action that will forward the call to the user's app. For this tutorial, the destination user is hardcoded to be Alice.

New project

Create a new project directory in a destination of your choice and change into it:

Inside the folder, initialize a new Node.js project by running this command:

Add dependencies

Next, install the required dependencies:

Create the server file

Inside your project folder, create a file named server.js and add the code as shown below - please make sure to replace SUBDOMAIN with an actual value. The value used will become part of the URLs you will set as webhooks in the next step.

'use strict';

const subdomain = 'SUBDOMAIN';

const express = require('express')
const app = express();
app.use(express.json());

app.get('/voice/answer', (req, res) => {
  console.log('NCCO request:');
  console.log(`  - caller: ${req.query.from}`);
  console.log(`  - callee: ${req.query.to}`);
  console.log('---');
  res.json([ 
    { 
      "action": "talk", 
      "text": "Please wait while we connect you."
    },
    { 
      "action": "connect",
      "from": req.query.from, 
      "endpoint": [ 
        { "type": "app", "user": "Alice" } 
      ]
    }
  ]);
});

app.all('/voice/event', (req, res) => {
  console.log('EVENT:');
  console.dir(req.body);
  console.log('---');
  res.sendStatus(200);
});

if(subdomain == "SUBDOMAIN") {
  console.log('\n\t🚨🚨🚨 Please change the SUBDOMAIN value');
  return false;
}
app.listen(3000);

const localtunnel = require('localtunnel');
(async () => {
  const tunnel = await localtunnel({ 
      subdomain: subdomain, 
      port: 3000
    });
  console.log(`App available at: ${tunnel.url}`);
})();

There are 2 parts in the server code above:

The Express server

The first part creates an Express server and makes it available locally on port 3000. The server exposes 2 paths:

1. /voice/answer is the answer_url we mentioned above. It sends back an NCCO as a JSON response containing information to connect to an application user.

2. The second one, /voice/event, you will set as destination for Vonage to notify you of everything happening during the call - - we call this the event_url.

The localtunnel integration

The second part of the server code above, exposes the Express server so it will be accessible by the Vonage servers.

Start the server

You can now start the server by running, in the terminal, the following command:

A notice will be displayed telling you the server is now available:

App available at: https://SUBDOMAIN.loca.lt

Please keep the terminal window handy as you will need the URL in the next step.