features.conf.sample 8.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122
  1. ;
  2. ; Sample Call Features (transfer, monitor/mixmonitor, etc) configuration
  3. ;
  4. ; Note: From Asterisk 12 - All parking lot configuration is now done in res_parking.conf
  5. [general]
  6. ;transferdigittimeout => 3 ; Number of seconds to wait between digits when transferring a call
  7. ; (default is 3 seconds)
  8. ;xfersound = beep ; to indicate an attended transfer is complete
  9. ;xferfailsound = beeperr ; to indicate a failed transfer
  10. ;pickupexten = *8 ; Configure the pickup extension. (default is *8)
  11. ;pickupsound = beep ; to indicate a successful pickup (default: no sound)
  12. ;pickupfailsound = beeperr ; to indicate that the pickup failed (default: no sound)
  13. ;featuredigittimeout = 1000 ; Max time (ms) between digits for
  14. ; feature activation (default is 1000 ms)
  15. ;recordingfailsound = beeperr ; indicates that a one-touch monitor or one-touch mixmonitor feature failed
  16. ; to be applied to the call. (default: no sound)
  17. ;atxfernoanswertimeout = 15 ; Timeout for answer on attended transfer default is 15 seconds.
  18. ;atxferdropcall = no ; If someone does an attended transfer, then hangs up before the transfer
  19. ; target answers, then by default, the system will try to call back the
  20. ; person that did the transfer. If this is set to "yes", the ringing
  21. ; transfer target is immediately transferred to the transferee.
  22. ;atxferloopdelay = 10 ; Number of seconds to sleep between retries (if atxferdropcall = no)
  23. ;atxfercallbackretries = 2 ; Number of times to attempt to send the call back to the transferer.
  24. ; By default, this is 2.
  25. ;transferdialattempts = 3 ; Number of times that a transferer may attempt to dial an extension before
  26. ; being kicked back to the original call.
  27. ;transferretrysound = "beep" ; Sound to play when a transferer fails to dial a valid extension.
  28. ;transferinvalidsound = "beeperr" ; Sound to play when a transferer fails to dial a valid extension and is out of retries.
  29. ;atxferabort = *1 ; cancel the attended transfer
  30. ;atxfercomplete = *2 ; complete the attended transfer, dropping out of the call
  31. ;atxferthreeway = *3 ; complete the attended transfer, but stay in the call. This will turn the call into a multi-party bridge
  32. ;atxferswap = *4 ; swap to the other party. Once an attended transfer has begun, this options may be used multiple times
  33. ; Note that the DTMF features listed below only work when two channels have answered and are bridged together.
  34. ; They can not be used while the remote party is ringing or in progress. If you require this feature you can use
  35. ; chan_local in combination with Answer to accomplish it.
  36. [featuremap]
  37. ;blindxfer => #1 ; Blind transfer (default is #) -- Make sure to set the T and/or t option in the Dial() or Queue() app call!
  38. ;disconnect => *0 ; Disconnect (default is *) -- Make sure to set the H and/or h option in the Dial() or Queue() app call!
  39. ;automon => *1 ; One Touch Record a.k.a. Touch Monitor -- Make sure to set the W and/or w option in the Dial() or Queue() app call!
  40. ;atxfer => *2 ; Attended transfer -- Make sure to set the T and/or t option in the Dial() or Queue() app call!
  41. ;parkcall => #72 ; Park call (one step parking) -- Make sure to set the K and/or k option in the Dial() app call!
  42. ;automixmon => *3 ; One Touch Record a.k.a. Touch MixMonitor -- Make sure to set the X and/or x option in the Dial() or Queue() app call!
  43. [applicationmap]
  44. ; Note that the DYNAMIC_FEATURES channel variable must be set to use the features
  45. ; defined here. The value of DYNAMIC_FEATURES should be the names of the features
  46. ; to allow the channel to use separated by '#'. For example:
  47. ;
  48. ; Set(__DYNAMIC_FEATURES=myfeature1#myfeature2#myfeature3)
  49. ;
  50. ; (Note: The two leading underscores allow these feature settings to be set
  51. ; on the outbound channels, as well. Otherwise, only the original channel
  52. ; will have access to these features.)
  53. ;
  54. ; The syntax for declaring a dynamic feature is any of the following:
  55. ;
  56. ;<FeatureName> => <DTMF_sequence>,<ActivateOn>[/<ActivatedBy>],<Application>[,<AppArguments>[,MOH_Class]]
  57. ;<FeatureName> => <DTMF_sequence>,<ActivateOn>[/<ActivatedBy>],<Application>[,"<AppArguments>"[,MOH_Class]]
  58. ;<FeatureName> => <DTMF_sequence>,<ActivateOn>[/<ActivatedBy>],<Application>([<AppArguments>])[,MOH_Class]
  59. ;
  60. ; FeatureName -> This is the name of the feature used when setting the
  61. ; DYNAMIC_FEATURES variable to enable usage of this feature.
  62. ; DTMF_sequence -> This is the key sequence used to activate this feature.
  63. ; ActivateOn -> This is the channel of the call that the application will be executed
  64. ; on. Valid values are "self" and "peer". "self" means run the
  65. ; application on the same channel that activated the feature. "peer"
  66. ; means run the application on the opposite channel from the one that
  67. ; has activated the feature.
  68. ; ActivatedBy -> ActivatedBy is no longer honored. The feature is activated by which
  69. ; channel DYNAMIC_FEATURES includes the feature is on. Use a pre-dial
  70. ; handler to set different values for DYNAMIC_FEATURES on the channels.
  71. ; Historic values are: "caller", "callee", and "both".
  72. ; Application -> This is the application to execute.
  73. ; AppArguments -> These are the arguments to be passed into the application. If you need
  74. ; commas in your arguments, you should use either the second or third
  75. ; syntax, above.
  76. ; MOH_Class -> This is the music on hold class to play while the idle
  77. ; channel waits for the feature to complete. If left blank,
  78. ; no music will be played.
  79. ;
  80. ;
  81. ; IMPORTANT NOTE: The applicationmap is not intended to be used for all Asterisk
  82. ; applications. When applications are used in extensions.conf, they are executed
  83. ; by the PBX core. In this case, these applications are executed outside of the
  84. ; PBX core, so it does *not* make sense to use any application which has any
  85. ; concept of dialplan flow. Examples of this would be things like Goto,
  86. ; Background, WaitExten, and many more. The exceptions to this are Gosub and
  87. ; Macro routines which must complete for the call to continue.
  88. ;
  89. ; Enabling these features means that the PBX needs to stay in the media flow and
  90. ; media will not be re-directed if DTMF is sent in the media stream.
  91. ;
  92. ; Example Usage:
  93. ;
  94. ;testfeature => #9,peer,Playback,tt-monkeys ;Allow both the caller and callee to play
  95. ; ;tt-monkeys to the opposite channel
  96. ;
  97. ; Set arbitrary channel variables, based upon CALLERID number (Note that the application
  98. ; argument contains commas)
  99. ;retrieveinfo => #8,peer,Set(ARRAY(CDR(mark),CDR(name))=${ODBC_FOO(${CALLERID(num)})})
  100. ;
  101. ;pauseMonitor => #1,self/callee,Pausemonitor ;Allow the callee to pause monitoring
  102. ; ;on their channel
  103. ;unpauseMonitor => #3,self/callee,UnPauseMonitor ;Allow the callee to unpause monitoring
  104. ; ;on their channel
  105. ; Dynamic Feature Groups:
  106. ; Dynamic feature groups are groupings of features defined in [applicationmap]
  107. ; that can have their own custom key mappings. To give a channel access to a dynamic
  108. ; feature group, add the group name to the value of the DYNAMIC_FEATURES variable.
  109. ;
  110. ; example:
  111. ; [myGroupName] ; defines the group named myGroupName
  112. ; testfeature => #9 ; associates testfeature with the group and the keycode '#9'.
  113. ; pauseMonitor => ; associates pauseMonitor with the group and uses the keycode specified
  114. ; ; in the [applicationmap].