Overview
Call pickup allows you to answer a call while it is ringing another phone or group of phones(other than the phone you are sitting at).
Requesting to pickup a call is done by two basic methods.
- by dialplan using the Pickup or PickupChan applications.
- by dialing the extension defined for pickupexten configured in features.conf.
Which calls can be picked up is determined by configuration and dialplan.
Dialplan Applications and Functions
Pickup Application
The Pickup application has three ways to select calls for pickup.
PickupChan Application
The PickupChan application tries to pickup the specified channels given to it.
CHANNEL Function
The CHANNEL function allows the pickup groups set on a channel to be changed from the defaults set by the channel driver when the channel was created.
callgroup/namedcallgroup
The CHANNEL(callgroup) option specifies which numeric pickup groups that this channel is a member.
The CHANNEL(namedcallgroup) option specifies which named pickup groups that this channel is a member.
pickupgroup/namedpickupgroup
The CHANNEL(pickupgroup) option specifies which numeric pickup groups this channel can pickup.
The CHANNEL(namedpickupgroup) option specifies which named pickup groups this channel can pickup.
Configuration Options
The pickupexten request method selects calls using the numeric and named call groups. The ringing channels have the callgroup assigned when the channel is created by the channel driver or set by the CHANNEL(callgroup) or CHANNEL(namedcallgroup) dialplan function.
Calls picked up using pickupexten can hear an optional sound file for success and failure.
Numeric call pickup groups
A numeric callgroup and pickupgroup can be set to a comma separated list of ranges (e.g., 1-4) or numbers that can have a value of 0 to 63. There can be a maximum of 64 numeric groups.
- callgroup - specifies which numeric pickup groups that this channel is a member.
- pickupgroup - specifies which numeric pickup groups this channel can pickup.
Configuration should be supported in several channel drivers, including:
- chan_dahdi.conf
- misdn.conf
- mgcp.conf
- sip.conf
- unistim.conf
- pjsip.conf
pjsip.conf uses snake case:
Named call pickup groups
A named callgroup and pickupgroup can be set to a comma separated list of case sensitive name strings. The number of named groups is unlimited. The number of named groups you can specify at once is limited by the line length supported.
- namedcallgroup - specifies which named pickup groups that this channel is a member.
- namedpickupgroup - specifies which named pickup groups this channel can pickup.
Configuration should be supported in several channel drivers, including:
- chan_dahdi.conf
- misdn.conf
- sip.conf
- pjsip.conf
pjsip.conf uses snake case: