New options have been added to the ${SIPPEER()} function that reflect the current status of call-forwarding, do not disturb and hunt-group login. Writing to the function will automatically update the phone's display. These settings can also be changed using the command line interface. Read-only information about the registered device is also provided.


Contains the call-forwarding target.

; Show the current target exten => _X.,1,NoOp(Call Forward: ${SIPPEER(${CHANNEL(peername)},callforward)}) ; Set call forwarding target exten => _X.,1,Set(SIPPEER(${CHANNEL(peername)},callforward)=${TARGET}); ; Clear call forwarding target exten => _X.,1,Set(SIPPEER(${CHANNEL(peername)},callforward)=);


Whether the phone has set do not disturb or not.

; Show the current status exten => _X.,1,NoOp(Do Not Disturb: ${SIPPEER(${CHANNEL(peername)},donotdisturb)}) ; Enables do not disturb exten => _X.,1,Set(SIPPEER(${CHANNEL(peername)},donotdisturb)=yes); ; Disables do not disutrb exten => _X.,1,Set(SIPPEER(${CHANNEL(peername)},donotdisturb)=no);


Whether the phone has logged into the hunt-group.

; Show the current status exten => _X.,1,NoOp(Hunt Group Login: ${SIPPEER(${CHANNEL(peername)},huntgroup)}) ; Login to hunt group exten => _X.,1,Set(SIPPEER(${CHANNEL(peername)},huntgroup)=yes); ; Logout from hunt group exten => _X.,1,Set(SIPPEER(${CHANNEL(peername)},huntgroup)=no);


The SIP Call-ID of the REGISTER dialog, used when restaring or resetting the phone via SIP Notify Commands. Note: this item is read-only.

; Show the REGISTER Call-ID exten => _X.,1,NoOp(Register Call-ID: ${SIPPEER(${CHANNEL(peername)},regcallid)})


The device name provided in the Contact header when the phone registered. Note: this item is read-only.

; Show the Device Name exten => _X.,1,NoOp(Device Name: ${SIPPEER(${CHANNEL(peername)},ciscodevicename)})


The line index assigned to the phone. Used to determine if the peer has been registered as a secondary line. Note: this item is read-only.

; Show the Line Index exten => _X.,1,NoOp(Line Index: ${SIPPEER(${CHANNEL(peername)},ciscolineindex)})