Connect an inbound call

In this code snippet you see how to connect an inbound call to another person by making an outbound call.

Example

Replace the following variables in the example code:

KeyDescription
VONAGE_VIRTUAL_NUMBER

Your Vonage Number. E.g. 447700900000

VOICE_TO_NUMBER

The recipient number to call, e.g. 447700900002.

Prerequisites

npm install express

Write the code

Add the following to connect-an-inbound-call.js:

const Express = require('express');

const app = new Express();

const onInboundCall = (_, response) => {
  const ncco = [
    {
      action: 'connect',
      from: VONAGE_VIRTUAL_NUMBER,
      endpoint: [
        {
          type: 'phone',
          number: VOICE_TO_NUMBER,
        },
      ],
    },
  ];

  response.json(ncco);
};

app.get('/webhooks/answer', onInboundCall);

app.listen(port, () => {
  console.log(`Example app listening on port ${port}`);
});

View full source

Run your code

Save this file to your machine and run it:

node connect-an-inbound-call.js

Try it out

You'll need to expose your server to the open internet. During development, you can use a tool like Ngrok to do that.

When you call your Vonage Number you will automatically be connected to the number you specified in place of VOICE_TO_NUMBER.

Further Reading

  • Interactive Voice Response (IVR) - Build an automated phone system for users to input information with the keypad and hear a spoken response.
  • Voice Bot with Google Dialogflow - This guide will help you to start with an example Dialogflow bot and interact with it from phone calls using provided sample reference codes using Vonage Voice API.
  • Masked Calling - Enable users to call each other, keeping their real numbers private.
  • Conference Calling - This guide explains the two concepts Vonage associates with a call, a leg and a conversation.
  • Call Tracking - Keep track of which campaigns are working well by using different numbers for each one and tracking the incoming calls. This guide shows you how to handle incoming calls, connect them to another number, and track the phone numbers that called each of your Vonage numbers.