Caller journey / Queues & ring groupsAll pages
Caller journey

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.

QueueRing group
Callers waitYes, up to the maximum wait you set (30 s to 30 min)No: the phones ring for the ring time, then the fallback
While waitingWelcome message, music or ringing, a repeating message, position announcementsRinging tone
Who ringsFree agents, by one of five strategies and by priorityEvery member at once, or one after the other in your order
Agents can pauseYes, from the Phone page or by an AdminNo
Live view and statisticsWaiting callers, agent status, answered, abandoned and average wait today; service level in AnalyticsNo
When nobody answersFallback: AI agent, ring group, voicemail, a person or goodbyeFallback: AI agent, queue, voicemail, a person or goodbye
Numbers8200–82998300–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.

CallerCallerQueue 8201Queue 8201Agent 1001Agent 1001Agent 1002Agent 1002joins the queuefrom the IVR, a number or 82011welcome message2music on hold; position every 30 srings for 20 shis turn in the round4no answer52 s pause, then the next free agentrings for 20 s7answers8connectedrecording rules apply9after the call: 5 s wrap-up, then 1002 is free again
A Round robin queue: 1001 does not answer, so the caller goes to 1002.

If nobody answers before the maximum wait, the caller leaves the queue and goes to the fallback:

answeredmax waitWelcomeplayed onceWaitingmusic · positionAgent answersnext free agentBefore fallbackoptional messageFallbackAI, voicemail …
What a caller hears in a queue, from joining to an agent or the fallback.

Create a queue

Queues are created and changed by organization Admins. Changes apply to the next caller; nothing has to be reloaded.

  1. 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.

  2. Check the agents

    On the Agents tab, add or remove agents and set each one's priority.

  3. 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.

  4. Set the rules

    On Settings, choose the strategy, the ring time, the wrap-up time, the maximum wait and the fallback, then Save settings.

  5. 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

StrategyWho ringsGood for
Round robinAgents take turns, starting after the one who answered last.Sharing calls evenly in a contact centre (the default).
Ring allEvery free agent at once; the first to answer gets the call.Small teams where speed matters more than fairness.
Longest idleThe agent who has been free longest.Fairness by rest time.
Fewest callsThe agent who has answered the fewest calls.Fairness by number of calls.
RandomAny 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

StatusMeaningGets calls
AvailableSigned in on a phone or browser, not paused, not on a queue call.Yes
On a callTalking to a caller from this queue.After the call and the wrap-up time
PausedSigned in, but taking a break.No
OfflineNo 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).

MomentChoicesExample
1. Welcome messageNone, or a sound. Played once, before the caller starts waiting.“Welcome to card services. This call may be recorded.”
2. While waitingThe standard hold music, your own music (loops until an agent answers), or a ringing tone without music.Your bank's jingle
3. Repeating messageNone, 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 fallbackNone, 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.

FallbackQueueRing groupWhat the caller gets
Say goodbye and hang upYesYesA goodbye message, then the call ends.
Hand over to an AI agentYesYesThe default AI agent, or a particular one (80xx), which can answer questions or take a message.
Ring a groupYes–A ring group (83xx) rings.
Put in a queue–YesThe caller waits in a queue (82xx).
Leave a voicemail forYesYesThat person's voicemail greeting and a message.
Ring a personYesYesOne 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:

FigureMeaning
Waiting nowCallers in the queue at this moment, and how long the first has waited.
Agents availableAgents online, not paused and not on a call, out of all agents.
Answered todayAnswered calls as a share of callers today, with the number who hung up and the number sent to the fallback.
Average waitHow long answered callers waited today, and the longest wait.
Callers waitingEach waiting caller's number and time, in the order they will be answered. Waits over a minute are highlighted.
AgentsEach 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.
CallerCallerGroup 8301Group 8301Dr. Ayesha 1201Dr. Ayesha 1201Dr. Bilal 1202Dr. Bilal 1202calls the duty doctors1rings for 20 sfirst in the order2no answer3rings for 20 s4no answer5fallback: voicemailgreeting, then a message6
A ring group set to One after the other, 20 seconds each, with voicemail as the fallback.
  • 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

SymptomCheck
Every caller goes straight to the fallbackNo 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 rungThe agent is paused, offline, already on a call, or has a higher priority number than colleagues who are free.
Callers hear a fast busy toneThe 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 ownThe 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:

Inspect a queue on the serverShell
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"

Next steps