Objective

Handling inbound calls to a voice-enabled virtual number.

Applies To

• Inbound Voice
• Virtual Numbers
• Call Forwarding

Procedure

You have three options for handling inbound calls to a Vonage API voice-enabled virtual number. You may forward the call to:

• A Voice API Application
• A voice-enabled PSTN number
• A SIP URI

Forward to Application

You can link a number to an application in your Vonage API account dashboard by selecting Link next to the number you want to associate with that application.

When we receive the call, we connect your call and run the parameters specified in your Nexmo Call Control Object (NCCO). You can play text-to-speech, stream audio files, create voicemails, start conferences, IVR menus, and much more. You can find example use cases in our documentation.

Forward to Phone

You can configure the forwarding number in your account dashboard by configuring the Voice Setting to Forward to Phone and entering a number in the E.164 format, without the international dialling access shortcut (+).

Forward to SIP

You can configure the forwarding address in your account dashboard by cofiguring the Voice Setting to Forward to SIP and entering the SIP URI using an IP address 123@201.354.123.456 or domain 1234@sipdomain.com. There is no authentication for inbound calls; however, you can limit the requests to our subnets.