Rate this page:

How to call a user

Voximplant supports calls from any endpoint to the cloud and from the cloud to any endpoint including non-PSTN endpoints: Web pages with our Web SDK, Android and iOS devices with our mobile SDKs, and SIP-enabled software or hardware devices. For this purpose, we create users and use their credentials.

Users can be created programmatically via the HTTP API or the control panel: switch to the Users tab in the application and either click Create in the center of the screen or Create user in the upper right corner.

So, once there is a user in our app, we can call him or her using the callUser method in the scenario associated with the same application. The method can trigger the CallEvents.Failed event after 60 sec.

One user or two?

Note that this user should be logged in on some Web/Mobile client. If you call to the cloud from PSTN, one user is enough. If you want to call this user without using PSTN, you have to create another user in the same application and initiate a call from it; in this way, one user will call another. Similarly, both users should be logged in on different clients.


Username (the name of the Voximplant user to call) is the only required parameter here. The other parameters are optional, but we recommend that you specify callerid as well. If you don't do it, the call will be displayed as anonymous.

Normally callerid is some phone number to use for callback, but in the callUser and callUserDirect methods it can be any string.

Find all the available parameters in the CallUserRequest object.

Usage sample

Usage sample

Put this code to your Voximplant scenario


This is how you can call users of the application from within SDKs. And don't forget to request microphone permission if it hasn't been already given by the user.

call user from within SDK

call user from within SDK