In this article
Configure the programmable softkey buttons
Parameters for programmable softkeys
Keywords
Configure the programmable softkeys (Control Hub)
list-menuIn this article
list-menuFeedback?

The programmable softkeys (PSKs) on phones provide quick access to features or applications. This Help article is for Cisco Wireless Phone 9821 registered to Webex Calling.

Configure the programmable softkey buttons

The softkeys can be found located at the bottom of the phone screen. You can associate the softykeys with a service to provide a quick access for users.

1

From the customer view in Control Hub, go to Devices, and then select your phone.

2

Select All configurations.

3

Navigate to the Phone section and select ProgrammableSoftkeysOnWirelessPhone.

4

Enable the Programmable Softkeys feature by setting Enable to Yes.

5

Enter required keywords for each parameter to associate a softkey with a specific service.

For more information on the parameters and softkey keywords, see Parameters for Programmable Softkeys and Keywords.
6

Select Next.

7

Review your changes and select Apply.

8

Select Close to close the page.

Parameters for programmable softkeys

Your phones come with default key list settings that provide access to features in different sates of the phone. When customizing the key lists, make sure to enter the correct keyword for the supported feature using the proper syntax.

A configured softkey may not take effect or appear if any of the following conditions are met:

  • The feature is disabled.
  • The feature isn't supported in the key list to which it's added.
  • An incorrect keyword is added.
  • An incorrect syntax is used.

Table 1. Cisco Wireless Phone 9821 programmable softkeys parameters
ParameterDefault and optionsDescription
Connected Key List

Default syntax:

hold;endcall;newcall;xfer;bxfer;phold;detail;

Configurable keywords:

hold, endcall, newcall, xfer, bxfer, phold, detail

Specifies the softkeys and the order in which they are available on the phone screen when a call is connected.

Dialing Input Key List

Default syntax:

delchar;call;cancel;abc;

Configurable keywords:

delchar, call, cancel, abc

Specifies the softkeys and the order in which they are available when a user must enter dialing data.

Enable

Default value: No

Options: Yes|No

Enables or disables the programmable softkeys. Set this field to Yes to enable the programmable softkeys.

Hold Key List

Default syntax:

resume;newcall;

Configurable keywords:

resume, newcall

Specifies the softkeys and the order in which they are available when one or more calls are on hold.

Idle Key List

Default syntax:

redial;newcall;cfwd;dnd;exit;

Configurable keywords:

redial, newcall, cfwd, dnd, exit

Specifies the softkeys and the order in which they are available when the phone is idle.

For example, the dnd keyword adds the DND softkey to the screen. On pressing, this softkey helps to turn on the DND mode.

Off Hook Key List

Default syntax:

redial;cancel;abc;cfwd;dnd;exit;

Configurable keywords:

redial, cancel, abc, cfwd, dnd, exit

Specifies the softkeys and the order in which they are available when the phone is on Off-Hook state.

PSK1 through PSK16

Default syntax: Empty

Programmable softkey fields. Enter a string in these fields to configure softkeys that display on the phone screen.

For example, to config the first softkey as a speed dial to number 2002:

Example syntax psk1:

fnc=sd;ext=2002@$PROXY;nme=John
Processing Key List

Default syntax:

endcall|2;

Configurable keywords:

endcall

Specifies the softkey that are available when a call is attempting to connect.

For example, the endcall|2 keyword adds the End call softkey to the screen.

Releasing Key List

Default syntax:

endcall|2;

Configurable keywords:

endcall

Specifies the softkeys available when a call is disconnecting.

Ringing Key List

Default syntax:

decline;answer;

Configurable keywords:

decline, answer

Specifies the softkeys available when a call is incoming.

For example, the answer|1;ignore|2; keywords add the Answer and Decline softkeys to the screen. A user can press these softkeys to either answer a call or decline a call when the phone rings.

Shared Active Key List

Default syntax:

newcall;barge;

Configurable keywords:

newcall, barge, bargesilent

Specifies the softkeys available when the phone is in Shared-Active state.

Shared Held Key List

Default syntax:

resume;barge;

Configurable keywords:

resume, barge

Specifies the softkeys available when the phone is on Hold or in Shared-Held state.

For example, the resume keyword adds the softkey Resume. User can press this softkey to resume a call that is on hold.

Start Transfer Key List

Default syntax:

cancel;xfer;

Configurable keywords:

cancel, xfer

Specifies the softkeys available when a call transfer has been initiated.

For example, the xfer keyword adds the Transfer softkey to the screen. A user can press this key to transfer a call when there is one connected call and one idle call.

Keywords

Table 2. Cisco Wireless Phone 9821 programmable softkeys keywords

Keyword

Key Label

Description

Phone state

abc

A B C

Switch to alphabet input

Off-Hook, Dialing Input

answer

Answer

Answers an incoming call.

Ringing

barge

Barge

Allows another user to interrupt a shared call.

Shared-Active, Shared-Held

bargesilent

BargeSlnt

Allows another user to join a shared line call silently, without the audible barge tone to other parties.

Shared-Active

bxfer

BlindXfer

Performs a blind call transfer (transfers a call without speaking to the party to whom the call is transferred). Requires that Blind Xfer Serv is enabled.

Connected

call

Call

Call the current number.

Dialing Input

cancel

Cancel

Cancels a call (for example, when transferring a call.

Off-Hook, Dialing Input, Start-Xfer

cfwd

Forward

Enter call forward settings.

Idle, Off-Hook

decline

Decline

Ignores an incoming call.

Ringing

delchar

delChar - backspace Icon

Deletes a character when entering text.

Dialing Input

detail

Details

Display call details.

Connected

dnd

DND

Sets Do Not Disturb to prevent calls from ringing the phone.

Idle, Off-Hook

endcall

End call

Ends a call.

Connected, Off-hook, Progressing, Releasing

exit

Exit

Exit from the current page.

Idle, Off-Hook

hold

Hold

Puts a call on hold.

Connected

newcall

New call

Begins a new call.

Idle, Hold, Shared-Active, Shared-Held, Connected

phold

PrivHold

Places the call on private hold so that other phones sharing the same line cannot see or retrieve that held call.

Connected

redial

Redial

Redial the last dialed number.

Idle, Off-Hook (no input)

resume

Resume

Resumes a call that is on hold.

Hold, Shared-Held

xfer

Transfer

Transfers a call.

Connected, Start-Xfer

Was this article helpful?
Was this article helpful?