• Stars
    star
    371
  • Rank 111,515 (Top 3 %)
  • Language
    TypeScript
  • License
    Apache License 2.0
  • Created over 12 years ago
  • Updated about 2 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Vonage API client for Node.js. API support for SMS, Voice, Text-to-Speech, Numbers, Verify (2FA) and more.

Vonage Server SDK for Node.js

GitHub Workflow Status Codecov Latest Release Contributor Covenant License

Vonage

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:

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.

More Repositories

1

vonage-php-sdk-core

Vonage REST API client for PHP. API support for SMS, Voice, Text-to-Speech, Numbers, Verify (2FA) and more.
PHP
907
star
2

vonage-ruby-sdk

Vonage REST API client for Ruby. API support for SMS, Voice, Text-to-Speech, Numbers, Verify (2FA) and more.
Ruby
214
star
3

vonage-python-sdk

Vonage Server SDK for Python. API support for Voice, SMS, WhatsApp, Verify (2FA), Video Meetings and more.
Python
180
star
4

Grafana_Status_panel

A panel plugin for Grafana to monitor multiple parameters at once
TypeScript
175
star
5

vonage-php-sdk

Wrapper package to bring in the vonage/client-core code and an HTTP client
107
star
6

vonage-dotnet-sdk

Vonage REST API client for .NET, written in C#. API support for SMS, Voice, Text-to-Speech, Numbers, Verify (2FA) and more.
C#
104
star
7

vonage-java-sdk

Vonage Server SDK for Java. API support for SMS, Messages, Voice, Text-to-Speech, Numbers, Verify (2FA), Video and more.
Java
91
star
8

vonage-node-code-snippets

NodeJS code examples for using Vonage
JavaScript
66
star
9

vonage-go-sdk

A lightweight library to help Go users everywhere integrate with the Vonage APIs. Issues and PRs all really welcome!!
Go
50
star
10

vivid-3

Vonage's web UI 🎨 toolbelt
TypeScript
46
star
11

rxzu

RxZu Diagrams
TypeScript
41
star
12

vivid

Vonage's web UI 🎨 toolbelt
JavaScript
37
star
13

vonage-python-code-snippets

Python code examples for using Vonage communications APIs
Python
29
star
14

micro-frontends

TypeScript
28
star
15

vonage-laravel

Laravel Service Provider for integrating Vonage APIs
PHP
28
star
16

vonage-php-code-snippets

PHP code examples for using Vonage APIs
PHP
28
star
17

vonage-curl-code-snippets

Curl examples for working with Vonage APIs
Shell
24
star
18

gosrvlib

Go library to provide base service components
Go
19
star
19

vonage-cli

Vonage CLI tool.
TypeScript
16
star
20

vonage-java-code-snippets

Java code examples for using Vonage
Java
11
star
21

vonage-dotnet-code-snippets

.NET code samples for using Nexmo
C#
11
star
22

kafka-glue

Kafka Glue is a collection of libraries for kafka consumers and producers integrated with AWS Glue schema registry with RXJS to expose streaming of the kafka.
TypeScript
8
star
23

vonage-ruby-code-snippets

Ruby code examples for working with Vonage
Ruby
8
star
24

vbc-developer

Vonage Developer Portal documentation
HTML
6
star
25

vivid-react

Typescript friendly Reactjs :atom: wrappers/bindings for Vonage's web UI 🎨 toolbelt
JavaScript
5
star
26

acl-express

A stateless Access Control List middleware for Express
JavaScript
5
star
27

vonage-go-code-snippets

Repo of "howto" examples for using Vonage APIs with Go.
Go
4
star
28

cloud-runtime-cli

Vonage cloud runtime - CLI
Go
4
star
29

aws-systems-manager-toolkit

aws-systems-manager-toolkit is a Python library that provides wrapper tools around AWS Systems Manager functionality.
Python
3
star
30

verify-silent-auth-sdk-android

This SDK enables making a HTTP request over cellular even when on WiFi.
Kotlin
3
star
31

vonage-media-transformers-samples

Vonage Media Transformers Examples
TypeScript
3
star
32

video-express-plus-sample

This Repository demonstrates how to use Vonage Video Express Plus
HTML
2
star
33

sippy

A mirror of python-sippy b2bua library (and rtp_cluster): http://b2bua.org/
Python
2
star
34

vivid-bindings-vue

Fully automated typescript bindings generated for Vivid web components to be used in VueJS
TypeScript
2
star
35

vonage-python-jwt

A JWT Generator for Python. Creates JWTs for use with Vonage APIs.
Python
2
star
36

vivid-react-wrapper

A thin wrapper around an arbitrary custom HTML element to mitigate the gaps in :atom: React versions until 19.x
TypeScript
2
star
37

vscode

A Visual Studio Code extension for accessing the Vonage communication APIs.
TypeScript
1
star
38

api-specification

JavaScript
1
star
39

cli-plugin-scaffold

TypeScript
1
star
40

vonage-firebase-extensions

Firebase Extensions created by Vonage
JavaScript
1
star
41

vivid-design-tokens-properties

JavaScript
1
star
42

numkey

Numerical Encoding for Short Codes or E.164 LVN
C
1
star
43

exprees-socket-server

JavaScript
1
star