- Home
- /
- Article
Thanks for your feedback.
In this article
Feedback?This Help article is for Cisco Wireless Phone 9821 registered to Cisco Unified Communications Manager (Unified CM).
The Action button is the red button located at the right side of Cisco Wireless Phone 9821. It allows users to quickly access designated services, such as emergency or custom services. You can custom the button to initiate events that suit your specific use cases.
Customize the Action button
| 1 |
In Cisco Unified Communications Manager Administration, do one of the following actions as needed:
The configuration follows a hierarchical structure:
|
| 2 |
Customize the Action button parameters based on your use cases. There are three groups of parameters for the Action button, each corresponding to a service with a unique trigger. If a service trigger is specified in multiple groups, the settings in Group 1 take priority over those in Group 2 and 3, while Group 2 takes priority over Group 3. For more information about these parameters, see Product specific configuration parameters. |
| 3 |
Select Save. |
| 4 |
Select Apply Config. |
Emergency calls parameter settings
Configure the following parameters for emergency calls.
|
Parameter |
Settings |
|---|---|
|
Action Button Function |
Select Emergency Call. |
|
Action Button Service Destination |
Enter the phone number or the URI of the emergency service. |
|
Action Button Service Name |
(Optional) Specify a name for the service associated with the trigger. This name
will be displayed in the on-screen message when the user presses the button,
indicating which service will be triggered. When no name is specified,
|
|
Dial Out Delay |
Set the timeout period, in seconds, for the phone to initiate an event after detecting the trigger. The default value is 5 seconds. When set to 0, the event is initiated immediately upon trigger detection. The delay screen displays a countdown timer, allowing the user to cancel the action triggered by the Action button. During emergency call scenarios, Cisco Wireless Phone 9821 vibrates continuously while the delay screen is displayed. However, for silent emergency calls or signals, Cisco Wireless Phone 9821 does not vibrate. |
|
Service Trigger |
Select a trigger from the list: Single Press, Long Press, or Press 3 Times. |
|
Silent Emergency Call |
(Optional) By default, the emergency call functions as a two-way call, similar to other outgoing calls. When silent emergency call is enabled, the audio is silent on the caller side to avoid drawing attention during the onging call. Only the call recipient can end the silent emergency call. During a silent emergency call, the Cisco Wireless Phone 9821screen will be turned off. All other functions are inaccessible. The phone restores normal operation after the recipient ends the call. |
|
Allow Silent Emergency Call Retrieval |
(Optional) Enable this feature if you allow users to press any key to restore normal phone operation while maintaining the emergency call. The call audio remains silent unless the user increases the speaker volume using the Volume key. |
Custom services parameter settings
Configure the following parameters for custom services.
|
Parameter |
Settings |
|---|---|
|
Action Button Function |
Select Custom. |
|
Action Button Service Destination |
Enter the URL of the custom service. The URL must start with
|
|
Action Button Service Name |
(Optional) Specify a name for the service associated with the trigger. This name will be displayed in the on-screen message when the user presses the button, indicating which service will be triggered. When no name is specified, Custom service will be used as the display name. |
|
Custom Content Field |
(Optional) If you want to enable the phone to send an HTTP Post request when the Action button is pressed, enter the HTTP data such as method, header, and post content, with a maximum length of 1024 characters. For POST script examples and the syntax, see HTTP Post request for the Action button. |
|
Dial Out Delay |
Set the timeout period, in seconds, for the phone to initiate an event after detecting the trigger. The default value is 5 seconds. When set to 0, the event is initiated immediately upon trigger detection. The delay screen displays a countdown timer, allowing the user to cancel the action triggered by the Action button. During custom services scenarios, Cisco Wireless Phone 9821 vibrates continuously while the delay screen is displayed. |
|
Service Trigger |
Select a trigger from the list: Single Press, Long Press, or Press 3 Times. |
|
Service Secret |
Set a secret string which can be an authentication secret, token or password. The
entered secret is displayed as a masked string and can be referenced using the
macro |
Multiple triggers parameter settings
Set the parameters in each group respectively. See the Emergency calls and Custom services sections above.
A single trigger for multiple events parameter settings
Configure the following parameters to assign multiple events to a trigger.
|
Parameter |
Settings |
|---|---|
|
Action Button Function |
Select Custom. |
|
Action Button Service Destination |
Enter the phone number to call and the XML service URL in this format:
The URL must start with Example:
|
|
Action Button Service Name |
(Optional) Specify a name for the service associated with the trigger. This name will be displayed in the on-screen message when the user presses the button, indicating which service will be triggered. When no name is specified, Custom service will be used as the display name. |
|
Custom Content Field |
(Optional) If you want to enable the phone to send an HTTP Post request when the Action button is pressed, enter the HTTP data such as method, header, and post content, with a maximum length of 1024 characters. For POST script examples and the syntax, see HTTP Post request for the Action button. |
|
Dial Out Delay |
Set the timeout period, in seconds, for the phone to initiate an event after detecting the trigger. The default value is 5 seconds. When set to 0, the event is initiated immediately upon trigger detection. The delay screen displays a countdown timer, allowing the user to cancel the action triggered by the Action button. During emergency call and custom services scenarios, Cisco Wireless Phone 9821 vibrates continuously while the delay screen is displayed. However, for silent emergency calls or signals, Cisco Wireless Phone 9821 does not vibrate. |
|
Service Trigger |
Select a trigger from the list: Single Press, Long Press, or Press 3 Times. |
|
Service Secret |
Set a secret string which can be an authentication secret, token or password. The
entered secret is displayed as a masked string and can be referenced using the
macro |
|
Silent Emergency Call |
(Optional) By default, the emergency call functions as a two-way call, similar to other outgoing calls. When silent emergency call is enabled, the audio is silent on the caller side to avoid drawing attention during the onging call. Only the call recipient can end the silent emergency call. During a silent emergency call, the Cisco Wireless Phone 9821screen will be turned off. All other functions are inaccessible. The phone restores normal operation after the recipient ends the call. |
|
Allow Silent Emergency Call Retrieval |
(Optional) Enable this feature if you allow users to press any key to restore normal phone operation while maintaining the emergency call. The call audio remains silent unless the user increases the speaker volume using the Volume key. |
HTTP Post request for the Action button
The Action button on Cisco Wireless Phone 9821 can be configured to trigger XML applications through HTTP Post requests.
In Custom Content Field, enter your customized request script. You
can specify either XML or JSON content type and include macros in the request. For example,
$SScan be added to the script to retrieve the authentication secret,
token, or password provided in the Service Secret field.
The following examples are in XML and JSON:
Sample #1: XML
--method POST
--header 'Content-Type: application/xml'
--header 'Authorization: Bearer username:$SS'
--body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>'
Sample #2: JSON
--method POST
--header 'Content-Type: application/json'
--header 'Authorization: $SS'
--body '{"events":[{"evtid":"12345", "parameters": {"trigger":true}, "Description":"This is for HTTP POST JSON"}]}' Cisco Unified CM requires percent encoding for the reserved characters in accordance with RFC 3986.
| Character | Percent encoding |
|---|---|
| & | %26 |
| ' | %27 |
| " | %22 |
| < |
%3c |
| > |
%3e |
The following script is an example using percent-encoded strings.
--method POST
--header %27Content-Type: application/xml%27
--body %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3eThis is for HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27| Macro name | Macro expansion |
|---|---|
| #DEVICENAME# | The device name displayed in the calling system. For example, SEP845A3EC21288 |
| $SS | Service Secret which presents a masked string in the phone configuration page, such as authentication secret, token, or password. |
