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