Softkeys - chan-sccp/chan-sccp GitHub Wiki

You can create several softkeyset in you config for use on different devices. You can assign these softkeyset to a device using: softkeyset = name_of_softkeyset in the device section of the config. (softkey definitions/logo's)

for example:

[SEP001122334455]
devicetype=7960
...
softkeyset = mysoftkeyset

[SEP005544332211]
devicetype=6921
...
softkeyset = 6921softkeyset

[mysoftkeyset]
type            = softkeyset
;uriaction      = cfwdall,Key:Directories,http://127.0.0.1:8081/test,Key:KeyPad3
;uriaction      = cfwdall,Dial:98031
;uriaction      = dnd,Dial:*027#
onhook          = redial,newcall,cfwdall,pickup,gpickup,dnd,private
offhook         = redial,endcall,private,cfwdall,cfwdbusy,pickup,gpickup,meetme,barge,monitor
offhookfeat     = redial,endcall
onhint          = newcall,pickup,barge
digitsfoll      = back,endcall,dial
ringin          = answer,endcall,transvm,idivert,monitor
ringout         = empty,endcall,transfer
connected       = hold,endcall,park,transfer,vidmode,idivert,conf,conflist,park,monitor
onhold          = resume,newcall,endcall,transfer,conflist,select,dirtrfr,idivert,meetme
conntrans       = hold,endcall,transfer,conf,vidmode,park,select,dirtrfr,meetme,cfwdall,cfwdbusy,monitor
connconf        = conflist,newcall,endcall,join,hold,monitor
onstealable     = redial,newcall,cfwdall,pickup,gpickup,dnd,intrcpt
holdconf        = resume,newcall,endcall,join,vidmode

[6921softkeyset]
type            = softkeyset
onhook          = redial,newcall,cfwdall,dnd,pickup,gpickup,private
offhook         = redial,endcall,cfwdall,dnd,pickup,gpickup,private,vidmode
offhookfeat     = edial,endcall,vidmode
digitsfoll      = back,endcall,dial
ringout         = empty,endcall,transfer,vidmode
connected       = hold,endcall,transfer,vidmode,idivert,conf,conflist,park,monitor
conntrans       = empty,endcall,transfer,vidmode
connconf        = hold,endcall,conf,conflist,join,vidmode
onhold          = resume,newcall,endcall,idivert, vidmode
ringin          = answer,idivert,vidmode
onhint          = barge,newcall,redial,pickup,gpickup,vidmode
onstealable     = redial,newcall,cfwdall,pickup,gpickup,dnd,intrcpt,vidmode
holdconf        = resume,newcall,endcall,join,vidmode

The [mysoftkeyset] section about contains the state of the phone as the first part (before the equal sign) and the softbuttons shown during this state in the second part.

Multiple softkey set can be created and attached to different devices.

These are the softkeys available

Redial Softkey

Using the Redial Button you can Redial the last Called Number on this Line or Device. If you would like to have a list of previously dialed numbers, you should have a look at [Redial Menu].

NewCall Softkey

Using the New Call Button you can initiate a new Call just like picking up the receiver. You can either type in the number to be called before or afterwards.

Hold Softkey

Using the Hold Button you can hold the current line and undertake some other action You can later resume the held line use How to use the Resume Softkey

Resume Softkey

Using the Resume Button you can resume a previously held line which has been put on hold using Hold Softkey. When you have a [Shared Line] setup, a phonecall can be resumed on any of the devices sharing the same line. The phone call will be automatically transfered to the phone on which the line is resumed.

Transfer Button

Using the Transfer Button you can Transfer the Currentline to another Number You can also use a speeddial during transfer

End Call Softkey

Using the End Call Button you can End the Call on the Current Line

Do Not Disturb (DND) Softkey

Using the Do Not Disturb (DND) Button you set your device/line to the Do Not Disturb Status. When receiving a call your phone will not ring and the People Call You Will get a Busy Signal

BackSpace (<<) Softkey

Using the backspace (<<) Button you can erase the last entered digit/character

Answer Softkey

Using the Answer Button you can Answer an Incoming Call

Select Softkey

The "Select" softkey is used for bridging two channels (redirect). Select your first channel and press the select softkey. On the display this channel is marked with a checkmark. By selecting the second channel, it is also marked with a checkmark and DirTrFr (How to use the DirTrfr) is enabled. Press this key to bridge both channels.

DirTrfr Softkey

When two channels have been selected using the Select SoftKey (How to use the select softkey) then using the DirTrfr SoftKey can be used to Connect Both Lines to one another (bridging both channels).

Call Forward All Softkey

Using this Button you can set the current line / device to forward all incoming call to another number This number can be another SCCP/SIP/IAX Device or even an external number (if permitted to call externally)

Call Forward if Busy Softkey

Using this Button you can set the current line / device to forward incoming calls when busy to another number This number can be another SCCP/SIP/IAX Device or even an external number (if permitted to call externally)

Call Forward if No-Answer Softkey

Using this Button you can set the current line / device to forward incoming calls when you don't/can't answer to another number This number can be another SCCP/SIP/IAX Device or even an external number (if permitted to call externally)

Park Softkey

Using the Park Button make it possible to Send a Call to the Asterisk Parking Lot Channels parked in the Parking Lot can be Picked-Up by Another Phone Using the Pickup Button or the Pickup Number Configured in features.conf under pickupexten

Transfer Softkey

Using the Transfer Button gives you the possibily to Transfer the Current Line to a New Number After pressing the Transfer button you are asked to Enter a New Number to which the Line will have to be transfered

Private Softkey

Using the Private Button before dialing a New Outside Line will Prevent the Number dialed to be monitored by Devices that use a HINT. It does not prevent the number turning up in Asterisk Logging or the Console Window.

Conference Softkey

Using the Conference Button makes it possible to set up a Manageble Conference. You just need 2 or more lines connected to your phone (1 active and the others on hold) and press the 'Conf' Softkey, that's all.

More Information

ConfList Softkey

Once you have established a confernce, you can press the ConfList button. You will see a list of all conference participants. From here you can mute and kick participants during the conference.

More Information

Join Softkey

Using the Join Button makes it possible to Add another member/line to an already running Conference When you are in a conference and you receive an Incoming Call you can join this channel/line to the running Conference. You need to leave the ConfList menu (if you are in it), by pressing the Exit Key. Put the conference on hold and call the new participant, once he/she has picked up, you can press the 'Join' Softkey to return to the Conference.

More Information

Barge Softkey

Using the Barge Button makes it possible to listen in on an On-Going Call on another Line / Device How to use the Conference Barge Button

Using the Barge Button makes it possible to listen in on an On-Going Conference on another Channel

Meetme Softkey

Using the Meetme Button makes it possible to set up a Simple Three Way Conference. There are two ways this can be done: Option 1: You Already have to Lines Occupied (One is active and the other Held), which you would like to put in a Conference; Simple Press the Conference Button Option 2: You have one line Occupied and would like to call Someone else and Join them all into a Conference; Press the Conference Button and you will be asked for the 3 party number which need to be added to the conference, once this line is connected, you press the Conference Button Again and the Conference Starts.

Pickup Softkey

Using the Pickup Button Makes it possible to Pickup a Parked Call from the Parking Lot This is equivalent to using the keys defined in features.conf under pickupexten.

More about Pickup

Group Pickup Softkey

Using the GroupPickup Button Makes it possible to Pickup a Ringing Line in defined in your PickupGroup This is equivalent to using the keys defined in features.conf under pickupexten.

More about GPickup

VidMode Softkey

Using the VidMode Button Makes it possible for you to start transmitting video once you are on a connected call to another phone supporting video.

More about VIDEO