Asterisk callgroups and pickupgroups
Call and pickup groups
Letting someone else answer a callIn the mgcp, SIP, IAX, Asterisk Skinny Channels and the zapata channels you can define call and pickup groups for phones.
Note that call pickup typically only works WITHIN a technology, e.g. from a SIP phone to a SIP phone and not ACROSS technologies, e.g. not from a SIP phone to a IAX phone. If you need that functionality then take a look at the PickUp applications included in bristuff.
The basic functionality is this:
- A call is placed in one or several call groups
- If a phone belongs in a pickup group that matches one of the call's call groups, that phone may pickup the incoming call by calling *8# on his phone
- In v1-0, the feature code seems to be *8# on zap channels, and *8 on SIP channels: *8# does not seem to work from a SIP phone (unless your phone is configured to interpret # as ENTER key)
In Asterisk version 1.0, the groups are 0-31, in versions following 1.0, the groups are 0-63. You can configure the pickup command in features.conf.
You define call and pickupgroup per device (in sip.conf under each extn# section), like
Callgroup=1
pickupgroup=1-9,13
Common misconception
Callgroups are not intended to call a group of phones; all a callgroup= entry does is to help define who is permitted to perform a pick-up for which calls! If you would like to call a group of phones instead, then you need to a) use either Dial and specify two or more devices separated by &, or b) use queues.Make sure * is not configured as disconnect call if using the default of *8
See also
- Asterisk cmd PickUp: Native Asterisk pick-up command
- PickUp: Mostly channel independent; part of bristuff patch
- PickUpChan
- PickDown
- Steal
- app_intercept by www.pbxfreeware.org: Intercept an unanswered call
- Asterisk cmd SIPCallPickUP: Experimental, not part of the Asterisk codebase
- Asterisk groups
Go back to Asterisk

Comments
333Re:
333Determining pickupgroup/callgroup in extensions.conf
I'm in extensions.conf and want to use the pickupgroup of the caller to name the SetGroup and then limit the amount of calls from a specific 'party' that all share the same pickupgroup number. can i work this out from ${CALLERIDNUM} ??
This is the only way I've been able to assign a 'group' to a site since we have a central asterisk server and multiple handsets in multiple locations on the other side of network connections.
333Re: number of pickupgroups?
333Call pickup across technologies
333How I got it working.
1000
context=myphones
...
Callgroup=1
pickupgroup=1
But that means people must press *8 to pick up. Is there anyway to get a button to flash on the phone as well?
333number of pickupgroups?
Is that really correct? I use 1.2.4-BRIstuffed-0.3.0-PRE-1k, added "pickupgroup=3-63" to my sip.conf, and "sip show peer number" shows just
"Pickupgroup : 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31"
333
"NOTICE23527: chan_sip.c:10383 handle_request_invite: Nothing to pick up"
I have pickupgroup=1 in all sip phones in my sip.conf and an incoming sip call to one of them at the same time.
I use CVS version of Asterisk and I can't understand what is missing.