How does it work
With custom webpages, Ringotel administrators have the ability to set up web links for users to access within their Ringotel app.
These added web links will be listed in the Menu tab of the Ringotel app, positioned under the user's extension number. Administrators can add any number of custom web pages.
How to configure
In your Ringotel admin portal, navigate to the Connection settings β Features tab, then scroll down to the Custom Web Pages section.
Click v Add button and fill in the following fields:
Title - a short name of a web page;
URL - a URL to open;
Click + Add button.
Repeat the above steps with as many pages as needed.
Click Save changes.
Tip: Drag-and-drop items in a list to change their order.
You can use the following parameters in the URL:
$userid$ - softphone user ID
$domain$ - organization domain
$number$ - extension number
$username$ - username
$email$ - user email address
$mobile$ - user mobile number
Create custom parameters for advanced URL personalisation
In addition to default parameters, you can create custom parameters in the Ringotel user's settings or via the API.
Add custom parameters via the Admin portal
To create custom parameters via the admin portal, open the user's menu > More > Custom parameters.
Add parameters by specifying its key and value, then click Save changes.
Add custom parameters via the API
To add a custom parameters via the Admin API, use the updateUser
API method by passing the custom parameters within the custom
object.
{
"method": "updateUser",
"params": {
"id": "17097397378921051839",
"orgid": "17068724888871308748",
"custom": {
"id": "1234-5678-9012",
"key": "qwerwterer234346467"
}
}
}
Subsequently, you can utilise these custom user parameters in the Custom webpages or Screen pop-up URLs as follows:
https://example.com?id=$id$&key=$key$
This will open the URL with substituted values:
https://example.com?id=1234-5678-9012&key=qwerwterer234346467
β
β