Docs
Ctrl K
TelephonyVINSI VOICEVINSI INSIGHTSCall Queues

Call Queues

Hold callers in line with music and announcements until the right agent is free — with agent status, wrap-up, callbacks, supervisor tools, and reporting.

Created: September 16, 2026

Updated: October 29, 2026

Overview

When someone calls a number attached to a queue, they hear an optional greeting and then hold music. The queue offers the call to available agents using the strategy you choose. If nobody answers within the maximum wait, the caller overflows to voicemail, an AI phone agent, another queue, or is disconnected.

Queues are set up in CRM → Admin → Phone Settings → Queues. Day-to-day monitoring and reporting live on the Call Center page in the CRM menu. Not sure whether you need a queue or a hunt group? See the comparison on the Hunt Groups page.

RoleWhat they can do
AgentAnyone added to a queue. Sets their own status, picks dispositions, sees their own stats.
SupervisorLive wallboard and reports for their queues, change agents' status/queues/skills, alerts, listen/whisper/barge.
AdministratorOrganization admins: everything above for every queue, plus queue setup, codes, supervisors, and retention.

Before You Start

  • Every agent needs a phone — a softphone or desk phone in Phone Settings → Member Phones. Agents without one show a no phone tag in the queue's agent list, because the queue can't ring them.
  • A phone number that isn't assigned to a member, desk phone, fax line, or AI phone agent.
  • Optional: skills (Phone Settings → Skills) for skills routing, and reason/disposition codes (see Codes & Supervisors) — sensible defaults are created automatically.

Create a Queue

  1. Go to CRM → Admin → Phone Settings and open the Queues tab.
  2. Click + New Queue at the bottom of the panel. The queue editor opens.
  3. Enter a Queue Name (for example Support) and work through the sections below.
  4. Click Create queue. To change it later, click the queue's card and use Save changes.

The editor is one long page with a list of its sections down the left: Basic information, Routing, Agents, After each call, While callers wait, Limits & overflow, Business hours and Service level & alerts. Click one to jump to it; the list also highlights whichever section you have scrolled to.

Two entries in that list show what the queue holds rather than what the section is for, and turn amber when empty: Basic information counts the phone numbers, and Agents counts the primary and backup agents. A queue with no number never rings, and a queue with no primary agent sends every caller to overflow — the list is where you see either of those from any section.

Routing

StrategyWho gets the call
Longest idleThe available agent who has gone longest without a call from this queue (recommended default).
Fewest callsThe agent who has taken the fewest calls. Prefer this to Longest idle when call lengths vary a lot — Longest idle keeps feeding whoever just finished something short.
Ring allEvery available agent rings at once.
LinearOne agent at a time, starting from 1 in your ring order.
Round robinRotates, resuming after whoever rang last.
Round robin (in order)Rotates through the agents in your ring order instead of resuming where it left off.
RandomPicks a free agent at random.
Weighted randomRandom, favouring higher-priority agents.
SkillsBest proficiency first for the required skills, then longest idle within that level.

Choose Linear or Round robin (in order) and a small number box appears on each primary agent's card. 1 rings first. New agents take the next free number as you add them, so the order reads 1, 2, 3 without you typing anything.

  • Two agents on the same number is allowed; between them the order falls back to name, so it stays predictable but is not something you chose.
  • An agent left blank rings after every numbered agent.
  • The box is hidden for every other strategy, because those do not walk the list in order — a number there would imply an ordering the system ignores.

“Idle” and “fewest calls” count only what this queue handed out. Time an agent spends on a direct or outbound call does not make them look busier to these strategies — though they still will not be rung while actually on a call. The counts also reset whenever the phone system reloads, after which every agent looks equally idle for a while.

  • Required skills (Skills strategy) — agents must be rated for all of them; their weakest rating decides their tier. Primary agents are offered calls first, then Secondary, then Training. The next tier opens after each ring timeout. Rate agents in Member Phones → Skills.
  • Ring each attempt — how long an agent rings before the queue tries again or opens the next tier.
  • Queue priority for shared agents — when an agent is in several queues, the queue with the higher number is served first.

Agents

There are two boxes: Add a primary agent… and Add a backup agent…. Start typing a name or email and pick from the list that drops down; the person is added to that tier straight away. Backup agents are only offered calls after the primary agents.

The cards below each box are the queue — only agents actually on it are listed, in the order calls are offered to them. Every card shows the agent's photo, their name, and their phone number and extension underneath, so two people with the same display name are still told apart. Click the × on a card to take that agent off the queue.

An agent holds one tier at a time, so neither box offers someone who is already on the queue. To move a person from primary to backup, remove them and add them again on the other side.

A card tinted pink and tagged “no phone” means the member has no softphone or desk phone in this organization, so the queue cannot ring them. They will appear “Available” on the wallboard and never ring — the most common reason a queue sends every caller to voicemail. Adding them changes nothing until you give them a phone in Member Phones. The same tag appears in the dropdown, so you can see it before you add them.

Saving a queue replaces its entire agent list with the cards shown, so check them before you save.

Agents on any call — a queue call, a direct call, or an outbound call, on their softphone or desk phone — are not offered another queue call. A softphone open in more than one browser tab rings in all of them.

Which Phones Ring

This queue rings controls which of an agent's devices this queue offers calls to:

  • Softphone and desk phone — the default.
  • Softphone only — useful for remote agents, or when desk phones are shared.
  • Desk phone only.

This applies to this queue only. Direct calls to the agent's own number still ring everything they own — unlike the per-member Rings setting in Member Phones, which silences a device everywhere.

Choosing Softphone only means an agent whose softphone is closed has nothing for the queue to ring. A browser softphone is only registered while its tab is open, so if every agent closes theirs, callers hit the empty-queue behavior below.

Phone Numbers

Phone Numbers that use this queue sits directly under the queue name, because which numbers ring the queue is usually the first thing you set and the first thing you check when you come back to it.

The numbers already on the queue appear as tags in the box. Click in it and start typing to add another — search matches the digits, so typing 8607194281 finds +1 860-719-4281, and it also matches the name or location. Click the × on a tag to take a number off, or the ⊗ at the right of the box to clear them all.

Each number in the dropdown shows where it is and where it is now:

  • Its state and city on the right — “Minnesota, Bemidji” — which is how you tell apart a dozen numbers in one area code. A number shows its state alone until an administrator has run the location backfill, and toll-free numbers show neither, having no city.
  • An amber note if it is already in another queue or on a hunt group. Adding it here moves it when you save; a number serves one or the other, never both.

Only numbers that route through the VINSI phone system can feed a queue, so Twilio numbers are not listed. A Twilio number attached to a queue before this restriction still appears, marked in red as Twilio — can't reach the queue, so you can remove it; calls to it never arrive at the queue and leave no trace in the call logs.

The per-number High / Standard / Low caller priority was removed. It only ever mattered when one queue served several numbers and callers on one of them were meant to jump the hold queue, which is not how these queues are used, and it was a control on every row that nobody could explain. Numbers set to High or Low before it was removed keep behaving that way and show a small badge on their tag; click the badge to put them back to standard.

After Each Call

  • After-call work (seconds) — time an agent gets to wrap up before the next queue call. 0 turns it off.
  • Agents must pick a disposition — requires an outcome (Resolved, Escalated, …) for each call. Wrap-up lasts at least 60 seconds when this is on.

While Callers Wait

  • Announce their place in line and Announce estimated wait, repeated every N seconds (30–45 is typical).
  • Hold music — upload a WAV or MP3 (up to 20 MB). With nothing uploaded, callers hear the standard VINSI hold music.
  • Play ringing while an agent's phone rings — callers hear a ringing tone while a phone is actually ringing, and hold music the rest of the time. Off by default, which means hold music throughout.
  • Greeting — plays once when the caller joins.
  • Repeating announcement — plays at the announcement interval (e.g. opening hours or your website).

For the greeting and announcement you can upload a file, or type the text, choose a voice, click Preview to hear it, then Use this text. Every saved audio item has a player so you can listen to exactly what callers hear. Audio chosen while creating a new queue is uploaded as soon as you click Create queue.

The voice list shows the voice the current recording was made with. To change it, pick another voice and click Use this text again — the wording does not have to change.

Callback

Turn on Offer a callback to let callers press 1 to hang up without losing their place in line. VINSI holds their spot; when an agent answers it, the agent's phone rings first and then VINSI calls the customer back from the queue's number. You can customize the offer text (it plays about every 45 seconds) and listen to it once saved.

Callers with a blocked or hidden number are told a callback isn't possible and stay on hold. Callback requests and their outcomes appear on the Call Center wallboard.

Limits & Overflow

SettingMeaning
Max wait (seconds)Longest a caller holds before overflowing.
Max callers in line0 = unlimited. Extra callers overflow immediately.
Overflow toVoicemail, an AI phone agent (it needs a phone number), another queue, or hang up.
Priority of callers overflowing into this queueHigh (ahead of callers already waiting), Standard, or Low.
Voicemail notification emailWhere queue voicemails are emailed. Empty = the number's owner.
Hold callers when no agent is availableCallers wait on hold until somebody becomes available, instead of overflowing straight away. Off by default.

By default, callers overflow immediately when no agent is logged in and reachable — they never hear hold music, and the Call Center shows “a caller found no agent available and went to voicemail”.

Turn on Hold callers when no agent is available to make them wait on hold instead. This is usually what people expect, but it changes what Max wait means: it becomes the only limit on how long someone holds for nobody. A queue left at the default 900 seconds will hold a caller for fifteen minutes with no agent logged in — lower it to 2–3 minutes when you enable this.

Business Hours

Choose 24/7, Organization business hours, or Custom hours (start, end, and days in your organization's time zone). Outside hours, callers skip the queue and go to the After hours destination.

Service Level & Alerts

  • Answer within (seconds) and Service level target (%) — e.g. 80% of callers answered within 30 seconds.
  • Alert when a caller waits N seconds, or when this many are waiting (0 = off).
  • Alert when a caller overflows.
  • Also email alerts to — extra addresses, separated by commas. The queue's supervisors always get alerts.

Overflow alerts are batched. Each overflowing caller still appears separately on the wallboard, but the emails are grouped into one message per queue every 10 minutes listing each caller and the time — so a queue with nobody logged in sends one email, not one per call. The first overflow still emails within about 15 seconds; the batching only suppresses the flood after it.

Supervisors are also alerted when the last hour falls below the service-level target, or an agent stays on a break past its limit.

Agent Status

StatusReceives queue calls?
AvailableYes
On a callNo (automatic)
Wrapping upNo — after-call work, ends on its own or when the agent clicks Done
Unavailable · reasonNo — Break, Lunch, Meeting, …
Logged outNo

Every status change is timestamped and used for time-in-status, occupancy, and adherence reporting.

Softphone

Members of at least one queue see a status bar under the softphone header (open the softphone; it isn't shown while minimized). Use the dropdown to switch between Available, Unavailable (pick a reason), and Logged out. The bar also shows how long you've been in the current status, how many callers are waiting, and a My stats link.

Desk Phone Codes

DialAction
*45Log in / log out of all your queues
*46Unavailable (first reason code) / back to Available
*47Done with wrap-up — back to Available

A short spoken confirmation plays after each code. The codes also work from the softphone keypad.

Wrap-up & Dispositions

After a queue call, the softphone shows the call's queue and caller with an outcome dropdown and an optional note. Click Save & ready to record it and become available again. Desk phone users can finish wrap-up with *47.

Codes & Supervisors

Administrators manage these in Phone Settings → Queues → Codes & supervisors (or Call Center → Settings):

  • Reason codes — why an agent is Unavailable, each with an optional maximum in minutes. Supervisors are alerted when an agent goes over. Turn codes off instead of deleting them so history keeps its labels.
  • Disposition codes — the call outcomes agents choose during wrap-up.
  • Supervisors — click Add supervisor, pick a member, and check the queues they supervise.
  • History retention — how many days of queue history to keep (default 90).

Call Center Page

Open it from CRM → Admin → Phone → Call Center (agents can use My stats in the softphone). Supervisors and administrators see Live and Reports; administrators also see Settings. Agents see My stats.

Live Wallboard

  • Queue tiles — callers waiting, longest wait, agents free and on calls, today's answered/abandoned and service level (green on target, red below).
  • Alerts — acknowledge each alert once handled.
  • Agents — status and time in status (red when a break runs over). Change an agent's status, log them in or out, or use Queues & skills to change their queues (Primary/Backup) and skill levels.
  • Callback requests — status of each callback; mark failed ones as called or dismiss them.

Listen, Whisper & Barge

For an agent on a call, click Listen, Whisper, or Barge. Your own softphone (or desk phone) rings — answer it to join. Keep your softphone open first.

ModeWho hears youKeypad while connected
ListenNobody4
WhisperOnly the agent5
BargeAgent and caller6

Each use is recorded in the change history.

Reports

Pick a date range (Today, 7, 30, 90 days, or custom), optionally a queue, then:

  • Queue performance — offered, answered, abandoned and abandon rate, overflow, callbacks, average speed of answer, handle time, service level, dispositions.
  • Agent performance — calls handled, handle and talk time, time in each status and reason, occupancy, adherence, dispositions.
  • Skill coverage — eligible agents per queue by proficiency vs. calls offered.
  • Change history (administrators) — who changed queues, skills, codes, supervisors, and monitoring.

Click Export CSV to download the current report.

Adherence uses each agent's Work Schedule (Tickets → Admin → Work Schedules). Agents without a schedule show No schedule.

Troubleshooting

ProblemWhat to check
I don't see the status bar in my softphoneYou must be in a queue as your own account (hover names in the agent list to confirm the email), and the softphone must not be minimized.
Agent shows no phoneAdd a softphone or desk phone for them in Member Phones.
Callers overflow immediatelyNo agent is Available with a connected phone, the queue is full, or it's outside business hours.
An agent keeps getting skippedThey're Unavailable, wrapping up, already on a call, or (Skills) not rated for every required skill.
"Use this text" shows an errorThe message names the voice provider that failed — try another voice or contact support.
Listen/Whisper/Barge says none of your phones are onlineOpen your softphone (or pick up your desk phone) and try again.