Group Pickup Feature

About Group Pickup Feature

Feature code to toggle what group (group, user, device, extension) to pick up a ringing call from.

Schema

Validator for the group_pickup_feature callflow data object

KeyDescriptionTypeDefaultRequiredSupport Level
approved_device_idRestrict calling device to Devicestring()false
approved_group_idRestrict calling device to Groupstring()false
approved_user_idRestrict calling device to Userstring()false
device_idDevice to pickupstring()false
group_idGroup in which to find a call to pickupstring()false
skip_moduleWhen set to true this callflow action is skipped, advancing to the wildcard branch (if any)boolean()false
typeThe type of collection to pickup`string(‘group''user''device''extension’)`
user_idUser in which to find a call to pickupstring()false

Usage

The feature code for group pickup will lookup a device by SIP username or an extension. The callflow for that extension is searched in a depth-first order until a target-able module is found (one of user, device, ring_group, or page_group). Once a suitable module is found, if there is an unanswered call ringing a targeted device it will be picked up.

Extension callflow

Create a callflow with patterns' key as: [”^\7([0-9])$“]and set the parametertype’ to extension.

{"patterns":["^\\*7([0-9]+)$"]
 ,"flow":{
   "module":"group_pickup_feature"
   ,"data":{"type":"extension"}
 }
}

Now create a callflow to ring appropriate endpoint(s) (say extension 401).

Dial 401 to start ringing the endpoints; on another phone, dial *7401 to pickup the call.

SIP Username callflow

This example was done using BLF on a spa504g.

The SIP username of the device we want to monitor for this example is 55578547.

Connect to the phone’s UI and on the Phone Tab, go to Line Key 2 and set:

Setting|Value Extension|disabled Share Call Appearance|private Extended Function|:fnc=blf+cp;sub=55578547@sip.domain.com;ext=55578547@sip.domain.com

On the Attendant Console Tab, set Attendant Console Call Pickup Code to *98#. This way the user name part of the subscription is passed along (*9855578547).

Create the feature code callflow:

{"patterns":["^\\*98([0-9]*)$"]
 ,"flow":{
   "module":"group_pickup_feature"
   ,"data":{"type":"device"}
 }
}

On this page