Add timezone to the possible fields in a timespec.
[asterisk/asterisk.git] / configs / extensions.conf.sample
1 ; extensions.conf - the Asterisk dial plan
2 ;
3 ; Static extension configuration file, used by
4 ; the pbx_config module. This is where you configure all your 
5 ; inbound and outbound calls in Asterisk. 
6
7 ; This configuration file is reloaded 
8 ; - With the "dialplan reload" command in the CLI
9 ; - With the "reload" command (that reloads everything) in the CLI
10
11 ;
12 ; The "General" category is for certain variables.  
13 ;
14 [general]
15 ;
16 ; If static is set to no, or omitted, then the pbx_config will rewrite
17 ; this file when extensions are modified.  Remember that all comments
18 ; made in the file will be lost when that happens. 
19 ;
20 ; XXX Not yet implemented XXX
21 ;
22 static=yes
23 ;
24 ; if static=yes and writeprotect=no, you can save dialplan by
25 ; CLI command "dialplan save" too
26 ;
27 writeprotect=no
28 ;
29 ; If autofallthrough is set, then if an extension runs out of
30 ; things to do, it will terminate the call with BUSY, CONGESTION
31 ; or HANGUP depending on Asterisk's best guess. This is the default.
32 ;
33 ; If autofallthrough is not set, then if an extension runs out of 
34 ; things to do, Asterisk will wait for a new extension to be dialed 
35 ; (this is the original behavior of Asterisk 1.0 and earlier).
36 ;
37 ;autofallthrough=no
38 ;
39 ;
40 ;
41 ; If extenpatternmatchnew is set (true, yes, etc), then a new algorithm that uses
42 ; a Trie to find the best matching pattern is used. In dialplans
43 ; with more than about 20-40 extensions in a single context, this
44 ; new algorithm can provide a noticeable speedup. 
45 ; With 50 extensions, the speedup is 1.32x
46 ; with 88 extensions, the speedup is 2.23x
47 ; with 138 extensions, the speedup is 3.44x
48 ; with 238 extensions, the speedup is 5.8x
49 ; with 438 extensions, the speedup is 10.4x
50 ; With 1000 extensions, the speedup is ~25x
51 ; with 10,000 extensions, the speedup is 374x
52 ; Basically, the new algorithm provides a flat response 
53 ; time, no matter the number of extensions.
54 ;
55 ; By default, the old pattern matcher is used. 
56 ;
57 ; ****This is a new feature! *********************
58 ; The new pattern matcher is for the brave, the bold, and 
59 ; the desperate. If you have large dialplans (more than about 50 extensions
60 ; in a context), and/or high call volume, you might consider setting 
61 ; this value to "yes" !!
62 ; Please, if you try this out, and are forced to return to the
63 ; old pattern matcher, please report your reasons in a bug report
64 ; on bugs.digium.com. We have made good progress in providing something
65 ; compatible with the old matcher; help us finish the job!
66 ;
67 ; This value can be switched at runtime using the cli command "dialplan set extenpatternmatchnew true"
68 ; or "dialplan set extenpatternmatchnew false", so you can experiment to your hearts content.
69 ;
70 ;extenpatternmatchnew=no
71 ;
72 ; If clearglobalvars is set, global variables will be cleared 
73 ; and reparsed on a dialplan reload, or Asterisk reload.
74 ;
75 ; If clearglobalvars is not set, then global variables will persist
76 ; through reloads, and even if deleted from the extensions.conf or
77 ; one of its included files, will remain set to the previous value.
78 ;
79 ; NOTE: A complication sets in, if you put your global variables into
80 ; the AEL file, instead of the extensions.conf file. With clearglobalvars
81 ; set, a "reload" will often leave the globals vars cleared, because it
82 ; is not unusual to have extensions.conf (which will have no globals)
83 ; load after the extensions.ael file (where the global vars are stored).
84 ; So, with "reload" in this particular situation, first the AEL file will
85 ; clear and then set all the global vars, then, later, when the extensions.conf
86 ; file is loaded, the global vars are all cleared, and then not set, because
87 ; they are not stored in the extensions.conf file.
88 ;
89 clearglobalvars=no
90 ;
91 ; If priorityjumping is set to 'yes', then applications that support
92 ; 'jumping' to a different priority based on the result of their operations
93 ; will do so (this is backwards compatible behavior with pre-1.2 releases
94 ; of Asterisk). Individual applications can also be requested to do this
95 ; by passing a 'j' option in their arguments.
96 ;
97 ;priorityjumping=yes
98 ;
99 ; User context is where entries from users.conf are registered.  The
100 ; default value is 'default'
101 ;
102 ;userscontext=default
103 ;
104 ; You can include other config files, use the #include command
105 ; (without the ';'). Note that this is different from the "include" command
106 ; that includes contexts within other contexts. The #include command works
107 ; in all asterisk configuration files.
108 ;#include "filename.conf"
109
110 ; The "Globals" category contains global variables that can be referenced
111 ; in the dialplan with the GLOBAL dialplan function:
112 ; ${GLOBAL(VARIABLE)}
113 ; ${${GLOBAL(VARIABLE)}} or ${text${GLOBAL(VARIABLE)}} or any hybrid
114 ; Unix/Linux environmental variables can be reached with the ENV dialplan
115 ; function: ${ENV(VARIABLE)}
116 ;
117 [globals]
118 CONSOLE=Console/dsp                             ; Console interface for demo
119 ;CONSOLE=DAHDI/1
120 ;CONSOLE=Phone/phone0
121 IAXINFO=guest                                   ; IAXtel username/password
122 ;IAXINFO=myuser:mypass
123 TRUNK=DAHDI/G2                                  ; Trunk interface
124 ;
125 ; Note the 'G2' in the TRUNK variable above. It specifies which group (defined
126 ; in dahdi.conf) to dial, i.e. group 2, and how to choose a channel to use in
127 ; the specified group. The four possible options are:
128 ;
129 ; g: select the lowest-numbered non-busy DAHDI channel
130 ;    (aka. ascending sequential hunt group).
131 ; G: select the highest-numbered non-busy DAHDI channel
132 ;    (aka. descending sequential hunt group).
133 ; r: use a round-robin search, starting at the next highest channel than last
134 ;    time (aka. ascending rotary hunt group).
135 ; R: use a round-robin search, starting at the next lowest channel than last
136 ;    time (aka. descending rotary hunt group).
137 ;
138 TRUNKMSD=1                                      ; MSD digits to strip (usually 1 or 0)
139 ;TRUNK=IAX2/user:pass@provider
140
141 ;
142 ; Any category other than "General" and "Globals" represent 
143 ; extension contexts, which are collections of extensions.  
144 ;
145 ; Extension names may be numbers, letters, or combinations
146 ; thereof. If an extension name is prefixed by a '_'
147 ; character, it is interpreted as a pattern rather than a
148 ; literal.  In patterns, some characters have special meanings:
149 ;
150 ;   X - any digit from 0-9
151 ;   Z - any digit from 1-9
152 ;   N - any digit from 2-9
153 ;   [1235-9] - any digit in the brackets (in this example, 1,2,3,5,6,7,8,9)
154 ;   . - wildcard, matches anything remaining (e.g. _9011. matches 
155 ;       anything starting with 9011 excluding 9011 itself)
156 ;   ! - wildcard, causes the matching process to complete as soon as
157 ;       it can unambiguously determine that no other matches are possible
158 ;
159 ; For example, the extension _NXXXXXX would match normal 7 digit dialings, 
160 ; while _1NXXNXXXXXX would represent an area code plus phone number
161 ; preceded by a one.
162 ;
163 ; Each step of an extension is ordered by priority, which must always start
164 ; with 1 to be considered a valid extension.  The priority "next" or "n" means
165 ; the previous priority plus one, regardless of whether the previous priority
166 ; was associated with the current extension or not.  The priority "same" or "s"
167 ; means the same as the previously specified priority, again regardless of
168 ; whether the previous entry was for the same extension.  Priorities may be
169 ; immediately followed by a plus sign and another integer to add that amount
170 ; (most useful with 's' or 'n').  Priorities may then also have an alias, or
171 ; label, in parentheses after their name which can be used in goto situations.
172 ;
173 ; Contexts contain several lines, one for each step of each extension.  One may
174 ; include another context in the current one as well, optionally with a date
175 ; and time.  Included contexts are included in the order they are listed.
176 ; Switches may also be included within a context.  The order of matching within
177 ; a context is always exact extensions, pattern match extensions, includes, and
178 ; switches.  Includes are always processed depth-first.  So for example, if you
179 ; would like a switch "A" to match before context "B", simply put switch "A" in
180 ; an included context "C", where "C" is included in your original context
181 ; before "B".
182 ;
183 ;[context]
184 ;exten => someexten,{priority|label{+|-}offset}[(alias)],application(arg1,arg2,...)
185 ;
186 ; Timing list for includes is 
187 ;
188 ;   <time range>,<days of week>,<days of month>,<months>[,<timezone>]
189 ;
190 ; Note that ranges may be specified to wrap around the ends.  Also, minutes are
191 ; fine-grained only down to the closest even minute.
192 ;
193 ;include => daytime,9:00-17:00,mon-fri,*,*
194 ;include => weekend,*,sat-sun,*,*
195 ;include => weeknights,17:02-8:58,mon-fri,*,*
196 ;
197 ; ignorepat can be used to instruct drivers to not cancel dialtone upon receipt
198 ; of a particular pattern.  The most commonly used example is of course '9'
199 ; like this:
200 ;
201 ;ignorepat => 9
202 ;
203 ; so that dialtone remains even after dialing a 9.  Please note that ignorepat
204 ; only works with channels which receive dialtone from the PBX, such as DAHDI,
205 ; Phone, and VPB.  Other channels, such as SIP and MGCP, which generate their
206 ; own dialtone and converse with the PBX only after a number is complete, are
207 ; generally unaffected by ignorepat (unless DISA or another method is used to
208 ; generate a dialtone after answering the channel).
209 ;
210
211 ;
212 ; Sample entries for extensions.conf
213 ;
214 ;
215 [dundi-e164-canonical]
216 ;include => stdexten
217 ;
218 ; List canonical entries here
219 ;
220 ;exten => 12564286000,1,Gosub(stdexten(6000,IAX2/foo))
221 ;exten => 12564286000,n,Goto(default,s,1)       ; exited Voicemail
222 ;exten => _125642860XX,1,Dial(IAX2/otherbox/${EXTEN:7})
223
224 [dundi-e164-customers]
225 ;
226 ; If you are an ITSP or Reseller, list your customers here.
227 ;
228 ;exten => _12564286000,1,Dial(SIP/customer1)
229 ;exten => _12564286001,1,Dial(IAX2/customer2)
230
231 [dundi-e164-via-pstn]
232 ;
233 ; If you are freely delivering calls to the PSTN, list them here
234 ;
235 ;exten => _1256428XXXX,1,Dial(DAHDI/G2/${EXTEN:7}) ; Expose all of 256-428 
236 ;exten => _1256325XXXX,1,Dial(DAHDI/G2/${EXTEN:7}) ; Ditto for 256-325
237
238 [dundi-e164-local]
239 ;
240 ; Context to put your dundi IAX2 or SIP user in for
241 ; full access
242 ;
243 include => dundi-e164-canonical
244 include => dundi-e164-customers
245 include => dundi-e164-via-pstn
246
247 [dundi-e164-switch]
248 ;
249 ; Just a wrapper for the switch
250 ;
251 switch => DUNDi/e164
252
253 [dundi-e164-lookup]
254 ;
255 ; Locally to lookup, try looking for a local E.164 solution
256 ; then try DUNDi if we don't have one.
257 ;
258 include => dundi-e164-local
259 include => dundi-e164-switch
260 ;
261 ; DUNDi can also be implemented as a Macro instead of using 
262 ; the Local channel driver. 
263 ;
264 [macro-dundi-e164]
265 ;
266 ; ARG1 is the extension to Dial
267 ;
268 ; Extension "s" is not a wildcard extension that matches "anything".
269 ; In macros, it is the start extension. In most other cases, 
270 ; you have to goto "s" to execute that extension.
271 ;
272 ; For wildcard matches, see above - all pattern matches start with
273 ; an underscore.
274 exten => s,1,Goto(${ARG1},1)
275 include => dundi-e164-lookup
276
277 ;
278 ; Here are the entries you need to participate in the IAXTEL
279 ; call routing system.  Most IAXTEL numbers begin with 1-700, but
280 ; there are exceptions.  For more information, and to sign
281 ; up, please go to www.gnophone.com or www.iaxtel.com
282 ;
283 [iaxtel700]
284 exten => _91700XXXXXXX,1,Dial(IAX2/${GLOBAL(IAXINFO)}@iaxtel.com/${EXTEN:1}@iaxtel)
285
286 ;
287 ; The SWITCH statement permits a server to share the dialplan with
288 ; another server. Use with care: Reciprocal switch statements are not
289 ; allowed (e.g. both A -> B and B -> A), and the switched server needs
290 ; to be on-line or else dialing can be severly delayed.
291 ;
292 [iaxprovider]
293 ;switch => IAX2/user:[key]@myserver/mycontext
294
295 [trunkint]
296 ;
297 ; International long distance through trunk
298 ;
299 exten => _9011.,1,Macro(dundi-e164,${EXTEN:4})
300 exten => _9011.,n,Dial(${GLOBAL(TRUNK)}/${EXTEN:${GLOBAL(TRUNKMSD)}})
301
302 [trunkld]
303 ;
304 ; Long distance context accessed through trunk
305 ;
306 exten => _91NXXNXXXXXX,1,Macro(dundi-e164,${EXTEN:1})
307 exten => _91NXXNXXXXXX,n,Dial(${GLOBAL(TRUNK)}/${EXTEN:${GLOBAL(TRUNKMSD)}})
308
309 [trunklocal]
310 ;
311 ; Local seven-digit dialing accessed through trunk interface
312 ;
313 exten => _9NXXXXXX,1,Dial(${GLOBAL(TRUNK)}/${EXTEN:${GLOBAL(TRUNKMSD)}})
314
315 [trunktollfree]
316 ;
317 ; Long distance context accessed through trunk interface
318 ;
319 exten => _91800NXXXXXX,1,Dial(${GLOBAL(TRUNK)}/${EXTEN:${GLOBAL(TRUNKMSD)}})
320 exten => _91888NXXXXXX,1,Dial(${GLOBAL(TRUNK)}/${EXTEN:${GLOBAL(TRUNKMSD)}})
321 exten => _91877NXXXXXX,1,Dial(${GLOBAL(TRUNK)}/${EXTEN:${GLOBAL(TRUNKMSD)}})
322 exten => _91866NXXXXXX,1,Dial(${GLOBAL(TRUNK)}/${EXTEN:${GLOBAL(TRUNKMSD)}})
323
324 [international]
325 ;
326 ; Master context for international long distance
327 ;
328 ignorepat => 9
329 include => longdistance
330 include => trunkint
331
332 [longdistance]
333 ;
334 ; Master context for long distance
335 ;
336 ignorepat => 9
337 include => local
338 include => trunkld
339
340 [local]
341 ;
342 ; Master context for local, toll-free, and iaxtel calls only
343 ;
344 ignorepat => 9
345 include => default
346 include => trunklocal
347 include => iaxtel700
348 include => trunktollfree
349 include => iaxprovider
350
351 ;Include parkedcalls (or the context you define in features conf)
352 ;to enable call parking.
353 include => parkedcalls
354 ;
355 ; You can use an alternative switch type as well, to resolve
356 ; extensions that are not known here, for example with remote 
357 ; IAX switching you transparently get access to the remote
358 ; Asterisk PBX
359
360 ; switch => IAX2/user:password@bigserver/local
361 ;
362 ; An "lswitch" is like a switch but is literal, in that
363 ; variable substitution is not performed at load time
364 ; but is passed to the switch directly (presumably to
365 ; be substituted in the switch routine itself)
366 ;
367 ; lswitch => Loopback/12${EXTEN}@othercontext
368 ;
369 ; An "eswitch" is like a switch but the evaluation of
370 ; variable substitution is performed at runtime before
371 ; being passed to the switch routine.
372 ;
373 ; eswitch => IAX2/context@${CURSERVER}
374
375 [macro-trunkdial]
376 ;
377 ; Standard trunk dial macro (hangs up on a dialstatus that should 
378 ; terminate call)
379 ;   ${ARG1} - What to dial
380 ;
381 exten => s,1,Dial(${ARG1})
382 exten => s,n,Goto(s-${DIALSTATUS},1)
383 exten => s-NOANSWER,1,Hangup
384 exten => s-BUSY,1,Hangup
385 exten => _s-.,1,NoOp
386
387 [stdexten]
388 ;
389 ; Standard extension subroutine:
390 ;   ${ARG1} - Extension
391 ;   ${ARG2} - Device(s) to ring
392 ;   ${ARG3} - Optional context in Voicemail (if empty, then "default")
393 ;
394 ; Note that the current version will drop through to the next priority in the
395 ; case of their pressing '#'.  This gives more flexibility in what do to next:
396 ; you can prompt for a new extension, or drop the call, or send them to a
397 ; general delivery mailbox, or...
398 ;
399 ; The use of the LOCAL() function is purely for convenience.  Any variable
400 ; initially declared as LOCAL() will disappear when the innermost Gosub context
401 ; in which it was declared returns.  Note also that you can declare a LOCAL()
402 ; variable on top of an existing variable, and its value will revert to its
403 ; previous value (before being declared as LOCAL()) upon Return.
404 ;
405 exten => _X.,50000(stdexten),NoOp(Start stdexten)
406 exten => _X.,n,Set(LOCAL(ext)=${ARG1})
407 exten => _X.,n,Set(LOCAL(dev)=${ARG2})
408 exten => _X.,n,Set(LOCAL(cntx)=${ARG3})
409
410 exten => _X.,n,Set(LOCAL(mbx)="${ext}"$["${cntx}" ? "@${cntx}" :: ""])
411 exten => _X.,n,Dial(${dev},20)                  ; Ring the interface, 20 seconds maximum
412 exten => _X.,n,Goto(stdexten-${DIALSTATUS},1)           ; Jump based on status (NOANSWER,BUSY,CHANUNAVAIL,CONGESTION,ANSWER)
413
414 exten => stdexten-NOANSWER,1,Voicemail(${mbx},u)        ; If unavailable, send to voicemail w/ unavail announce
415 exten => stdexten-NOANSWER,n,NoOp(Finish stdexten NOANSWER)
416 exten => stdexten-NOANSWER,n,Return()                   ; If they press #, return to start
417
418 exten => stdexten-BUSY,1,Voicemail(${mbx},b)
419                                                 ; If busy, send to voicemail w/ busy announce
420 exten => stdexten-BUSY,n,NoOp(Finish stdexten BUSY)
421 exten => stdexten-BUSY,n,Return()                       ; If they press #, return to start
422
423 exten => _stdexten[\-].,1,Goto(s-NOANSWER,1)            ; Treat anything else as no answer
424
425 exten => a,1,VoicemailMain(${mbx})              ; If they press *, send the user into VoicemailMain
426 exten => a,n,Return()
427
428 [stdPrivacyexten]
429 ;
430 ; Standard extension subroutine:
431 ;   ${ARG1} - Extension
432 ;   ${ARG2} - Device(s) to ring
433 ;   ${ARG3} - Optional DONTCALL context name to jump to (assumes the s,1 extension-priority)
434 ;   ${ARG4} - Optional TORTURE context name to jump to (assumes the s,1 extension-priority)`
435 ;   ${ARG5} - Context in voicemail (if empty, then "default")
436 ;
437 ; See above note in stdexten about priority handling on exit.
438 ;
439 exten => _X.,60000(stdPrivacyexten),NoOp(Start stdPrivacyexten)
440 exten => _X.,n,Set(LOCAL(ext)=${ARG1})
441 exten => _X.,n,Set(LOCAL(dev)=${ARG2})
442 exten => _X.,n,Set(LOCAL(dontcntx)=${ARG3})
443 exten => _X.,n,Set(LOCAL(tortcntx)=${ARG4})
444 exten => _X.,n,Set(LOCAL(cntx)=${ARG5})
445
446 exten => _X.,n,Set(LOCAL(mbx)="${ext}"$["${cntx}" ? "@${cntx}" :: ""])
447 exten => _X.,n,Dial(${dev},20,p)                        ; Ring the interface, 20 seconds maximum, call screening 
448                                                 ; option (or use P for databased call _X.creening)
449 exten => _X.,n,Goto(s-${DIALSTATUS},1)          ; Jump based on status (NOANSWER,BUSY,CHANUNAVAIL,CONGESTION,ANSWER)
450
451 exten => stdexten-NOANSWER,1,Voicemail(${mbx},u)        ; If unavailable, send to voicemail w/ unavail announce
452 exten => stdexten-NOANSWER,n,NoOp(Finish stdPrivacyexten NOANSWER)
453 exten => stdexten-NOANSWER,n,Return()                   ; If they press #, return to start
454
455 exten => stdexten-BUSY,1,Voicemail(${mbx},b)            ; If busy, send to voicemail w/ busy announce
456 exten => stdexten-BUSY,n,NoOp(Finish stdPrivacyexten BUSY)
457 exten => stdexten-BUSY,n,Return()                       ; If they press #, return to start
458
459 exten => stdexten-DONTCALL,1,Goto(${dontcntx},s,1)      ; Callee chose to send this call to a polite "Don't call again" script.
460
461 exten => stdexten-TORTURE,1,Goto(${tortcntx},s,1)       ; Callee chose to send this call to a telemarketer torture script.
462
463 exten => _stdexten-.,1,Goto(s-NOANSWER,1)               ; Treat anything else as no answer
464
465 exten => a,1,VoicemailMain(${mbx})              ; If they press *, send the user into VoicemailMain
466 exten => a,n,Return
467
468 [macro-page];
469 ;
470 ; Paging macro:
471 ;
472 ;       Check to see if SIP device is in use and DO NOT PAGE if they are
473 ;
474 ;   ${ARG1} - Device to page
475
476 exten => s,1,ChanIsAvail(${ARG1},js)                    ; j is for Jump and s is for ANY call
477 exten => s,n,GoToIf([${AVAILSTATUS} = "1"]?autoanswer:fail)
478 exten => s,n(autoanswer),Set(_ALERT_INFO="RA")                  ; This is for the PolyComs
479 exten => s,n,SIPAddHeader(Call-Info: Answer-After=0)    ; This is for the Grandstream, Snoms, and Others
480 exten => s,n,NoOp()                                     ; Add others here and Post on the Wiki!!!!
481 exten => s,n,Dial(${ARG1})
482 exten => s,n(fail),Hangup
483
484
485 [demo]
486 include => stdexten
487 ;
488 ; We start with what to do when a call first comes in.
489 ;
490 exten => s,1,Wait(1)                    ; Wait a second, just for fun
491 exten => s,n,Answer                     ; Answer the line
492 exten => s,n,Set(TIMEOUT(digit)=5)      ; Set Digit Timeout to 5 seconds
493 exten => s,n,Set(TIMEOUT(response)=10)  ; Set Response Timeout to 10 seconds
494 exten => s,n(restart),BackGround(demo-congrats) ; Play a congratulatory message
495 exten => s,n(instruct),BackGround(demo-instruct)        ; Play some instructions
496 exten => s,n,WaitExten                  ; Wait for an extension to be dialed.
497
498 exten => 2,1,BackGround(demo-moreinfo)  ; Give some more information.
499 exten => 2,n,Goto(s,instruct)
500
501 exten => 3,1,Set(LANGUAGE()=fr)         ; Set language to french
502 exten => 3,n,Goto(s,restart)            ; Start with the congratulations
503
504 exten => 1000,1,Goto(default,s,1)
505 ;
506 ; We also create an example user, 1234, who is on the console and has
507 ; voicemail, etc.
508 ;
509 exten => 1234,1,Playback(transfer,skip)         ; "Please hold while..." 
510                                         ; (but skip if channel is not up)
511 exten => 1234,n,Gosub(stdexten(1234,${GLOBAL(CONSOLE)}))
512 exten => 1234,n,Goto(default,s,1)               ; exited Voicemail
513
514 exten => 1235,1,Voicemail(1234,u)               ; Right to voicemail
515
516 exten => 1236,1,Dial(Console/dsp)               ; Ring forever
517 exten => 1236,n,Voicemail(1234,b)               ; Unless busy
518
519 ;
520 ; # for when they're done with the demo
521 ;
522 exten => #,1,Playback(demo-thanks)      ; "Thanks for trying the demo"
523 exten => #,n,Hangup                     ; Hang them up.
524
525 ;
526 ; A timeout and "invalid extension rule"
527 ;
528 exten => t,1,Goto(#,1)                  ; If they take too long, give up
529 exten => i,1,Playback(invalid)          ; "That's not valid, try again"
530
531 ;
532 ; Create an extension, 500, for dialing the
533 ; Asterisk demo.
534 ;
535 exten => 500,1,Playback(demo-abouttotry); Let them know what's going on
536 exten => 500,n,Dial(IAX2/guest@pbx.digium.com/s@default)        ; Call the Asterisk demo
537 exten => 500,n,Playback(demo-nogo)      ; Couldn't connect to the demo site
538 exten => 500,n,Goto(s,6)                ; Return to the start over message.
539
540 ;
541 ; Create an extension, 600, for evaluating echo latency.
542 ;
543 exten => 600,1,Playback(demo-echotest)  ; Let them know what's going on
544 exten => 600,n,Echo                     ; Do the echo test
545 exten => 600,n,Playback(demo-echodone)  ; Let them know it's over
546 exten => 600,n,Goto(s,6)                ; Start over
547
548 ;
549 ;       You can use the Macro Page to intercom a individual user
550 exten => 76245,1,Macro(page,SIP/Grandstream1)
551 ; or if your peernames are the same as extensions
552 exten => _7XXX,1,Macro(page,SIP/${EXTEN})
553 ;
554 ;
555 ; System Wide Page at extension 7999
556 ;
557 exten => 7999,1,Set(TIMEOUT(absolute)=60)
558 exten => 7999,2,Page(Local/Grandstream1@page&Local/Xlite1@page&Local/1234@page/n,d)
559
560 ; Give voicemail at extension 8500
561 ;
562 exten => 8500,1,VoicemailMain
563 exten => 8500,n,Goto(s,6)
564 ;
565 ; Here's what a phone entry would look like (IXJ for example)
566 ;
567 ;exten => 1265,1,Dial(Phone/phone0,15)
568 ;exten => 1265,n,Goto(s,5)
569
570 ;
571 ;       The page context calls up the page macro that sets variables needed for auto-answer
572 ;       It is in is own context to make calling it from the Page() application as simple as 
573 ;       Local/{peername}@page
574 ;
575 [page]
576 exten => _X.,1,Macro(page,SIP/${EXTEN})
577
578 ;[mainmenu]
579 ;
580 ; Example "main menu" context with submenu
581 ;
582 ;exten => s,1,Answer
583 ;exten => s,n,Background(thanks)                ; "Thanks for calling press 1 for sales, 2 for support, ..."
584 ;exten => s,n,WaitExten
585 ;exten => 1,1,Goto(submenu,s,1)
586 ;exten => 2,1,Hangup
587 ;include => default
588 ;
589 ;[submenu]
590 ;exten => s,1,Ringing                                   ; Make them comfortable with 2 seconds of ringback
591 ;exten => s,n,Wait,2
592 ;exten => s,n,Background(submenuopts)   ; "Thanks for calling the sales department.  Press 1 for steve, 2 for..."
593 ;exten => s,n,WaitExten
594 ;exten => 1,1,Goto(default,steve,1)
595 ;exten => 2,1,Goto(default,mark,2)
596
597 [default]
598 ;
599 ; By default we include the demo.  In a production system, you 
600 ; probably don't want to have the demo there.
601 ;
602 include => demo
603
604 ;
605 ; An extension like the one below can be used for FWD, Nikotel, sipgate etc.
606 ; Note that you must have a [sipprovider] section in sip.conf
607 ;
608 ;exten => _41X.,1,Dial(SIP/${EXTEN:2}@sipprovider,,r)
609
610 ; Real extensions would go here. Generally you want real extensions to be
611 ; 4 or 5 digits long (although there is no such requirement) and start with a
612 ; single digit that is fairly large (like 6 or 7) so that you have plenty of
613 ; room to overlap extensions and menu options without conflict.  You can alias
614 ; them with names, too, and use global variables
615
616 ;exten => 6245,hint,SIP/Grandstream1&SIP/Xlite1(Joe Schmoe) ; Channel hints for presence
617 ;exten => 6245,1,Dial(SIP/Grandstream1,20,rt)   ; permit transfer
618 ;exten => 6245,n(dial),Dial(${HINT},20,rtT)     ; Use hint as listed
619 ;exten => 6245,n,Voicemail(6245,u)              ; Voicemail (unavailable)
620 ;exten => 6245,s+1,Hangup                       ; s+1, same as n
621 ;exten => 6245,dial+101,Voicemail(6245,b)       ; Voicemail (busy)
622 ;exten => 6361,1,Dial(IAX2/JaneDoe,,rm)         ; ring without time limit
623 ;exten => 6389,1,Dial(MGCP/aaln/1@192.168.0.14)
624 ;exten => 6390,1,Dial(JINGLE/caller/callee) ; Dial via jingle using labels
625 ;exten => 6391,1,Dial(JINGLE/asterisk@digium.com/mogorman@astjab.org) ;Dial via jingle using asterisk as the transport and calling mogorman.
626 ;exten => 6394,1,Dial(Local/6275/n)             ; this will dial ${MARK}
627
628 ;exten => 6275,1,Gosub(stdexten(6275,${MARK}))
629                                                 ; assuming ${MARK} is something like DAHDI/2
630 ;exten => 6275,n,Goto(default,s,1)              ; exited Voicemail
631 ;exten => mark,1,Goto(6275,1)                   ; alias mark to 6275
632 ;exten => 6536,1,Gosub(stdexten(6236,${WIL}))
633                                                 ; Ditto for wil
634 ;exten => 6536,n,Goto(default,s,1)              ; exited Voicemail
635 ;exten => wil,1,Goto(6236,1)
636
637 ;If you want to subscribe to the status of a parking space, this is
638 ;how you do it. Subscribe to extension 6600 in sip, and you will see
639 ;the status of the first parking lot with this extensions' help
640 ;exten => 6600,hint,park:701@parkedcalls
641 ;exten => 6600,1,noop
642 ;
643 ; Some other handy things are an extension for checking voicemail via
644 ; voicemailmain
645 ;
646 ;exten => 8500,1,VoicemailMain
647 ;exten => 8500,n,Hangup
648 ;
649 ; Or a conference room (you'll need to edit meetme.conf to enable this room)
650 ;
651 ;exten => 8600,1,Meetme(1234)
652 ;
653 ; Or playing an announcement to the called party, as soon it answers
654 ;
655 ;exten = 8700,1,Dial(${MARK},30,A(/path/to/my/announcemsg))
656 ;
657
658 ; example of a compartmentalized company called "acme"
659 ;
660 ; this is the context that your incoming IAX/SIP trunk dumps you in...
661 ;[acme-incoming]
662 ;exten => s,1,Wait(1)
663 ;exten => s,n,Answer()
664 ;exten => s,n(menu),Playback(acme/vm-brief-menu)
665 ;exten => s,n(exten),Background(vm-enter-num-to-call)
666 ;exten => s,n,WaitExten(5)
667 ;exten => s,n(goodbye),Playback(vm-goodbye)
668 ;exten => s,n(end),Hangup()
669 ;
670 ;include  => acme-extens
671 ;
672 ;exten => i,1,Playback(vm-invalid)
673 ;exten => i,n,Goto(s,exten)                     ; optionally, transfer to operator
674 ;
675 ;exten => t,1,Goto(s,goodbye)
676 ;
677 ; this is the context our internal SIP hardphones use (see sip.conf)
678 ;
679 ;[acme-internal]
680 ;exten => s,1,Answer()
681 ;exten => s,n(exten),Background(vm-enter-num-to-call)
682 ;exten => s,n,WaitExten(5)
683 ;exten => s,n(goodbye),Playback(vm-goodbye)
684 ;exten => s,n(end),Hangup()
685 ;
686 ;include => trunkint
687 ;include => trunkld
688 ;include => trunklocal
689 ;
690 ;include => acme-extens
691 ;
692 ; you can test what your system sounds like to outside callers by dialing this
693 ;exten => 777,1,DISA(no-password,acme-incoming)
694 ;
695 ; grouping of acme's extensions... never used directly, always included.
696 ;
697 ;[acme-extens]
698 ;include => stdexten
699 ;exten => 111,1,Gosub(stdexten(111,SIP/pete_1,acme))
700 ;exten => 111,n,Goto(s,exten)
701 ;
702 ;exten => 112,1,Gosub(stdexten(112,SIP/nancy_1,acme))
703 ;exten => 112,n,Goto(s,end)
704 ;
705 ; end of acme example
706
707
708 ; For more information on applications, just type "core show applications" at your
709 ; friendly Asterisk CLI prompt.
710 ;
711 ; "core show application <command>" will show details of how you
712 ; use that particular application in this file, the dial plan. 
713 ; "core show functions" will list all dialplan functions
714 ; "core show function <COMMAND>" will show you more information about
715 ; one function. Remember that function names are UPPER CASE.