Queues & ring groups
Two ways to let a team answer a number. A queue holds callers with music until the next free agent answers. A ring group rings several people at once, or one after the other, and gives up after a set time.
- Queue numbers
- 8200–8299
- Ring group numbers
- 8300–8399
- Strategies
- 5 for queues, 2 for groups
- Changes apply
- To the next caller
Queue or ring group?
Use a queue when callers may have to wait: a bank's card services desk, a hospital's appointment line, a university admissions office in July. Use a ring group when someone is usually free and you only need several phones to ring: the front desk, the duty doctors' room, a small sales team.
| Queue | Ring group | |
|---|---|---|
| Callers wait | Yes, up to the maximum wait you set (30 s to 30 min) | No: the phones ring for the ring time, then the fallback |
| While waiting | Welcome message, music or ringing, a repeating message, position announcements | Ringing tone |
| Who rings | Free agents, by one of five strategies and by priority | Every member at once, or one after the other in your order |
| Agents can pause | Yes, from the Phone page or by an Admin | No |
| Live view and statistics | Waiting callers, agent status, answered, abandoned and average wait today; service level in Analytics | No |
| When nobody answers | Fallback: AI agent, ring group, voicemail, a person or goodbye | Fallback: AI agent, queue, voicemail, a person or goodbye |
| Numbers | 8200–8299 | 8300–8399 |
Each organization has its own number ranges, so two organizations on one installation can both have a queue 8201. Callers reach a queue or a ring group from a phone number's route (Numbers), from an IVR block, from another queue's or group's fallback, or by dialling its number from any phone of the organization.
How a queue call works
A caller presses 2 for Card services in the bank's IVR and lands in queue 8201. The queue rings its free agents by its strategy; an agent who does not answer within the ring time is skipped and the next one rings.
If nobody answers before the maximum wait, the caller leaves the queue and goes to the fallback:
Create a queue
Queues are created and changed by organization Admins. Changes apply to the next caller; nothing has to be reloaded.
Create it
Open Queues (under Configure) and choose New queue. Give it a name such as Card services, keep the suggested number or pick another free one from 8200 to 8299, and tick the people who answer its calls. A new queue starts as Round robin, 20 s per agent, 5 s wrap-up, 5 minutes maximum wait, position announcements on, and say goodbye and hang up as the fallback.
Check the agents
On the Agents tab, add or remove agents and set each one's priority.
Choose what callers hear
On What callers hear, pick a welcome message, the music, a repeating message and a message before the fallback, from your Sounds.
Set the rules
On Settings, choose the strategy, the ring time, the wrap-up time, the maximum wait and the fallback, then Save settings.
Send callers to it
Add a Call queue block to an IVR menu, or set a phone number's destination to the queue in Numbers. Call, next to the queue on the Queues page, dials it from your browser phone so you can hear it as a caller does.
Queue settings
Settings tab
Nameup to 80 charactersrequired- Shown to your team on the Queues page and on each agent's Phone page.
Number8200–8299required- Changing it keeps the agents. Update IVR blocks and phone numbers that use the old number.
Ring strategysee below- Which free agent rings first.
Ring each agent for5–60 s, default 20- How long one agent rings before the queue tries the next.
Wrap-up time0–120 s, default 5- Breathing room after a call before the agent gets the next one, to finish notes or a ticket.
Maximum wait30 s – 30 min, default 5 min- After this the caller leaves the queue and goes to the fallback.
Tell callers their positionon / off- Every 30 seconds callers hear their place in line. The expected waiting time is not announced.
When nobody answersfallback- Where the caller goes after the maximum wait, or straight away when no agent is signed in. See Fallbacks below.
Ring strategies
| Strategy | Who rings | Good for |
|---|---|---|
| Round robin | Agents take turns, starting after the one who answered last. | Sharing calls evenly in a contact centre (the default). |
| Ring all | Every free agent at once; the first to answer gets the call. | Small teams where speed matters more than fairness. |
| Longest idle | The agent who has been free longest. | Fairness by rest time. |
| Fewest calls | The agent who has answered the fewest calls. | Fairness by number of calls. |
| Random | Any free agent. | Teams with no preference. |
Built-in behaviour
- An agent who is already on a call is not rung.
- Between two attempts the queue waits 2 seconds.
- A queue has no length limit: everyone who calls can wait.
- If no agent is signed in on a phone or browser when a caller arrives, the caller does not wait; they go straight to the fallback. The same happens to waiting callers if every agent signs out.
- Agents can transfer the caller onward. The organization's recording rules apply to queue calls.
Agents
Agents are people of your organization, added by extension. One person can be an agent in several queues. A queue with no agents sends every caller straight to its fallback.
Priority
Each agent has a priority from 0 to 10. Priority 0 rings first; agents with a higher number only ring when everyone before them is busy. Put your card services staff at 0 and a supervisor at 5: the supervisor helps out only at peak times.
Status
| Status | Meaning | Gets calls |
|---|---|---|
| Available | Signed in on a phone or browser, not paused, not on a queue call. | Yes |
| On a call | Talking to a caller from this queue. | After the call and the wrap-up time |
| Paused | Signed in, but taking a break. | No |
| Offline | No phone or browser signed in. | No |
Pausing
- Agents pause and resume themselves on the Phone page, tab My queues, one queue at a time. It shows how many callers are waiting in each.
- Admins pause or resume any agent on the queue's Agents tab, for example when someone forgot to resume after lunch.
What callers hear
The queue's What callers hear tab sets four moments, in the order the caller meets them. Each one uses a sound from your library (Sounds).
| Moment | Choices | Example |
|---|---|---|
| 1. Welcome message | None, or a sound. Played once, before the caller starts waiting. | “Welcome to card services. This call may be recorded.” |
| 2. While waiting | The standard hold music, your own music (loops until an agent answers), or a ringing tone without music. | Your bank's jingle |
| 3. Repeating message | None, or a sound repeated every 30 s, 45 s, 1, 1.5, 2, 3 or 5 minutes. | “Thank you for waiting. You can also block your card in our app.” |
| 4. Before the fallback | None, or a sound played when nobody answered in time, just before the fallback. | “All our agents are busy. Please leave a message after the tone.” |
Sounds
Add sounds in Sounds (under Configure), or with New sound on the tab itself. Upload a recording (WAV, MP3, M4A, OGG, WebM and other common formats, up to 10 MB and 10 minutes), or type a text that is spoken in your organization's voice. Every sound is converted to 8 kHz mono, the format phone calls use. The same sounds serve IVR prompts and voicemail greetings, and Sounds shows where each one is used.
Fallbacks
A fallback is where a caller goes when the team cannot answer. A queue uses it after the maximum wait, or immediately when no agent is signed in. A ring group uses it when nobody answered within the ring time, or when it has no members.
| Fallback | Queue | Ring group | What the caller gets |
|---|---|---|---|
| Say goodbye and hang up | Yes | Yes | A goodbye message, then the call ends. |
| Hand over to an AI agent | Yes | Yes | The default AI agent, or a particular one (80xx), which can answer questions or take a message. |
| Ring a group | Yes | – | A ring group (83xx) rings. |
| Put in a queue | – | Yes | The caller waits in a queue (82xx). |
| Leave a voicemail for | Yes | Yes | That person's voicemail greeting and a message. |
| Ring a person | Yes | Yes | One person's phones ring, with their own call handling and voicemail. |
Offering a callback instead
Queues do not call people back by themselves. To offer one, put a Menu in front of the queue in your IVR (Press 1 to hold, press 2 and we will call you back), and connect key 2 to an Offer a callback block followed by Hang up. The caller's number lands in the team's Inbox and your systems receive call.callback_requested.
Live view and service level
The queue's Live tab is what a supervisor keeps open:
| Figure | Meaning |
|---|---|
| Waiting now | Callers in the queue at this moment, and how long the first has waited. |
| Agents available | Agents online, not paused and not on a call, out of all agents. |
| Answered today | Answered calls as a share of callers today, with the number who hung up and the number sent to the fallback. |
| Average wait | How long answered callers waited today, and the longest wait. |
| Callers waiting | Each waiting caller's number and time, in the order they will be answered. Waits over a minute are highlighted. |
| Agents | Each agent's status: Available, On a call, Paused or Offline. |
Service level
Analytics shows the share of queue calls answered within each queue's target time. The target is 20 seconds unless the queue was created by an IVR template with its own (60 seconds for card blocking desks, 20 seconds for a hospital's emergency department). Callers who hang up within 10 seconds do not count against it.
Events for your systems
Two webhooks report missed queue calls as they happen: queue.abandoned (a caller hung up while waiting) and queue.timeout (a caller waited the maximum time and went to the fallback). Use them to start a callback in your CRM.
Ring groups
A ring group gives several people one number. Create it in Ring groups (under Configure); it gets the next free number from 8300 to 8399.
Ring group
Nameup to 80 charactersrequired- For example Front desk or Duty doctors.
RingsEveryone at once | One after the other- At once: every member's phones ring together and the first to pick up takes the call. One after the other: each member rings in the order you set with the arrows, until someone answers.
Ring time10–60 s- For everyone at once, the total ring time; one after the other, the time for each person.
Membersup to 30 extensions- People of your organization, ticked in a list.
If nobody answersfallback- See Fallbacks above. A group with no members goes straight to it.
- The organization's recording rules apply to ring group calls.
- A ring group cannot be deleted while a phone number, a queue fallback or an IVR menu still uses it; the dashboard lists them so you can point them elsewhere first.
- The IVR's Ring group block can use a saved group, with its own order, ring time and fallback, or ring a quick list of extensions together without saving a group.
Troubleshooting
| Symptom | Check |
|---|---|
| Every caller goes straight to the fallback | No agent is signed in on a phone or browser, or the queue has no agents. Look at Agents available on the Live tab. |
| An agent is never rung | The agent is paused, offline, already on a call, or has a higher priority number than colleagues who are free. |
| Callers hear a fast busy tone | The number they dialled has no queue or ring group, for example after a number change. Update the IVR block or phone number route. |
| Music is not your own | The hold choice is the ringing tone or standard music, or the sound was deleted. Pick it again on What callers hear and Save. |
On the server, an operator can see a queue as Asterisk sees it. The queue's name is the organization's short name, -q and the number:
1sudo asterisk -rx "queue show sunrise-q8201" # members, their state, callers waiting2 3# today's queue events, from the call-centre log Asterisk writes to MariaDB4sudo mysql asterisk -e "SELECT event, COUNT(*) FROM queue_log5 WHERE queuename = 'sunrise-q8201' AND time >= UTC_DATE() GROUP BY event"