Wed Mar 12 07:00:01 CET 2003
[asterisk/asterisk.git] / 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=IAX/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(IAX/${IAXINFO}@iaxtel.com/${EXTEN:1}@iaxtel)
88
89 [iaxprovider]
90 ;switch => IAX/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 => provider
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 => IAX/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(IAX/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 ;