Vonage Server SDK for Node.js
This is the Node.JS Server SDK for Vonage APIs. To use it you will need a Vonage account. Sign up for free at vonage.com.
For full API documentation refer to developer.vonage.com.
Installation
With NPM
npm install @vonage/server-sdk
With Yarn
yarn add @vonage/server-sdk
Constructor
const { Vonage } = require('@vonage/server-sdk');
const vonage = new Vonage(credentials, options);
Where credentials
is any option from @vonage/auth
, and options
is any option from @vonage/server-client
Promises
Most methods that interact with the Vonage API uses Promises. You can either resolve these yourself, or use await
to wait for a response.
const resp = await vonage.sms.send({
to: '15552220000',
from: '15559992222',
text: 'This is a test',
});
Testing
Run:
npm run test
Or to continually watch and run tests as you change the code:
npm run test-watch
Examples
See the Vonage Node Quickstarts repo.
References
You can find more information for each product below:
- Accounts
- Applications
- Audit
- Auth
- JWT
- Messages
- Number Insights
- Numbers
- Pricing
- Server Client
- Server SDK
- SMS
- Sub Accounts
- Verify
- Verify V2
- Vetch
- Video
- Voice
Supported APIs
The following is a list of Vonage APIs and whether the Node Server SDK provides support for them:
API | API Release Status | Supported? |
---|---|---|
Account API | General Availability | β |
Alerts API | General Availability | |
Application API | General Availability | |
Audit API | Beta | β |
Conversation API | Beta | β |
Dispatch API | Beta | β |
External Accounts API | Beta | |
Media API | Beta | |
Messages API | Beta | |
Number Insight API | General Availability | β |
Number Management API | General Availability | |
Pricing API | General Availability | |
Proactive Connect API | Beta | |
Redact API | Developer Preview | |
Reports API | Beta | β |
SMS API | General Availability | β |
Sub Accounts | Beta | |
Users | General Availability | |
Verify API | General Availability | |
Verify v2 API | General Availability | |
Voice API | General Availability |
V2 Migrations
While most of the V2 functions have been ported into their own package, some of the functions have not been ported or were removed. Below is a list of those changes:
V2 Function | Status | Note |
---|---|---|
vonage.conversion |
REMOVED | |
vonage.conversation |
Not Implemented | This was only released as a beta package |
vonage.app |
REMOVED | Moved to Applications |
vonage.files |
Not ported | Has not been ported to V3 at this time |
vonage.message |
Moved | Moved to SMS |
vonage.generateJwt |
Moved | Was moved to JWT |
vonage.generateSignature |
Not Ported | Has not been ported to V3 at this time |
vonage.calls |
Moved | Was moved to Voice |
vonage.credentials |
Updated | Options can be found in [Server Client][server-client] |
vonage.options |
Updated | Options can be found in [Server Client][server-client] |
vonage.options.httpClient |
Removed | |
vonage.options.userAgent |
Not Ported | Has not been ported to V3 at this time |
For more information, check out each packages migration guide.