Vonage Client SDK

The Client SDK is intended to provide a ready solution for developers to build Programmable Conversation applications across multiple Channels including: Messages, Voice, SIP, websockets, and App.

> ⚠️ Warning: Chat Functionality (Deprecated)
>
> The chat functionality in our SDK is now deprecated and is scheduled for removal by the end of April 2026. While it remains available for the time being, we recommend avoiding the introduction of new dependencies on this feature. Existing methods may change or become unsupported as we progress toward its sunset. If you rely on this functionality, please begin planning your migration. Your feedback remains welcome during this transition period.

Installation

The SDK can be installed using the npm install command

``bash
npm i @vonage/client-sdk
`

SDK setup

$3

`js
import {
VonageClient,
ClientConfig,
ConfigRegion,
LoggingLevel
} from '@vonage/client-sdk';
import { useState, useEffect } from 'react';

function App() {
const [config] = useState(() => new ClientConfig(ConfigRegion.AP));
const [client] = useState(() => {
// Initialize client with optional config (default: ERROR logging, US region).
const client = new VonageClient({
loggingLevel: LoggingLevel.DEBUG,
region: ConfigRegion.EU
});
// Or update some options after initialization.
client.setConfig(config);
return client;
});
const [session, setSession] = useState();
const [user, setUser] = useState();
const [error, setError] = useState();

// Create Session as soon as client is available
useEffect(() => {
if (!client) return;
client
.createSession('my-token')
.then((session) => setSession(session))
.catch((error) => setError(error));
}, [client]);

// Get User as soon as a session is available
useEffect(() => {
if (!client || !session) return;
client
.getUser('me')
.then((user) => setUser(user))
.catch((error) => setError(error));
}, [client, session]);

if (error) return

{JSON.stringify(error)}

export default App;
`

$3

`html




`

$3

`js
import {
VonageClient,
ConfigRegion,
LoggingLevel
} from 'https://cdn.jsdelivr.net/npm/@vonage/client-sdk@1.0.0/dist/vonageClientSDK.esm.min.js';

// Initialize client with optional config (default: ERROR logging, US region).
const client = new VonageClient({
loggingLevel: LoggingLevel.DEBUG,
region: ConfigRegion.EU
});

// Or update some options after initialization.
client.setConfig({
region: ConfigRegion.AP
});

(async () => {
const token = 'my-token';
try {
// Create Session
const sessionId = await client.createSession(token);
// Get User
const user = await client.getUser('me');
console.log(
User ${
user.displayName || user.name
} logged in with session ID: ${sessionId}
);
} catch (error) {
// Log errors for either createSession or getUser
console.error(error);
}
})();
`

Example Usage

Below are several typical scenarios where the SDK is commonly utilized.

$3

`ts
const context = {
callee: 'user1'
};

const callId = await client.serverCall(context);
`

$3

`ts
client.on('callInvite', async (callId, from, channelType) => {
console.log(Received call invite from ${from} on ${channelType});

// Accept the call
await client.answer(callId);

// Reject the call
await client.reject(callId);
});

client.on('callInviteCancel', (callId, reason) => {
if (reason === CancelReason.AnsweredElsewhere) {
console.log(Call ${callId} was answered elsewhere);
} else if (reason === CancelReason.RejectedElsewhere) {
console.log(Call ${callId} was rejected elsewhere);
} else if (reason === CancelReason.RemoteCancel) {
console.log(Call ${callId} was cancelled by the caller);
} else if (reason === CancelReason.RemoteTimeout) {
console.log(Call ${callId} timed out);
}
});
`

$3

`ts
client.on(
'callHangup',
(callId: string, callQuality: RTCQuality, reason: HangupReason) => {
if (reason == 'LOCAL_HANGUP') {
console.log(Call ${callId} was hung up locally);
} else if (reason == 'REMOTE_HANGUP') {
console.log(Call ${callId} was hung up remotely);
} else if (reason == 'REMOTE_REJECT') {
console.log(Call ${callId} was rejected remotely);
} else if (reason == 'REMOTE_NO_ANSWER_TIMEOUT') {
console.log(Call ${callId} timed out);
} else if (reason == 'MEDIA_TIMEOUT') {
console.log(Call ${callId} timed out);
} else {
exhaustiveCheck(reason);
}
}
);
`

$3

`ts
const { conversations, nextCursor, previousCursor } =
await client.getConversations({
order: PresentingOrder.DESC,
pageSize: 10,
cursor: undefined,
includeCustomData: true,
orderBy: OrderBy.CUSTOM_SORT_KEY
});
`

$3

`ts
const timestamp = await client.sendMessageTextEvent(
'CONVERSATION_ID',
'Hello World!'
);
`

$3

`ts
const eventHandler = (event: ConversationEvent) => {
if (event.kind == 'member:invited') {
console.log(Member invited: ${event.body.memberId});
} else if (event.kind == 'member:joined') {
console.log(Member joined: ${event.body.memberId});
} else if (event.kind == 'member:left') {
console.log(Member left: ${event.body.memberId});
} else if (event.kind == 'ephemeral') {
console.log(Ephemeral event: ${event.body});
} else if (event.kind == 'custom') {
console.log(Custom event: ${event.body});
} else if (event.kind == 'message:text') {
console.log(Text message: ${event.body.text});
} else if (event.kind == 'message:custom') {
console.log(Custom message: ${event.body.customData});
} else if (event.kind == 'message:image') {
console.log(Image message: ${event.body.imageUrl});
} else if (event.kind == 'message:video') {
console.log(Video message: ${event.body.videoUrl});
} else if (event.kind == 'message:audio') {
console.log(Audio message: ${event.body.audioUrl});
} else if (event.kind == 'message:file') {
console.log(File message: ${event.body.fileUrl});
} else if (event.kind == 'message:vcard') {
console.log(Vcard message: ${event.body.vcardUrl});
} else if (event.kind == 'message:location') {
console.log(Location message: ${event.body.location});
} else if (event.kind == 'message:template') {
console.log(Template message: ${event.body.template});
} else if (event.kind == 'event:delete') {
console.log(Template message: ${event.body});
} else if (event.kind == 'message:seen') {
console.log(Template message: ${event.body});
} else if (event.kind == 'message:delivered') {
console.log(Message delivered event: ${event.body});
} else if (event.kind == 'message:rejected') {
console.log(Message rejected event ${event.body});
} else if (event.kind == 'message:submitted') {
console.log(Message delivered event ${event.body});
} else if (event.kind == 'message:undeliverable') {
console.log(Message undeliverable event ${event.body});
} else {
exhaustiveCheck(event);
}
};

const listener = client.on('conversationEvent', eventHandler);

client.off('conversationEvent', listener);
``

Documentation and examples

Visit Vonage website

License

Copyright (c) 2023 Vonage, Inc. All rights reserved. Licensed only under the Vonage Client SDK License Agreement (the "License") located at LICENSE.

By downloading or otherwise using our software or services, you acknowledge that you have read, understand and agree to be bound by the Vonage Client SDK License Agreement and Privacy Policy.

You may not use, exercise any rights with respect to or exploit this SDK, or any modifications or derivative works thereof, except in accordance with the License.