JavaScript

Create your Vonage Application

In this step you will create a Vonage Application capable of in-app voice communication use cases.

Open a new terminal and, if required, navigate to your project directory.

Create a Vonage application by copying and pasting the command below into terminal:

vonage apps create 'Your application'

✅ Creating Application
Saving private key ... Done!
Application created

Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set

Capabilities:
  None Enabled

Now that your Vonage Application has been created, update your CLI auth with the Application ID and Private Key:

vonage auth set `
--local `
--api-key='your-api-key' `
--api-secret='your-api-secret' `
--app-id='your-application-id' `
--private-key=C:\path\to\private.key

API Key: your-api-key
API Secret: your-**************
App ID: your-application-id
Private Key: Is Set

✅ Checking API Key Secret
✅ Checking App ID and Private Key

Next, configure the webhooks on your Vonage Application. Make sure to change the values of --voice-answer-url and --voice-event-url arguments, by replacing the URLs with https://SUBDOMAIN.loca.lt/voice/answer and https://SUBDOMAIN.loca.lt/voice/event respectively. SUBDOMAIN is the actual value used in the previous step:

vonage apps capabilities update 00000000-0000-0000-0000-000000000000 voice `
  --voice-answer-url='https://example.com/webhooks/voice/answer' `
  --voice-event-url='https://example.com/webhooks/voice/event' `
  --voice-fallback-url='https://example.com/webhooks/voice/fallback'
  
✅ Fetching Application
✅ Adding voice capability to application 00000000-0000-0000-0000-000000000000

Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set

Capabilities:
 VOICE:
    Uses Signed callbacks: On
    Conversation TTL: 41 hours
    Leg Persistence Time: 6 days
    Event URL: [POST] https://example.com/webhooks/voice/event
    Answer URL: [POST] https://example.com/webhooks/voice/answer
    Fallback URL: [POST] https://example.com/webhooks/voice/fallback

NOTE: Information about your application, including the Application ID, can also be found in the Dashboard.

Making an in-app voice call

Make a voice call from a web app to a phone using the JavaScript Client SDK.

Steps
1
Introduction
2
Prerequisites
3
Create a webhook server
4
Create a Vonage Application
5
Link a Vonage number
6
Create a User
7
Generate a JWT
8
Install Client SDK
9
Create a client side application
10
Run your application
11
What's next?