<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/en/2176/25/9/_/styles/combined.css?spaceKey=AST&forWysiwyg=true" type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://wiki.asterisk.org/wiki/display/AST/Call+Pickup">Call Pickup</a></h2>
<h4>Page <b>added</b> by <a href="https://wiki.asterisk.org/wiki/display/~rmudgett">Richard Mudgett</a>
</h4>
<br/>
<div class="notificationGreySide">
<h1><a name="CallPickup-Overview"></a>1. Overview</h1>
<div class='panelMacro'><table class='warningMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/forbidden.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>This is an initial draft of the page. Please do not comment on this page here until this warning is removed.</td></tr></table></div>
<p>Call pickup allows you to answer an incoming call from another phone.</p>
<p>Requesting to pickup a call is done by two basic methods.<br/>
1) by dialplan using the <a href="/wiki/display/AST/Asterisk+11+Application_Pickup" title="Asterisk 11 Application_Pickup">Pickup</a> or <a href="/wiki/display/AST/Asterisk+11+Application_PickupChan" title="Asterisk 11 Application_PickupChan">PickupChan</a> applications.<br/>
2) by dialing the pickupexten configured in features.conf.</p>
<p>Which calls can be picked up is determined by configuration and dialplan.</p>
<h1><a name="CallPickup-DialplanApplicationsandFunctions"></a>2. Dialplan Applications and Functions</h1>
<h2><a name="CallPickup-PickupApplication"></a>2.1. Pickup Application</h2>
<p>The <a href="/wiki/display/AST/Asterisk+11+Application_Pickup" title="Asterisk 11 Application_Pickup">Pickup</a> application has three ways to select calls for pickup.<br/>
1) With no parameters, Pickup selects calls using callgroup/pickupgroup like the pickupexten.<br/>
2) Extension with PICKUPMARK, Pickup selects calls with the PICKUPMARK channel variable matching the extension.<br/>
3) Extension with or without a context, Pickup selects calls with the matching extension and context.</p>
<h2><a name="CallPickup-PickupChanApplication"></a>2.2. PickupChan Application</h2>
<p>The <a href="/wiki/display/AST/Asterisk+11+Application_PickupChan" title="Asterisk 11 Application_PickupChan">PickupChan</a> application tries to pickup the specified channels given to it.</p>
<h2><a name="CallPickup-CHANNELFunction"></a>2.3. CHANNEL Function</h2>
<p>The <a href="/wiki/display/AST/Asterisk+11+Function_CHANNEL" title="Asterisk 11 Function_CHANNEL">CHANNEL</a> 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.</p>
<h3><a name="CallPickup-callgroup"></a>2.3.1. callgroup</h3>
<p>The CHANNEL(callgroup) option specifies which numeric pickup groups can pickup this channel.</p>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>same => n,Set(CHANNEL(callgroup)=1,5-7)
</pre>
</div></div>
<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b>NOTES</b><br /><ul>
<li>For this option to be effective, you must set it on the outgoing channel.</li>
<li>You can use the setvar option available with several channel driver configuration files to set the pickup groups.</li>
<li>You can use a <a href="/wiki/pages/createpage.action?spaceKey=AST&title=Pre+Dial+Handlers&linkCreation=true&fromPageId=21463197" class="createlink">pre-dial handler</a>.</li>
</ul>
</td></tr></table></div>
<h3><a name="CallPickup-pickupgroup"></a>2.3.2. pickupgroup</h3>
<p>The CHANNEL(pickupgroup) option specifies which numeric pickup groups this channel can pickup.</p>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>same => n,Set(CHANNEL(pickupgroup)=1,6-8)
</pre>
</div></div>
<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b>NOTES</b><br /><ul>
<li>For this option to be effective, you must set it on the channel before executing the Pickup application or calling the pickupexten.</li>
<li>You can use the setvar option available with several channel driver configuration files to set the pickup groups.</li>
</ul>
</td></tr></table></div>
<h1><a name="CallPickup-ConfigurationOptions"></a>3. Configuration Options</h1>
<p>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) dialplan function.</p>
<p>Calls picked up using pickupexten can hear an optional sound file for success and failure.</p>
<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>The current channel drivers that support calling the pickupexten to pickup a call are: chan_dahdi/analog, chan_mgcp, chan_misdn, chan_sip, and chan_unistim.</td></tr></table></div>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedHeader panelHeader" style="border-bottom-width: 1px;"><b>features.conf</b></div><div class="preformattedContent panelContent">
<pre>pickupexten = *8 ; Configure the pickup extension. (default is *8)
pickupsound = beep ; to indicate a successful pickup (default: no sound)
pickupfailsound = beeperr ; to indicate that the pickup failed (default: no sound)
</pre>
</div></div>
<h2><a name="CallPickup-Numericcallpickupgroups"></a>3.1. Numeric call pickup groups</h2>
<p>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.</p>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedHeader panelHeader" style="border-bottom-width: 1px;"><b>Syntax</b></div><div class="preformattedContent panelContent">
<pre>groups=[range[,range[,...]]]
range=number[-number]
</pre>
</div></div>
<p>callgroup - specifies which numeric pickup groups can pickup this channel.<br/>
pickupgroup - specifies which numeric pickup groups this channel can pickup.</p>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedHeader panelHeader" style="border-bottom-width: 1px;"><b>chan_dahdi.conf/analog, misdn.conf, mgcp.conf, sip.conf, unistim.conf</b></div><div class="preformattedContent panelContent">
<pre>callgroup=1,5-7
pickupgroup=1
</pre>
</div></div>
<h2><a name="CallPickup-Namedcallpickupgroups"></a>3.2. Named call pickup groups</h2>
<p>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.</p>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedHeader panelHeader" style="border-bottom-width: 1px;"><b>Syntax</b></div><div class="preformattedContent panelContent">
<pre>groups=[name[,name[,...]]]
</pre>
</div></div>
<p>namedcallgroup - specifies which named pickup groups can pickup this channel.<br/>
namedpickupgroup - specifies which named pickup groups this channel can pickup.</p>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedHeader panelHeader" style="border-bottom-width: 1px;"><b>chan_dahdi.conf/analog, misdn.conf, sip.conf</b></div><div class="preformattedContent panelContent">
<pre>namedcallgroup=engineering,sales,netgroup,protgroup
namedpickupgroup=sales
</pre>
</div></div>
<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="/wiki/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b>NOTES</b><br /><ul>
<li>You can use named pickup groups in parallel with numeric pickup groups.</li>
<li>The named pickup group '4' is not the same as the numeric pickup group '4'.</li>
<li>Named pickup groups are currently only supported by the pickupexten request method.</li>
</ul>
</td></tr></table></div>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;" class="grey">
<a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST">Stop watching space</a>
<span style="padding: 0px 5px;">|</span>
<a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action">Change email notification preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/AST/Call+Pickup">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/display/AST/Call+Pickup?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>