summaryrefslogtreecommitdiff
path: root/configs/features.conf.sample
diff options
context:
space:
mode:
Diffstat (limited to 'configs/features.conf.sample')
-rw-r--r--configs/features.conf.sample30
1 files changed, 27 insertions, 3 deletions
diff --git a/configs/features.conf.sample b/configs/features.conf.sample
index 84a0ee06c..eb04c3c41 100644
--- a/configs/features.conf.sample
+++ b/configs/features.conf.sample
@@ -11,9 +11,33 @@ context => parkedcalls ; Which context parked calls are in (default parking lot
;parkinghints = no ; Add hints priorities automatically for parking slots (default is no).
;parkingtime => 45 ; Number of seconds a call can be parked for
; (default is 45 seconds)
-;comebacktoorigin = yes ; Whether to return to the original calling extension upon parking
- ; timeout or to send the call to context 'parkedcallstimeout' at
- ; extension 's', priority '1' (default is yes).
+
+;comebacktoorigin = yes ; Setting this option configures the behavior of call parking when the
+ ; parked call times out (See the parkingtime option). The default value is 'yes'.
+ ;
+ ; 'yes' - When the parked call times out, attempt to send the call back to the peer
+ ; that parked this call. This is done by saving off the name of the channel
+ ; that parked the call.
+ ;
+ ; 'no' - This option is useful for performing custom dialplan functionality prior to
+ ; sending the call back to the extension that initially parked the call, or to
+ ; an entirely different destination.
+ ;
+ ; When the parked call times out, send it back to the dialplan. The location
+ ; will be the 'parkedcallstimeout' context. The extension will be built from
+ ; the saved channel name that parked the call. For example, if a SIP peer named
+ ; '0004F2040001' parked this call, the extension will be 'SIP_0004F2040001'.
+ ; (Note that an underscore is used here because the '/' character has a special
+ ; meaning in extension names for CallerID matching.) If this extension does not
+ ; exist, the call will be sent to the 's' extension, instead. Finally, if the 's'
+ ; extension of 'parkedcallstimeout' does not exist, the call will fall back to the
+ ; 's' extension of the 'default' context.
+ ;
+ ; Additionally, in this example an extension of 'SIP_0004F2040001' will be
+ ; created in the 'park-dial' context. This extension will be set up to do a
+ ; Dial() to 'SIP/0004F2040001'.
+ ;
+
;courtesytone = beep ; Sound file to play to the parked caller
; when someone dials a parked call
; or the Touch Monitor is activated/deactivated.