- Home
- /
- Article
Programmable softkeys configuration
This Help article is for Cisco Desk Phone 9800 Series and Cisco Video Phone 8875 registered to Cisco BroadWorks or Webex Calling.
Customize phone programmable softkeys
You can customize the softkeys displayed on the phone. Some of the the default softkeys (when the phone is in an idle state) are Call, Recents, Forward, and DND. Other softkeys are available during specific call states (for example, if a call is on hold, the Resume softkey displays).
You can define the parameters under Programmable Softkeys section with keywords and assign a service to the softkey to provide user easy access to the service. The customized 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 |
Access the phone administration web page. |
2 |
Select . |
3 |
In the Programmable Softkeys section, set the Programmable Softkey Enable to Yes. |
4 |
Edit the softkeys by entering specific keywords depending on the call state that you want the softkey to display. In the Programmable Softkeys section, each phone state is displayed and the softkeys that are available to display during that state are listed. Each softkey is separated by a semicolon. Softkeys are shown in the format: softkeyname|[position]
For more information on the PSK parameters (phone state), see Programmable softkeys parameters. For more inforamtion on the softkeys and the related keywords, see Programmable softkeys. |
5 |
Click Submit All Changes. |
Programmable softkeys parameters
For more information on the keywords and related softkeys, see Programmable softkeys.
Parameter |
Default and Syntax |
Description |
---|---|---|
Programmable Softkey Enable |
Default: No Options: Yes|No |
Enables programmable softkeys. |
PSK 1 through PSK16 |
Default: Empty Syntax:
|
Programmable softkey fields. Enter a string in these fields to configure softkeys that display on the phone screen. For example, you can create softkeys for speed dials to numbers or extensions, vertical service activation codes (* codes), and PSK with DTMF support. Speed dial PSK, see Configure Speed Dial on a programmable softkey. DTMF PSK, see Configure a PSK with DTMF support. When you add a programmable softkey to a softkey list, such as Idle Key List, and so on, the programmable softkey displays on the phone screen. |
Idle Key List | Default Syntax: calls;calendar;meeting;recents;
psk1 is added in the string as PSK1 if configured with speed-dial | Softkeys that display when the phone is idle. |
Connected Meeting Key List |
Default Syntax: 9841/9851/9861: 9871: Configurable values:
| Softkeys that display when a calendar meeting is in progress. |
Off Hook Key List | Default Syntax: abc;redial;cancel;cfwd;dnd;unpark;pickup;gpickup |
This key list is not applicable for Cisco Desk Phone
9871. Softkeys that display when the receiver is lifted, or the headphone or speakerphone buttons are pressed. |
Dialing Input Key List | Default Syntax: abc;call;delchar;line;cancel |
This key list is not applicable for Cisco Desk Phone
9871. Softkeys that display when the user must enter dialing data. |
Progressing Key List | Default Syntax: endcall|2;home|3; | Softkeys that display when a call is attempting to connect. |
Connected Key List | Default Syntax: hold;endcall;newcall;conf;
| Softkeys that display when a call is connected. |
Start-Xfer Key List | Default Syntax: endcall;xfer;home; | Softkeys that display when a call transfer has been initiated. |
Start-Conf Key List | Default Syntax: hold;endcall;conf;home; | Softkeys that display when a conference call has been initiated. |
Conferencing Key List | Default Syntax: hold;endcall;join;phold;home;
| Softkeys that display when a conference call is in progress. |
Releasing Key List | Default Syntax: endcall|2;home; | Softkeys that display when a call is disconnecting. |
Hold Key List | Default Syntax: resume;endcall;newcall;home; | Softkeys that display when one or more calls are on hold. |
Ringing Key List | Default Syntax: answer|1;ignore|2;ignoresilent|3;ignoreall;home; | Softkeys that display when a call is incoming. |
Shared Active Key List: |
Default Syntax: | Softkeys that display when a call is active on a shared line. |
Shared Held Key List: | Default Syntax: resume;barge;home; | Softkeys that display when a call is on hold on a shared line. |
Programmable softkeys
Keyword |
Key Label |
Description |
Phone state |
---|---|---|---|
answer |
Answer |
Answers an incoming call. |
Ringing |
audiomute | Mute or Unmute | Allows meeting participants to mute or unmute themselves in a Webex meeting. | Connected |
barge |
Barge |
Allows another user to interrupt a shared call |
Shared-Active, Shared-Held |
bargesilent |
BargeSilent or BargeSlnt |
Allows another user to interrupt a shared call with the mic disabled. |
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 | Always displays at the first position when the phone is registered. | Dialing Input or On-Hook |
cancel | Cancel |
Cancels a call (for example, when conferencing a call and the second party is not answering. | Off-Hook |
cfwd | Forward / Clrfwd | Forwards all calls to a specified number. |
Idle, Off-Hook, Shared-Active,Hold, Shared-Held |
crdpause | PauseRec | Pauses recording. | Connected, Conferencing |
crdresume | ResRec | Resumes recording. | Connected, Conferencing |
crdstart | Record | Starts a recording | Connected, Conferencing |
crdstop | StopRec | Stops a recording | Connected, Conferencing |
conf | Conference |
Initiates a conference call. Requires that Conf Server is enabled and there are two or more calls that are active or on hold. | Connected |
delchar |
delChar - backspace Icon | Deletes a character when entering text. | Dialing Input |
dnd | DND |
Sets Do Not Disturb to prevent calls from ringing the phone. |
Idle, Off-Hook, Hold, Shared-Active, Shared-Held, Conferencing, Start-Conf, Start-Xfer |
endcall | End call | Ends a call |
Connected, Off-hook, Progressing, Start-Xfer, Start-Conf, Conferencing,Releasing, Hold, |
hold | Hold | Puts a call on hold. |
Connected, Start-Xfer, Start-Conf, Conferencing, |
ignore | Decline | Ignores an incoming call. | Ringing |
join | Join |
Connects a conference call. If the Conferencing conference host is user A and users B & C are participants, when A presses "Join", A will drop off and users B & C will be connected. | Conferencing |
calendar |
Calendar |
Opens the Meetings list |
Idle |
newcall | New call | Begins a new call. |
Idle, Hold, Shared-Active, Shared-Held |
park |
Call park |
Puts a call on hold at a designated "park" number. |
Connected |
participants | Participants (n) | Displays the meeting participant list, where (n) represents the count of the person who have joined the meeting. |
Connected |
recents | Recents |
Displays the All calls list from call history. |
Idle, Off-Hook, Shared-Active, Shared-Held |
redial | Redial | Displays the redial list. |
Idle, Connected, Start-Conf,Start-Xfer, Off-Hook (no input), Hold |
resume | Resume | Resumes a call that is on hold. | Hold, Shared-Held |
settings | Settings | Provides access to phone menus. | All |
unpark |
Call unpark |
Resumes a parked call. |
Idle, Off-Hook, Connected, Shared-Active |
xfer | Transfer | Transfers a call. Requires that Attn Xfer Serv is enabled and there is at least one connected call and one idle call. |
Connected, Start-Xfer, Start-Conf |
Configure Speed Dial on a programmable softkey
You can configure programmable softkeys as speed dials. The speed dials can be extensions or phone numbers. You can also configure programmable softkeys with speed dials that perform an action that a vertical service activation code (or a star [*] code) defines. For example, if you configure a programmable softkey with a speed dial for *67, the call is placed on hold.
1 |
Access the phone administration web page. |
2 |
Select . |
3 |
In the Programmable Softkeys section, set the Programmable Softkey Enable to Yes. |
4 |
To configure a speed dial PSK, enter the following in any of the PSK[1-16] number field: fnc=sd;ext=extensionname/starcode@$PROXY;vid=n;nme=name
where:
The name field displays on the softkey on the IP phone screen. We recommend a maximum of 10 characters for a phone. If more characters are used, the label might be truncated on the phone screen. |
5 |
Edit the following parameters: |
6 |
Click Submit All Changes. |
Configure a PSK with DTMF support
You can configure programmable softkeys (PSK) with dual tone multifrequency (DTMF). This configuration enables the phone to send digital pulses inband (or out-of-band via SIP INFO) to the server during an active call. When you enable a function on a PSK, the user sees the softkey name, and presses it to perform the named function. The applied actions to the DTMF digit string are similar to those applied to Speed Dial, such as the following:
- Pause represented by ,
- Wait represented by X
For example, ext=<DTMF_DIGITS>[[,|X][<DTMF_DIGITS>]], where the valid DTMF digits are 0-9,*, #, a, b, c, d, and where the parts in [ ] brackets are optional.
This feature applies only to programmable softkeys. It doesn’t apply to the programmable line keys (PLK) on the desk phones. If you configure any PLK for this feature, the display will present the Circled X icon Ⓧ, and nothing will happen if you press the key.
This feature supports only Connected Key List.
Before you begin
1 |
Access the phone administration web page. |
2 |
Select . |
3 |
In the Programmable Softkeys section, set the Programmable Softkey Enable to Yes. |
4 |
To configure a DTMF PSK, enter the following in any of the PSK[1-16] number field: fnc=dtmf;ext=<dtmf_digits_to_be_outpulsed>;nme=<softkey_display_name>;vid=<extension_n_to_be_associated>
When a phone has more than one registered line, you must include the vid= that is asociated with the particular line or extension in order for the softkey to appear. Otherwise, the softkey will not display. |
5 |
Edit the following parameters: |
6 |
Select Voice > Ext(n), where n is the extension number you wish to configure. |
7 |
In the Audio Configuration section, set the DTMF Tx Method to one of the following methods from the drop-down list.
|
8 |
Click Submit All Changes. Use these examples to help you understand how to configure PSK with DTMF Support
options:
Example: PSK toggles when pressed.
Example: Phone sends DTMF digits inband via a PSK softkey.
Example: The PSK softkey pauses between digits.
Example: The PSK softkey waits for the user's input between digits.
|