Dial Button Macro

This Webex Device macro creates a single speed dial button on your devices touch interface.

Overview

This Webex Device macro programmatically adds a UI Extension button to your Webex Device and then listens for when it has been clicked. Once clicked, the macro will then dial the target number specified in the macros config. Below is an extract of the macros config, which lets you easily customise this macro on your device and for your use case.

const config = {
  targetNumber: '[email protected]', // The target number which will be dialled
  buttoName: 'Queue Button',        // The text displayed below the button
  buttonIcon: 'Helpdesk',           // The buttons icon, check UI Extention Editor for more options
  buttonColor: '#148579',           // The buttons color in Hex format
  panelId: 'queue-button'           // A unique panel Id so not to conflict with other buttons
}

With additional configuration, the Webex Devices other calling icons can also be removed so only your custom dial button is available.

Setup

Prerequisites & Dependencies:

• RoomOS/CE 9.6.x or above Webex Device.
• Web admin access to the device to upload the macro.

Installation Steps:

1. Download the dial-button.js file and upload it to your Webex Room devices Macro editor via the web interface.
2. Configure the Macro by changing the initial values, there are comments explaining each one.
3. Enable the Macro on the editor.
4. (Optional) - Hide all other native UI buttons and calling options, refer to these two device configurations:

• https://roomos.cisco.com/xapi/Configuration.UserInterface.Features.HideAll
• https://roomos.cisco.com/xapi/Configuration.RoomScheduler.Enabled

Validation

Validated Hardware:

• Room Kit Pro
• Desk Pro
• Desk Hub
• Room Kit

This macro should work on other Webex Devices but has not been validated at this time.

Demo

*For more demos & PoCs like this, check out our Webex Labs site.

License

All contents are licensed under the MIT license. Please see license for details.

Disclaimer

Everything included is for demo and Proof of Concept purposes only. Use of the site is solely at your own risk. This site may contain links to third party content, which we do not warrant, endorse, or assume liability for. These demos are for Cisco Webex use cases, but are not Official Cisco Webex Branded demos.

Questions

Please contact the WXSD team at [email protected] for questions. Or, if you're a Cisco internal employee, reach out to us on the Webex App via our bot ([email protected]). In the "Engagement Type" field, choose the "API/SDK Proof of Concept Integration Development" option to make sure you reach our team.