• Stars
    star
    382
  • Rank 112,241 (Top 3 %)
  • Language
    TypeScript
  • License
    Apache License 2.0
  • Created about 13 years ago
  • Updated about 1 month 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
917
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
218
star
3

vonage-python-sdk

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

Grafana_Status_panel

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

vonage-php-sdk

Wrapper package to bring in the vonage/client-core code and an HTTP client
109
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#
106
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
97
star
8

vonage-node-code-snippets

NodeJS code examples for using Vonage
JavaScript
70
star
9

vivid-3

Vonage's web UI 🎨 toolbelt
TypeScript
54
star
10

vonage-go-sdk

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

vivid

Vonage's web UI 🎨 toolbelt
JavaScript
42
star
12

rxzu

RxZu Diagrams
TypeScript
41
star
13

vonage-laravel

Laravel Service Provider for integrating Vonage APIs
PHP
34
star
14

vonage-python-code-snippets

Python code examples for using Vonage communications APIs
Python
32
star
15

vonage-php-code-snippets

PHP code examples for using Vonage APIs
PHP
29
star
16

micro-frontends

TypeScript
27
star
17

vonage-curl-code-snippets

Curl examples for working with Vonage APIs
Shell
26
star
18

gosrvlib

Go library to provide base service components
Go
20
star
19

vonage-cli

Vonage CLI tool.
TypeScript
18
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

vonage-firebase-extensions

Firebase Extensions created by Vonage
JavaScript
3
star
30

sippy

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

aws-systems-manager-toolkit

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

verify-silent-auth-sdk-android

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

vonage-media-transformers-samples

Vonage Media Transformers Examples
TypeScript
3
star
34

numkey

Numerical Encoding for Short Codes or E.164 LVN
C
3
star
35

video-express-plus-sample

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

vonage-python-jwt

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

vivid-bindings-vue

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

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
39

vonage-client-sdk-ios

Swift
1
star
40

vscode

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

api-specification

JavaScript
1
star
42

cli-plugin-scaffold

TypeScript
1
star
43

vivid-design-tokens-properties

JavaScript
1
star
44

exprees-socket-server

JavaScript
1
star
45

vonage-jwt-jdk

Library to assist with generating JWT tokens in JVM-based languages for use with the Vonage API.
Kotlin
1
star
46

vonage-kotlin-sdk

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