Asterisk-13-Configuration_res_parking_29394918.html 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <title>Asterisk Project : Asterisk 13 Configuration_res_parking</title>
  5. <link rel="stylesheet" href="styles/site.css" type="text/css" />
  6. <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
  7. </head>
  8. <body class="theme-default aui-theme-default">
  9. <div id="page">
  10. <div id="main" class="aui-page-panel">
  11. <div id="main-header">
  12. <div id="breadcrumb-section">
  13. <ol id="breadcrumbs">
  14. <li class="first">
  15. <span><a href="index.html">Asterisk Project</a></span>
  16. </li>
  17. <li>
  18. <span><a href="Asterisk-13-Command-Reference_29394274.html">Asterisk 13 Command Reference</a></span>
  19. </li>
  20. <li>
  21. <span><a href="Asterisk-13-Module-Configuration_29394289.html">Asterisk 13 Module Configuration</a></span>
  22. </li>
  23. </ol>
  24. </div>
  25. <h1 id="title-heading" class="pagetitle">
  26. <span id="title-text">
  27. Asterisk Project : Asterisk 13 Configuration_res_parking
  28. </span>
  29. </h1>
  30. </div>
  31. <div id="content" class="view">
  32. <div class="page-metadata">
  33. Created and last modified by <span class='author'> wikibot</span> on Aug 11, 2014
  34. </div>
  35. <div id="main-content" class="wiki-content group">
  36. <p>This configuration documentation is for functionality provided by <code>res_parking</code>.</p>
  37. <h2 id="Asterisk13Configuration_res_parking-res_parking.conf">res_parking.conf</h2>
  38. <h3 id="Asterisk13Configuration_res_parking-globals">globals</h3>
  39. <p>Options that apply to every parking lot</p>
  40. <h4 id="Asterisk13Configuration_res_parking-ConfigurationOptionReference">Configuration Option Reference</h4>
  41. <div class="table-wrap"><table class="confluenceTable"><tbody>
  42. <tr>
  43. <th class="confluenceTh"><p> Option Name </p></th>
  44. <th class="confluenceTh"><p> Type </p></th>
  45. <th class="confluenceTh"><p> Default Value </p></th>
  46. <th class="confluenceTh"><p> Regular Expression </p></th>
  47. <th class="confluenceTh"><p> Description </p></th>
  48. </tr>
  49. <tr>
  50. <td class="confluenceTd"><p> <code>parkeddynamic</code> </p></td>
  51. <td class="confluenceTd"><p> <code>Boolean</code> </p></td>
  52. <td class="confluenceTd"><p> <code>no</code> </p></td>
  53. <td class="confluenceTd"><p> <code>false</code> </p></td>
  54. <td class="confluenceTd"><p> Enables dynamically created parkinglots. </p></td>
  55. </tr>
  56. </tbody></table></div>
  57. <h3 id="Asterisk13Configuration_res_parking-parking_lot">parking_lot</h3>
  58. <p>Defined parking lots for res_parking to use to park calls on</p>
  59. <h4 id="Asterisk13Configuration_res_parking-ConfigurationOptionReference.1">Configuration Option Reference</h4>
  60. <div class="table-wrap"><table class="confluenceTable"><tbody>
  61. <tr>
  62. <th class="confluenceTh"><p> Option Name </p></th>
  63. <th class="confluenceTh"><p> Type </p></th>
  64. <th class="confluenceTh"><p> Default Value </p></th>
  65. <th class="confluenceTh"><p> Regular Expression </p></th>
  66. <th class="confluenceTh"><p> Description </p></th>
  67. </tr>
  68. <tr>
  69. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_parking_29394918.html"><code>context</code></a> </p></td>
  70. <td class="confluenceTd"><p> <code>String</code> </p></td>
  71. <td class="confluenceTd"><p> <code>parkedcalls</code> </p></td>
  72. <td class="confluenceTd"><p> <code>false</code> </p></td>
  73. <td class="confluenceTd"><p> The name of the context where calls are parked and picked up from. </p></td>
  74. </tr>
  75. <tr>
  76. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_parking_29394918.html"><code>parkext</code></a> </p></td>
  77. <td class="confluenceTd"><p> <code>String</code> </p></td>
  78. <td class="confluenceTd"><p> </p></td>
  79. <td class="confluenceTd"><p> <code>false</code> </p></td>
  80. <td class="confluenceTd"><p> Extension to park calls to this parking lot. </p></td>
  81. </tr>
  82. <tr>
  83. <td class="confluenceTd"><p> <code>parkext_exclusive</code> </p></td>
  84. <td class="confluenceTd"><p> <code>Boolean</code> </p></td>
  85. <td class="confluenceTd"><p> <code>no</code> </p></td>
  86. <td class="confluenceTd"><p> <code>false</code> </p></td>
  87. <td class="confluenceTd"><p> If yes, the extension registered as parkext will park exclusively to this parking lot. </p></td>
  88. </tr>
  89. <tr>
  90. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_parking_29394918.html"><code>parkpos</code></a> </p></td>
  91. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  92. <td class="confluenceTd"><p> <code>701-750</code> </p></td>
  93. <td class="confluenceTd"><p> <code>false</code> </p></td>
  94. <td class="confluenceTd"><p> Numerical range of parking spaces which can be used to retrieve parked calls. </p></td>
  95. </tr>
  96. <tr>
  97. <td class="confluenceTd"><p> <code>parkinghints</code> </p></td>
  98. <td class="confluenceTd"><p> <code>Boolean</code> </p></td>
  99. <td class="confluenceTd"><p> <code>no</code> </p></td>
  100. <td class="confluenceTd"><p> <code>false</code> </p></td>
  101. <td class="confluenceTd"><p> If yes, this parking lot will add hints automatically for parking spaces. </p></td>
  102. </tr>
  103. <tr>
  104. <td class="confluenceTd"><p> <code>parkingtime</code> </p></td>
  105. <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
  106. <td class="confluenceTd"><p> <code>45</code> </p></td>
  107. <td class="confluenceTd"><p> <code>false</code> </p></td>
  108. <td class="confluenceTd"><p> Amount of time a call will remain parked before giving up (in seconds). </p></td>
  109. </tr>
  110. <tr>
  111. <td class="confluenceTd"><p> <code>parkedmusicclass</code> </p></td>
  112. <td class="confluenceTd"><p> <code>String</code> </p></td>
  113. <td class="confluenceTd"><p> </p></td>
  114. <td class="confluenceTd"><p> <code>false</code> </p></td>
  115. <td class="confluenceTd"><p> Which music class to use for parked calls. They will use the default if unspecified. </p></td>
  116. </tr>
  117. <tr>
  118. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_parking_29394918.html"><code>comebacktoorigin</code></a> </p></td>
  119. <td class="confluenceTd"><p> <code>Boolean</code> </p></td>
  120. <td class="confluenceTd"><p> <code>yes</code> </p></td>
  121. <td class="confluenceTd"><p> <code>false</code> </p></td>
  122. <td class="confluenceTd"><p> Determines what should be done with the parked channel if no one picks it up before it times out. </p></td>
  123. </tr>
  124. <tr>
  125. <td class="confluenceTd"><p> <code>comebackdialtime</code> </p></td>
  126. <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
  127. <td class="confluenceTd"><p> <code>30</code> </p></td>
  128. <td class="confluenceTd"><p> <code>false</code> </p></td>
  129. <td class="confluenceTd"><p> Timeout for the Dial extension created to call back the parker when a parked call times out. </p></td>
  130. </tr>
  131. <tr>
  132. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_parking_29394918.html"><code>comebackcontext</code></a> </p></td>
  133. <td class="confluenceTd"><p> <code>String</code> </p></td>
  134. <td class="confluenceTd"><p> <code>parkedcallstimeout</code> </p></td>
  135. <td class="confluenceTd"><p> <code>false</code> </p></td>
  136. <td class="confluenceTd"><p> Context where parked calls will enter the PBX on timeout when comebacktoorigin=no </p></td>
  137. </tr>
  138. <tr>
  139. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_parking_29394918.html"><code>courtesytone</code></a> </p></td>
  140. <td class="confluenceTd"><p> <code>String</code> </p></td>
  141. <td class="confluenceTd"><p> </p></td>
  142. <td class="confluenceTd"><p> <code>false</code> </p></td>
  143. <td class="confluenceTd"><p> If the name of a sound file is provided, use this as the courtesy tone </p></td>
  144. </tr>
  145. <tr>
  146. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_parking_29394918.html"><code>parkedplay</code></a> </p></td>
  147. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  148. <td class="confluenceTd"><p> <code>caller</code> </p></td>
  149. <td class="confluenceTd"><p> <code>false</code> </p></td>
  150. <td class="confluenceTd"><p> Who we should play the courtesytone to on the pickup of a parked call from this lot </p></td>
  151. </tr>
  152. <tr>
  153. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_parking_29394918.html"><code>parkedcalltransfers</code></a> </p></td>
  154. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  155. <td class="confluenceTd"><p> <code>no</code> </p></td>
  156. <td class="confluenceTd"><p> <code>false</code> </p></td>
  157. <td class="confluenceTd"><p> Who to apply the DTMF transfer features to when parked calls are picked up or timeout. </p></td>
  158. </tr>
  159. <tr>
  160. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_parking_29394918.html"><code>parkedcallreparking</code></a> </p></td>
  161. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  162. <td class="confluenceTd"><p> <code>no</code> </p></td>
  163. <td class="confluenceTd"><p> <code>false</code> </p></td>
  164. <td class="confluenceTd"><p> Who to apply the DTMF parking feature to when parked calls are picked up or timeout. </p></td>
  165. </tr>
  166. <tr>
  167. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_parking_29394918.html"><code>parkedcallhangup</code></a> </p></td>
  168. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  169. <td class="confluenceTd"><p> <code>no</code> </p></td>
  170. <td class="confluenceTd"><p> <code>false</code> </p></td>
  171. <td class="confluenceTd"><p> Who to apply the DTMF hangup feature to when parked calls are picked up or timeout. </p></td>
  172. </tr>
  173. <tr>
  174. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_parking_29394918.html"><code>parkedcallrecording</code></a> </p></td>
  175. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  176. <td class="confluenceTd"><p> <code>no</code> </p></td>
  177. <td class="confluenceTd"><p> <code>false</code> </p></td>
  178. <td class="confluenceTd"><p> Who to apply the DTMF MixMonitor recording feature to when parked calls are picked up or timeout. </p></td>
  179. </tr>
  180. <tr>
  181. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_res_parking_29394918.html"><code>findslot</code></a> </p></td>
  182. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  183. <td class="confluenceTd"><p> <code>first</code> </p></td>
  184. <td class="confluenceTd"><p> <code>false</code> </p></td>
  185. <td class="confluenceTd"><p> Rule to use when trying to figure out which parking space a call should be parked with. </p></td>
  186. </tr>
  187. <tr>
  188. <td class="confluenceTd"><p> <code>courtesytone</code> </p></td>
  189. <td class="confluenceTd"><p> </p></td>
  190. <td class="confluenceTd"><p> </p></td>
  191. <td class="confluenceTd"><p> </p></td>
  192. <td class="confluenceTd"><p> If set, the sound set will be played to whomever is set by parkedplay </p></td>
  193. </tr>
  194. </tbody></table></div>
  195. <h4 id="Asterisk13Configuration_res_parking-ConfigurationOptionDescriptions">Configuration Option Descriptions</h4>
  196. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_parking-parking_lot_context"></span></p>
  197. <h5 id="Asterisk13Configuration_res_parking-context">context</h5>
  198. <p>This option is only used if parkext is set.</p>
  199. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_parking-parking_lot_parkext"></span></p>
  200. <h5 id="Asterisk13Configuration_res_parking-parkext">parkext</h5>
  201. <p>If this option is used, this extension will automatically be created to place calls into parking lots. In addition, if parkext_exclusive is set for this parking lot, the name of the parking lot will be included in the application's arguments so that it only parks to this parking lot. The extension will be created in <code>context</code>. Using this option also creates extensions for retrieving parked calls from the parking spaces in the same context.</p>
  202. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_parking-parking_lot_parkpos"></span></p>
  203. <h5 id="Asterisk13Configuration_res_parking-parkpos">parkpos</h5>
  204. <p>If parkext is set, these extensions will automatically be mapped in <code>context</code> in order to pick up calls parked to these parking spaces.</p>
  205. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_parking-parking_lot_comebacktoorigin"></span></p>
  206. <h5 id="Asterisk13Configuration_res_parking-comebacktoorigin">comebacktoorigin</h5>
  207. <p>Valid Options:</p>
  208. <ul>
  209. <li><code>yes</code> - Automatically have the parked channel dial the device that parked the call with dial timeout set by the <code>parkingtime</code> option. When the call times out an extension to dial the PARKER will automatically be created in the <code>park-dial</code> context with an extension of the flattened parker device name. If the call is not answered, the parked channel that is timing out will continue in the dial plan at that point if there are more priorities in the extension (which won't be the case unless the dialplan deliberately includes such priorities in the <code>park-dial</code> context through pattern matching or deliberately written flattened peer extensions).</li>
  210. <li><code>no</code> - Place the call into the PBX at <code>comebackcontext</code> instead. The extension will still be set as the flattened peer name. If an extension the flattened peer name isn't available then it will fall back to the <code>s</code> extension. If that also is unavailable it will attempt to fall back to <code>s@default</code>. The normal dial extension will still be created in the <code>park-dial</code> context with the extension also being the flattened peer name.
  211. <div class="aui-message hint shadowed information-macro">
  212. <p class="title">Note</p>
  213. <span class="aui-icon icon-hint">Icon</span>
  214. <div class="message-content">
  215. <p>Flattened Peer Names - Extensions can not include slash characters since those are used for pattern matching. When a peer name is flattened, slashes become underscores. For example if the parker of a call is called <code>SIP/0004F2040001</code> then flattened peer name and therefor the extensions created and used on timeouts will be <code>SIP_0004F204001</code>.</p>
  216. </div>
  217. </div>
  218. <div class="aui-message hint shadowed information-macro">
  219. <p class="title">Note</p>
  220. <span class="aui-icon icon-hint">Icon</span>
  221. <div class="message-content">
  222. <p>When parking times out and the channel returns to the dial plan, the following variables are set:</p>
  223. </div>
  224. </div>
  225. </li>
  226. <li><code>PARKING_SPACE</code> - extension that the call was parked in prior to timing out.</li>
  227. <li><code>PARKINGSLOT</code> - Deprecated. Use <code>PARKING_SPACE</code> instead.</li>
  228. <li><code>PARKEDLOT</code> - name of the lot that the call was parked in prior to timing out.</li>
  229. <li><code>PARKER</code> - The device that parked the call</li>
  230. <li><code>PARKER_FLAT</code> - The flat version of <code>PARKER</code></li>
  231. </ul>
  232. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_parking-parking_lot_comebackcontext"></span></p>
  233. <h5 id="Asterisk13Configuration_res_parking-comebackcontext">comebackcontext</h5>
  234. <p>The extension the call enters will prioritize the flattened peer name in this context. If the flattened peer name extension is unavailable, then the 's' extension in this context will be used. If that also is unavailable, the 's' extension in the 'default' context will be used.</p>
  235. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_parking-parking_lot_courtesytone"></span></p>
  236. <h5 id="Asterisk13Configuration_res_parking-courtesytone">courtesytone</h5>
  237. <p>By default, this tone is only played to the caller of a parked call. Who receives the tone can be changed using the <code>parkedplay</code> option.</p>
  238. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_parking-parking_lot_parkedplay"></span></p>
  239. <h5 id="Asterisk13Configuration_res_parking-parkedplay">parkedplay</h5>
  240. <ul>
  241. <li><code>no</code> - Apply to neither side.</li>
  242. <li><code>caller</code> - Apply only to the call connecting with the call coming out of the parking lot.</li>
  243. <li><code>callee</code> - Apply only to the call coming out of the parking lot.</li>
  244. <li><code>both</code> - Apply to both sides.
  245. <div class="aui-message hint shadowed information-macro">
  246. <p class="title">Note</p>
  247. <span class="aui-icon icon-hint">Icon</span>
  248. <div class="message-content">
  249. <p>If courtesy tone is not specified then this option will be ignored.</p>
  250. </div>
  251. </div>
  252. </li>
  253. </ul>
  254. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_parking-parking_lot_parkedcalltransfers"></span></p>
  255. <h5 id="Asterisk13Configuration_res_parking-parkedcalltransfers">parkedcalltransfers</h5>
  256. <ul>
  257. <li><code>no</code> - Apply to neither side.</li>
  258. <li><code>caller</code> - Apply only to the call connecting with the call coming out of the parking lot.</li>
  259. <li><code>callee</code> - Apply only to the call coming out of the parking lot.</li>
  260. <li><code>both</code> - Apply to both sides.</li>
  261. </ul>
  262. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_parking-parking_lot_parkedcallreparking"></span></p>
  263. <h5 id="Asterisk13Configuration_res_parking-parkedcallreparking">parkedcallreparking</h5>
  264. <ul>
  265. <li><code>no</code> - Apply to neither side.</li>
  266. <li><code>caller</code> - Apply only to the call connecting with the call coming out of the parking lot.</li>
  267. <li><code>callee</code> - Apply only to the call coming out of the parking lot.</li>
  268. <li><code>both</code> - Apply to both sides.</li>
  269. </ul>
  270. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_parking-parking_lot_parkedcallhangup"></span></p>
  271. <h5 id="Asterisk13Configuration_res_parking-parkedcallhangup">parkedcallhangup</h5>
  272. <ul>
  273. <li><code>no</code> - Apply to neither side.</li>
  274. <li><code>caller</code> - Apply only to the call connecting with the call coming out of the parking lot.</li>
  275. <li><code>callee</code> - Apply only to the call coming out of the parking lot.</li>
  276. <li><code>both</code> - Apply to both sides.</li>
  277. </ul>
  278. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_parking-parking_lot_parkedcallrecording"></span></p>
  279. <h5 id="Asterisk13Configuration_res_parking-parkedcallrecording">parkedcallrecording</h5>
  280. <ul>
  281. <li><code>no</code> - Apply to neither side.</li>
  282. <li><code>caller</code> - Apply only to the call connecting with the call coming out of the parking lot.</li>
  283. <li><code>callee</code> - Apply only to the call coming out of the parking lot.</li>
  284. <li><code>both</code> - Apply to both sides.</li>
  285. </ul>
  286. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_res_parking-parking_lot_findslot"></span></p>
  287. <h5 id="Asterisk13Configuration_res_parking-findslot">findslot</h5>
  288. <ul>
  289. <li><code>first</code> - Always try to place in the lowest available space in the parking lot</li>
  290. <li><code>next</code> - Track the last parking space used and always attempt to use the one immediately after.</li>
  291. </ul>
  292. <h3 id="Asterisk13Configuration_res_parking-ImportVersion">Import Version</h3>
  293. <p>This documentation was imported from Asterisk Version SVN-branch-13-r420717</p>
  294. </div>
  295. </div> </div>
  296. <div id="footer">
  297. <section class="footer-body">
  298. <p>Document generated by Confluence on Aug 11, 2014 13:48</p>
  299. </section>
  300. </div>
  301. </div> </body>
  302. </html>