HELLO & WELCOME

[WelshPaul]

Line Keys
Line keys are features assigned to the physical line buttons on the phone.

Redial
Redials the last called number.

Code: Select all

<line button="2">
  <featureID>1</featureID>
  <featureLabel>Redial</featureLabel>
</line>

Speed Dial
Dials the number specified by the <speedDialNumber> parameter.

Code: Select all

<line button="2">
  <featureID>2</featureID>
  <featureLabel>LABEL</featureLabel>
  <speedDialNumber>NUMBER</speedDialNumber>
</line>

Hold
Places the currently selected call on hold.

Code: Select all

<line button="2">
  <featureID>3</featureID>
  <featureLabel>Hold</featureLabel>
</line>

Transfer
Transfers the currently selected call.

Code: Select all

<line button="2">
  <featureID>4</featureID>
  <featureLabel>Transfer</featureLabel>
</line>

Call Forward
Sets or clears the current call forward target. The phone make a call to x-cisco-serviceuri-cfwdall-XXX where XXX is replaced by the forwarding target dialled by the user. The phone will make a call to x-cisco-serviceuri-cfwdall when clearing the forwarding target.

Code: Select all

<line button="2">
  <featureID>5</featureID>
  <featureLabel>Call Forward</featureLabel>
</line>

Line
Phone line, at least one of these must be defined. Note For secondary lines, do not include <authName> and <authPassword> elements.

Code: Select all

<line button="1" lineIndex="1">
  <featureID>9</featureID>
  <featureLabel>PEERNAME</featureLabel>
  <proxy>USECALLMANAGER</proxy>
  <port>5060</port>
  <name>PEERNAME</name>
  <displayName>NAME</displayName>
  <autoAnswer>
    <autoAnswerEnabled>0</autoAnswerEnabled>
    <autoAnswerMode />
  </autoAnswer>
  <callWaiting>1</callWaiting>
  <authName>PEERNAME</authName>
  <authPassword>SECRET</authPassword>
  <sharedLine>false</sharedLine>
  <messageWaitingLampPolicy>3</messageWaitingLampPolicy>
  <messagesNumber>EXTENSION</messagesNumber>
  <ringSettingIdle>4</ringSettingIdle>
  <ringSettingActive>5</ringSettingActive>
  <forwardCallInfoDisplay>
    <callerName>true</callerName>
    <callerNumber>true</callerNumber>
    <redirectedNumber>false</redirectedNumber>
    <dialedNumber>true</dialedNumber>
  </forwardCallInfoDisplay>
  <maxNumCalls>5</maxNumCalls>
  <busyTrigger>4</busyTrigger>
</line>

Service URI
Similar to the services button except that the phone's MAC address is not automatically included in the name URL parameter.

Code: Select all

<line button="2">
  <featureID>20</featureID>
  <featureLabel>LABEL</featureLabel>
  <serviceURI>URL</serviceURI>
</line>

BLF Speed Dial
Speed Dial that monitors the device and presence state of an extension, a corresponding hint must be created in extensions.conf as well as a subscribe entry in sip.conf.

Using a <featureOptionMask> of 1 will also display whether that extension is ringing and will perform a directed call pickup request when pressed by dialling x-cisco-serviceuri-blfpickup-XXX where XXX is replaced by the number specified in <speedDialNumber>.

Code: Select all

<line button="2">
  <featureID>21</featureID>
  <featureLabel>LABEL</featureLabel>
  <featureOptionMask>1</featureOptionMask>
  <speedDialNumber>NUMBER</speedDialNumber>
</line>

BLF Directed Call Park
Speed Dial that monitors the state of a parking extension, only displays idle and busy device states. <speedDialNumber> contains the number dialled and <contact> contains the extension subscribed to. See above for additional subscription requirements.

When idle, the current call will be blind-transferred to x-cisco-serviceuri-dpark-XXX where XXX is replaced by the number in <speedDialNumber>. Otherwise when the in-use a call will be made to the number in <speedDialNumber> optionally prefixed by <retrievalPrefix>.

Code: Select all

<line button="2">
  <featureID>22</featureID>
  <featureLabel>LABEL</featureLabel>
  <speedDialNumber>NUMBER</speedDialNumber>
  <contact>NUMBER</contact>
  <retrievalPrefix />
</line>

Intercom
Similar to a line except with most soft-keys disabled and mute is automatically enabled for incoming calls. Intercom lines cannot be the primary line for a phone so a register entry in sip.conf must be used to assign them to the peer.

Use a <TEMPLATE> entry with a line and rewrite attribute in the phone's dial template to automatically dial the intercom extension.

Code: Select all

<line button="2" lineIndex="2">
  <featureID>23</featureID>
  <featureLabel>Intercom</featureLabel>
  <proxy>USECALLMANAGER</proxy>
  <port>5060</port>
  <name>PEERNAME</name>
  <displayName>NAME</displayName>
  <autoAnswer>
    <autoAnswerEnabled>3</autoAnswerEnabled>
    <autoAnswerMode>Auto Answer with Speakerphone</autoAnswerMode>
  </autoAnswer>
  <callWaiting>3</callWaiting>
  <maxNumCalls>1</maxNumCalls>
  <busyTrigger>1</busyTrigger>
</line>

Malicious Call
Report that the current call is suspicious or harassing.

Code: Select all

<line button="2">
  <featureID>27</featureID>
  <featureLabel>Malicious Call</featureLabel>
</line>

Conference
Create an ad-hoc conference with the currently selected call.

Code: Select all

<line button="2">
  <featureID>102</featureID>
  <featureLabel>Conference</featureLabel>
</line>

Meet Me
Create a meetme conference. The phone will make a call to extension x-cisco-serviceuri-meetme-XXX where XXX is replaced with the meetme number dialled by the user.

Code: Select all

<line button="2">
  <featureID>123</featureID>
  <featureLabel>MeetMe</featureLabel>
</line>

Park
Park the currently selected call.

Code: Select all

<line button="2">
  <featureID>126</featureID>
  <featureLabel>Park</featureLabel>
</line>

PickUp
Pick-up an incoming call to one of the phones in you call group. The phone will make a call to extension x-cisco-serviceuri-pickup.

Code: Select all

<line button="2">
  <featureID>127</featureID>
  <featureLabel>PickUp</featureLabel>
</line>

Group PickUp
Pick-up an incoming call in a specific call group. The phone will make a call to extension x-cisco-serviceuri-gickup-XXX where XXX is replaced with the group number dialed by the user. See Dialplan Extensions for an example.

Code: Select all

<line button="2">
  <featureID>128</featureID>
  <featureLabel>Group PickUp</featureLabel>
</line>

Do Not Disturb
Set to remove Do Not Disturb status. Line key lamp will be red or orange (depending on phone model) when Do Not Disturb is set.

Code: Select all

<line button="2">
  <featureID>130</featureID>
  <featureLabel>Do Not Disturb</featureLabel>
</line>

Remove Last Participant
Remove last participant added to the selected ad-hoc conference.

Code: Select all

<line button="2">
  <featureID>132</featureID>
  <featureLabel>Remove Last Participant</featureLabel>
</line>

Report Quality
Report a call-quality issue. RTP statistics about the call will be logged, <callStats> must be enabled.

Code: Select all

<line button="2">
  <featureID>133</featureID>
  <featureLabel>Report Quality</featureLabel>
</line>

Call Back
Activate a call-back for the current outgoing call. Phone will notify you when the extension becomes available. You need to have a ring-tone called callback.raw to get an audible notification.

Code: Select all

<line button="2">
  <featureID>134</featureID>
  <featureLabel>Call Back</featureLabel>
</line>

Other PickUp
Pick-up an incoming call to on of the phones in your other pickup group. The phone will make a call to extension x-cisco-serviceuri-opickup.

Code: Select all

<line button="2">
  <featureID>135</featureID>
  <featureLabel>Other PickUp</featureLabel>
</line>

New Call
Make a new outgoing call.

Code: Select all

<line button="2">
  <featureID>137</featureID>
  <featureLabel>New Call</featureLabel>
</line>

Hunt Group
Login or Logout from the Hunt Group. Line key lamp will be orange when logged-in.

Code: Select all

<line button="2">
  <featureID>139</featureID>
  <featureLabel>Hunt Group</featureLabel>
</line>

All Calls
Display all calls on the phone. 7800 and 8800 series, 8961, 9951 and 9971 models only.

Code: Select all

<line button="2">
  <featureID>140</featureID>
  <featureLabel>All Calls</featureLabel>
</line>

Answer
Answer the oldest incoming call.

Code: Select all

<line button="2">
  <featureID>141</featureID>
  <featureLabel>Answer</featureLabel>
</line>

Alerting Calls
Only show the alerting (incoming) calls on your phone. 7800 and 8800 series, 8961, 9951 and 9971 models only.

Code: Select all

<line button="2">
  <featureID>142</featureID>
  <featureLabel>Alerting Calls</featureLabel>
</line>

Record
Record the currently selected call. Line key lamp will turn red when recording a call. The separate inbound and outbound audio streams of the call duplicated on the phone and sent to the record extension.

Code: Select all

<line button="2">
  <featureID>159</featureID>
  <featureLabel>Record</featureLabel>
</line>