VoxeetSDK is the main object that allows the application to interact with Voxeet services. The SDK is asynchronous and uses promise at its core.



Staticget command(): CommandService

Retrieves the CommandService instance that allows the participant to send messages to the specified conferences.

Returns: CommandService


Staticget conference(): ConferenceService

Retrieves the ConferenceService instance that allows the participant to interact with conferences.

Returns: ConferenceService


Staticget filePresentation(): FilePresentationService

Retrieves the FilePresentationService instance that allows the participant to use file presentations.

Returns: FilePresentationService


Staticget mediaDevice(): MediaDeviceService

Retrieves the MediaDeviceService instance that allows the participant to interact with devices through the system.

Returns: MediaDeviceService


Staticget notification(): NotificationService

Retrieves the unique NotificationService instance,
which enables forwarding notifications from a developer to a properly registered manager.

Returns: NotificationService


Staticget recording(): RecordingService

Retrieves the RecordingService instance that allows the participant to record conferences.

Returns: RecordingService


Staticget session(): SessionService

Retrieves the SessionService instance that allows the participant to use sessions.

Returns: SessionService


Staticget videoFilters(): VideoFiltersService

Retrieves the VideoFiltersService instance that allows applying video filters on the local participant's video stream.

Returns: VideoFiltersService


Staticget videoPresentation(): VideoPresentationService

Retrieves the VideoPresentationService instance that allows the participant to use video presentations.

Returns: VideoPresentationService



Staticinitialize(customerKey: string, customerSecret: string): void

Initializes the SDK using the customer key and secret.


customerKeystringThe customer key.
customerSecretstringThe customer secret.

Returns: void


StaticinitializeToken(accessToken: string, callback: Function): void

Initialize the SDK with an access token that is provided by the customer backend communicating with Voxeet servers. The token allows securing the customer key and secret.

The following diagram presents the authentication flow:

Client          Customer Server       Voxeet Server
  |                    |                    |
  |  Get Access Token  |  /oauth2/token (1) |
  |    Access Token    |    Access Token    |
  |  initializeToken(accessToken, callback) |

The access token has a limited period of validity and needs to be refreshed for security reasons. In such case,
The Voxeet SDK will call the callback provided to initializeToken. The callback must return a Promise
containing the refreshed access token by calling the customer backend, as presented in the following diagram:

Client          Customer Server       Voxeet Server
  |      callback      |  /oauth2/token (2) |
  |    Access Token    |    Access Token    |

Where (1) and (2) are two REST API endpoints available on Voxeet servers and documented on the developer portal.


accessTokenstringThe access token provided by the customer's backend.
callbackFunctionA callback that returns a promise when the access token needs to be refreshed. The callback parameter takes the isExpired boolean parameter to check if the previous token has expired.

Returns: void

Did this page help you?