configs/extensions.conf.sample

   1 ;
   2 ; Static extension configuration files, used by
   3 ; the pbx_config module.
   4 ;
   5 ; The "General" category is for certain variables.
   6 ;
   7 [general]
   8 ;
   9 ; If static is set to no, or omitted, then the pbx_config will rewrite
  10 ; this file when extensions are modified.  Remember that all comments
  11 ; made in the file will be lost when that happens.
  12 ;
  13 ; XXX Not yet implemented XXX
  14 ;
  15 static=yes
  16 ;
  17 ; if static=yes and writeprotect=no, you can save dialplan by
  18 ; CLI command 'save dialplan' too
  19 ;
  20 writeprotect=no
  21
  22 ;
  23 ; The "Globals" category contains global variables that can be referenced
  24 ; in the dialplan with ${VARIABLE} or ${ENV(VARIABLE)} for Environmental variable
  25 ; ${${VARIABLE}} or ${text${VARIABLE}} or any hybrid
  26 ;
  27 [globals]
  28 CONSOLE=Console/dsp                             ; Console interface for demo
  29 ;CONSOLE=Zap/1
  30 ;CONSOLE=Phone/phone0
  31 IAXINFO=guest                                   ; IAXtel username/password
  32 ;IAXINFO=myuser:mypass
  33 TRUNK=Zap/g2                                    ; Trunk interface
  34 ;TRUNK=IAX2/user:pass@provider
  35
  36 ;
  37 ; Any category other than "General" and "Globals" represent
  38 ; extension contexts, which are collections of extensions.
  39 ;
  40 ; Extension names may be numbers, letters, or combinations
  41 ; thereof. If an extension name is prefixed by a '_'
  42 ; character, it is interpreted as a pattern rather than a
  43 ; literal.  In patterns, some characters have special meanings:
  44 ;
  45 ;   X - any digit from 0-9
  46 ;   N - any digit from 2-9
  47 ;   [1235-9] - any digit in the brackets (in this example, 1,2,3,5,6,7,8,9)
  48 ;   . - wildcard, matches anything remaining (e.g. _9011. matches anything starting with 9011 including 9011)
  49 ;
  50 ; For example the extenion _NXXXXXX would match normal 7 digit dialings, while
  51 ; _1NXXNXXXXXX would represent an area code plus phone number
  52 ; preceeded by a one.
  53 ;
  54 ; Contexts contain several lines, one for each step of each
  55 ; extension, which can take one of two forms as listed below,
  56 ; with the first form being preferred.  One may include another
  57 ; context in the current one as well, optionally with a
  58 ; date and time.  Included contexts are included in the order
  59 ; they are listed.
  60 ;
  61 ;[context]
  62 ;exten => someexten,priority,application(arg1,arg2,...)
  63 ;exten => someexten,priority,application,arg1|arg2...
  64 ;
  65 ; Timing list for includes is
  66 ;
  67 ;   <time range>|<days of week>|<days of month>|<months>
  68 ;
  69 ;include => daytime|9:00-17:00|mon-fri|*|*
  70 ;
  71 ; ignorepat can be used to instruct drivers to not cancel dialtone upon
  72 ; receipt of a particular pattern.  The most commonly used example is
  73 ; of course '9' like this:
  74 ;
  75 ;ignorepat => 9
  76 ;
  77 ; so that dialtone remains even after dialing a 9.
  78 ;
  79
  80 ;
  81 ; Here are the entries you need to participate in the IAXTEL
  82 ; call routing system.  Most IAXTEL numbers begin with 1-700, but
  83 ; there are exceptions.  For more information, and to sign
  84 ; up, please go to www.gnophone.com or www.iaxtel.com
  85 ;
  86 [iaxtel700]
  87 exten => _91700NXXXXXX,1,Dial(IAX2/${IAXINFO}@iaxtel.com/${EXTEN:1}@iaxtel)
  88
  89 [iaxprovider]
  90 ;switch => IAX2/user:[key]@myserver/mycontext
  91
  92 [trunkint]
  93 ;
  94 ; International long distance through trunk
  95 ;
  96 exten => 9011.,1,Dial(${TRUNK}/${EXTEN:1})
  97 exten => 9011.,2,Congestion
  98
  99 [trunkld]
 100 ;
 101 ; Long distance context accessed through trunk
 102 ;
 103 exten => _91NXXNXXXXXX,1,Dial(${TRUNK}/${EXTEN:1})
 104 exten => _91NXXNXXXXXX,2,Congestion
 105
 106 [trunklocal]
 107 ;
 108 ; Local seven-digit dialing accessed through trunk interface
 109 ;
 110 exten => _9NXXXXXX,1,Dial(${TRUNK}/${EXTEN:1})
 111 exten => _9NXXXXXX,2,Congestion
 112
 113 [trunktollfree]
 114 ;
 115 ; Long distance context accessed through trunk interface
 116 ;
 117 exten => _91800NXXXXXX,1,Dial(${TRUNK}/${EXTEN:1})
 118 exten => _91800NXXXXXX,2,Congestion
 119 exten => _91888NXXXXXX,1,Dial(${TRUNK}/${EXTEN:1})
 120 exten => _91888NXXXXXX,2,Congestion
 121 exten => _91877NXXXXXX,1,Dial(${TRUNK}/${EXTEN:1})
 122 exten => _91877NXXXXXX,2,Congestion
 123 exten => _91866NXXXXXX,1,Dial(${TRUNK}/${EXTEN:1})
 124 exten => _91866NXXXXXX,2,Congestion
 125
 126 [international]
 127 ;
 128 ; Master context for international long distance
 129 ;
 130 ignorepat => 9
 131 include => longdistance
 132 include => trunkint
 133
 134 [longdistance]
 135 ;
 136 ; Master context for long distance
 137 ;
 138 ignorepat => 9
 139 include => local
 140 include => trunkld
 141
 142 [local]
 143 ;
 144 ; Master context for local, toll-free, and iaxtel calls only
 145 ;
 146 ignorepat => 9
 147 include => default
 148 include => parkedcalls
 149 include => trunklocal
 150 include => iaxtel700
 151 include => trunktollfree
 152 include => iaxprovider
 153 ;
 154 ; You can use an alternative switch type as well, to resolve
 155 ; extensions that are not known here, for example with remote
 156 ; IAX switching you transparently get access to the remote
 157 ;
 158 ; switch => IAX2/user:password@bigserver/local
 159
 160 [macro-stdexten];
 161 ;
 162 ; Standard extension macro:
 163 ;   ${ARG1} - Extension  (we could have used ${MACRO_EXTEN} here as well
 164 ;   ${ARG2} - Device(s) to ring
 165 ;
 166 exten => s,1,Dial(${ARG2},20)                                   ; Ring the interface, 20 seconds maximum
 167 exten => s,2,Voicemail(u${ARG1})                                ; If unavailable, send to voicemail w/ unavail announce
 168 exten => s,3,Goto(default,s,1)                                  ; If they press #, return to start
 169 exten => s,102,Voicemail(b${ARG1})                              ; If busy, send to voicemail w/ busy announce
 170 exten => s,103,Goto(default,s,1)                                ; If they press #, return to start
 171
 172
 173 [demo]
 174 ;
 175 ; We start with what to do when a call first comes in.
 176 ;
 177 exten => s,1,Wait,1                     ; Wait a second, just for fun
 178 exten => s,2,Answer                     ; Answer the line
 179 exten => s,3,DigitTimeout,5             ; Set Digit Timeout to 5 seconds
 180 exten => s,4,ResponseTimeout,10         ; Set Response Timeout to 10 seconds
 181 exten => s,5,BackGround(demo-congrats)  ; Play a congratulatory message
 182 exten => s,6,BackGround(demo-instruct)  ; Play some instructions
 183
 184 exten => 2,1,BackGround(demo-moreinfo)  ; Give some more information.
 185 exten => 2,2,Goto(s,6)
 186
 187 exten => 3,1,SetLanguage(fr)            ; Set language to french
 188 exten => 3,2,Goto(s,5)                  ; Start with the congratulations
 189
 190 exten => 1000,1,Goto(default,s,1)
 191 ;
 192 ; We also create an example user, 1234, who is on the console and has
 193 ; voicemail, etc.
 194 ;
 195 exten => 1234,1,Playback(transfer,skip)         ; "Please hold while..."
 196                                         ; (but skip if channel is not up)
 197 exten => 1234,2,Macro(stdexten,1234,${CONSOLE})
 198
 199 exten => 1235,1,Voicemail(u1234)                ; Right to voicemail
 200
 201 exten => 1236,1,Dial(Console/dsp)               ; Ring forever
 202 exten => 1236,2,Voicemail(u1234)                ; Unless busy
 203
 204 ;
 205 ; # for when they're done with the demo
 206 ;
 207 exten => #,1,Playback(demo-thanks)              ; "Thanks for trying the demo"
 208 exten => #,2,Hangup                     ; Hang them up.
 209
 210 ;
 211 ; A timeout and "invalid extension rule"
 212 ;
 213 exten => t,1,Goto(#,1)                  ; If they take too long, give up
 214 exten => i,1,Playback(invalid)          ; "That's not valid, try again"
 215
 216 ;
 217 ; Create an extension, 500, for dialing the
 218 ; Asterisk demo.
 219 ;
 220 exten => 500,1,Playback(demo-abouttotry); Let them know what's going on
 221 exten => 500,2,Dial(IAX2/guest@misery.digium.com/s@default)     ; Call the Asterisk demo
 222 exten => 500,3,Playback(demo-nogo)      ; Couldn't connect to the demo site
 223 exten => 500,4,Goto(s,6)                ; Return to the start over message.
 224
 225 ;
 226 ; Create an extension, 600, for evaulating echo latency.
 227 ;
 228 exten => 600,1,Playback(demo-echotest)  ; Let them know what's going on
 229 exten => 600,2,Echo                     ; Do the echo test
 230 exten => 600,3,Playback(demo-echodone)  ; Let them know it's over
 231 exten => 600,4,Goto(s,6)                ; Start over
 232
 233 ;
 234 ; Give voicemail at extension 8500
 235 ;
 236 exten => 8500,1,VoicemailMain
 237 exten => 8500,2,Goto(s,6)
 238 ;
 239 ; Here's what a phone entry would look like (IXJ for example)
 240 ;
 241 ;exten => 1265,1,Dial(Phone/phone0,15)
 242 ;exten => 1265,2,Goto(s,5)
 243
 244 ;[mainmenu]
 245 ;
 246 ; Example "main menu" context with submenu
 247 ;
 248 ;exten => s,1,Answer
 249 ;exten => s,2,Background(thanks)                ; "Thanks for calling press 1 for sales, 2 for support, ..."
 250 ;exten => 1,1,Goto(submenu,s,1)
 251 ;exten => 2,1,Hangup
 252 ;include => default
 253 ;
 254 ;[submenu]
 255 ;exten => s,1,Ringing                                   ; Make them comfortable with 2 seconds of ringback
 256 ;exten => s,2,Wait,2
 257 ;exten => s,3,Background(submenuopts)   ; "Thanks for calling the sales department.  Press 1 for steve, 2 for..."
 258 ;exten => 1,1,Goto(default,steve,1)
 259 ;exten => 2,1,Goto(default,mark,2)
 260
 261 [default]
 262 ;
 263 ; By default we include the demo.  In a production system, you
 264 ; probably don't want to have the demo there.
 265 ;
 266 include => demo
 267
 268
 269 ; Real extensions would go here.  Generally you want real extensions to be 4 or 5
 270 ; digits long (although there is no such requirement) and start with a single
 271 ; digit that is fairly large (like 6 or 7) so that you have plenty of room to
 272 ; overlap extensions and menu options without conflict.  You can alias them with
 273 ; names, too and use global variables
 274
 275
 276 ;exten => 6275,Macro(stdexten,6275,${MARK})                     ; assuming ${MARK} is something like Zap/2
 277 ;exten => mark,1,Goto(6275|1)                                           ; alias mark to 6275
 278 ;exten => 6236,Macro(stdexten,6236,${WIL})                      ; Ditto for wil
 279 ;exten => wil,1,Goto(6236|1)
 280 ;
 281 ; Some other handy things are an extension for checking voicemail via
 282 ; voicemailmain
 283 ;
 284 ;exten => 8500,1,VoicemailMain
 285 ;exten => 8500,2,Hangup
 286 ;
 287 ; Or a conference room (you'll need to edit meetme.conf to enable this room)
 288 ;
 289 ;exten => 8600,1,Meetme,1234
 290 ;
 291 ; For more information on applications, just type "show applications" at your
 292 ; friendly Asterisk CLI prompt.
 293 ;