0f0f37e58a6eefea78349de89210bba509e46c59
[asterisk/asterisk.git] / configs / queues.conf.sample
1 [general]
2 ;
3 ; Global settings for call queues
4 ;
5 ; Persistent Members
6 ;    Store each dynamic agent in each queue in the astdb so that
7 ;    when asterisk is restarted, each agent will be automatically
8 ;    readded into their recorded queues. Default is 'yes'.
9 ;
10 persistentmembers = yes
11 ;
12 ; Note that a timeout to fail out of a queue may be passed as part of application call
13 ; from extensions.conf:
14 ; Queue(queuename|[options]|[optionalurl]|[announceoverride]|[timeout])
15 ; example: Queue(dave|t|||45)
16
17 ;[markq]
18 ;
19 ; A sample call queue
20 ;
21 ; Musiconhold sets which music applies for this particular
22 ; call queue (configure classes in musiconhold.conf)
23 ;
24 ;musiconhold = default
25 ;
26 ; An announcement may be specified which is played for the member as
27 ; soon as they answer a call, typically to indicate to them which queue
28 ; this call should be answered as, so that agents or members who are
29 ; listening to more than one queue can differentiated how they should
30 ; engage the customer
31 ;
32 ;announce = queue-markq
33 ;
34 ; A strategy may be specified.  Valid strategies include:
35 ;
36 ; ringall - ring all available channels until one answers (default)
37 ; roundrobin - take turns ringing each available interface 
38 ; leastrecent - ring interface which was least recently called by this queue
39 ; fewestcalls - ring the one with fewest completed calls from this queue
40 ; random - ring random interface
41 ; rrmemory - round robin with memory, remember where we left off last ring pass
42 ;
43 ;strategy = ringall
44 ;
45 ; Second settings for service level (default 0)
46 ; Used for service level statistics (calls completed within service level time frame)
47 ;servicelevel = 60
48 ;
49 ; A context may be specified, in which if the user types a SINGLE
50 ; digit extension while they are in the queue, they will be taken out
51 ; of the queue and sent to that extension in this context.
52 ;
53 ;context = qoutcon
54 ;
55 ; How long do we let the phone ring before we consider this a timeout...
56 ;
57 ;timeout = 15
58 ;
59 ; How long do we wait before trying all the members again?
60 ;
61 ;retry = 5
62 ;
63 ; Weight of queue - when compared to other queues, higher weights get 
64 ; first shot at available channels when the same channel is included in 
65 ; more than one queue.
66 ;
67 ;weight=0
68 ;
69 ; After a successful call, how long to wait before sending a potentially
70 ; free member another call (default is 0, or no delay)
71 ;
72 ;wrapuptime=15
73 ;
74 ; Maximum number of people waiting in the queue (0 for unlimited)
75 ;
76 ;maxlen = 0
77 ;
78 ;
79 ; How often to announce queue position and/or estimated holdtime to caller (0=off)
80 ;
81 ;announce-frequency = 90 
82 ;
83 ; Should we include estimated hold time in position announcements?
84 ; Either yes, no, or only once.
85 ; Hold time will be announced as the estimated time, 
86 ; or "less than 2 minutes" when appropriate.
87 ;
88 ;announce-holdtime = yes|no|once
89
90 ;
91 ; What's the rounding time for the seconds?
92 ; If this is non zero then we announce the seconds as well as the minutes rounded to this value
93 ;
94 ; announce-round-seconds = 10
95 ;
96 ; Use these sound files in making position/holdtime announcements.  The
97 ; defaults are as listed below -- change only if you need to.
98 ;
99 ;queue-youarenext = queue-youarenext            ;       ("You are now first in line.")
100 ;queue-thereare = queue-thereare                ;       ("There are")
101 ;queue-callswaiting = queue-callswaiting        ;       ("calls waiting.")
102 ;queue-holdtime = queue-holdtime                ;       ("The current est. holdtime is")
103 ;queue-minutes = queue-minutes                  ;       ("minutes.")
104 ;queue-seconds = queue-seconds                  ;       ("seconds.")
105 ;queue-thankyou = queue-thankyou                ;       ("Thank you for your patience.")
106 ;queue-lessthan = queue-less-than               ;       ("less than")
107 ;queue-reporthold = queue-reporthold            ;       ("Hold time")
108 ;
109 ; Calls may be recorded using Asterisk's monitor resource
110 ; This can be enabled from within the Queue application, starting recording
111 ; when the call is actually picked up; thus, only successful calls are
112 ; recorded, and you are not recording while people are listening to MOH.
113 ; To enable monitoring, simply specify "monitor-format";  it will be disabled
114 ; otherwise.
115 ;
116 ; You can specify the monitor filename with by calling SetVar(MONITOR_FILENAME=foo)
117 ; Otherwise it will use ${UNIQUEID}
118 ;
119 ; monitor-format = gsm|wav|wav49
120 ;
121 ; If you wish to have the two files joined together when the call ends set this to yes
122 ;
123 ; monitor-join = yes
124 ;
125 ; If you wish to allow queues that have no members currently to be joined, set this to yes
126 ;
127 ; joinempty = yes
128 ;
129 ; If you wish to remove callers from the queue if there are no agents present, set this to yes
130 ;
131 ; leavewhenempty = yes
132 ;
133 ; Asterisk can generate AgentCalled events when an agent is rung, if this is turned on
134 ; (may generate a LOT of extra manager events)
135 ;
136 ; eventwhencalled = yes
137 ;
138 ; If you wish to report the caller's hold time to the member before they are connected
139 ; to the caller, set this to yes.
140 ;
141 ; reportholdtime = no
142 ;
143 ;
144 ; If you wish to have a delay before the member is connected to the caller (or before the member
145 ; hears any announcement messages), set this to the number of seconds to delay.
146 ;
147 ; memberdelay = 0
148 ;
149 ; Each member of this call queue is listed on a separate line in
150 ; the form technology/dialstring.  "member" means a normal member of a
151 ; queue.  An optional penalty may be specified after a comma, such that
152 ; entries with higher penalties are considered last.
153 ;
154 ;member => Zap/1
155 ;member => Zap/2
156 ;member => Agent/1001
157 ;member => Agent/1002
158
159 ;
160 ; Note that using agent groups is probably not what you want.  Strategies do
161 ; not propagate down to the Agent system so if you want round robin, least
162 ; recent, etc, you should list all the agents in this file individually and not
163 ; use agent groups.
164 ;
165 ;member => Agent/@1             ; Any agent in group 1
166 ;member => Agent/:1,1           ; Any agent in group 1, wait for first
167                                 ; available, but consider with penalty
168