Browser Click-to-Call links
Last updated January 8, 2021
StarLeaf allows browser-based video calling.
You can create links that, when clicked, cause a browser-based video call to be initiated. These links are URLs. To create the correct URL, you need to know the video address of the entity that you want the link to call. For example, this could be a user registered to StarLeaf, a video endpoint registered to the StarLeaf platform, a hunt group within an organization on the StarLeaf platform, or a conference scheduled with StarLeaf.
URLs can only be sent over the Internet using the ASCII character-set. Video addresses often contain characters outside the ASCII set. Therefore, you must convert the video address into a valid ASCII format. For example the at sign () becomes .
You can find information and tools online to help you to do this (for example: https://www.w3schools.com/tags/ref_urlencode.asp )
To use Click-to-Call, video callers need the latest browser version of one of the following:
- Google Chrome
- Mozilla Firefox
- Microsoft Edge
StarLeaf does not support legacy browser versions and Safari is not supported. Browsers running on iOS (iPhone and iPad) do not support any WebRTC. Therefore, you cannot use Click-to-Call on these devices.
If you want to create a browser link to call a hunt group, the link has the format:
For example, a link that calls the Xampleco technical support team could be:
An example link to call your sales team hunt group with the video address firstname.lastname@example.org would be:
If you want to create a browser link to call into a conference, the link has the format:
For example, a link that calls a StarLeaf demo conference (that has conference number 7789634) is:
You can create a browser link that makes a point-to-point video call from a browser to a StarLeaf user. Note that the target endpoint does not need to be a StarLeaf endpoint, but it does need to be an endpoint that is registered with the StarLeaf platform. To create the link, you need to know the email address with which the user is registered with StarLeaf.
The link has the format:
When you create the URL, you must URL-encode the email address.
For example, to call Alexis Reena at Xampleco, the link looks like this:
Users can use such a link in their email signatures.
You can create a browser link that makes a point-to-point video call from a browser to a room system. Note that the target endpoint does not need to be a StarLeaf endpoint, but it does need to be an endpoint that is registered with the StarLeaf platform. The link uses the video address of the room system, which is in the format:
The link has the format:
When you create the URL, you must URL-encode the video address of the room system.
For example, to call a room system in your organization, where the video address of the meeting room is, the link looks like this:
When you are creating links, you can add additional parameters to set the language of the browser page and to set the name with which the participant makes the call.
- Locale: To set the language of the page, use the locale parameter
For a list of available locale codes, refer to Locales. If you do not set a locale, the language defaults to US English.
- Name: To set a participant name, use the name parameter
- Read-only name: To set an uneditable participant name, instead of name, use the roname parameter (a read-only version of the name parameter)
For example, you can see in the picture below that the language of the page is English and the participant name has been preset to Carolina.
If you are creating a link that sets the participant’s language to be a language other than your own and you have previously used the StarLeaf Portal in your own language, when you test the link, the Portal shows you your own language as there is a cookie in your browser that controls language. To test the link, use an alternative browser/computer.
For a conference link using additional parameters, the format of the link is:
For example, to dial into the demo conference with participant nameand with the browser page in , the link is:
For example, to dial into the demo conference with the read-only participant name Sarah and with the browser page in French, the link is:
For a hunt group link using additional parameters, the format of the link is:
For example, to dial the Xamplecp technical support team with participant name Sarah and with the browser page in German, the link is: