What the Un-handled Emails count tells you

On a VICIdial email account you will see a field called Un-handled Emails with a number next to it. It is not a setting you change. It is a live readout: the current count of emails sitting in the outside mailbox that are still waiting to be handled. It tells you, at a glance, whether messages are being pulled in and worked or piling up untouched.

On a healthy account this number stays low and moves. Mail arrives, the account checks the mailbox on its schedule, pulls the new messages in, and they get routed to an Agent. The count rises a little between checks and drops back down after each check. If it sits high and keeps climbing, something in that chain is stuck.

It helps to remember what the count is actually measuring. It is the backlog in the outside mailbox, not anything inside VICIdial. A message counts as un-handled from the moment it lands in that inbox until the account successfully pulls it in. So the number reflects the gap between mail arriving at your provider and VICIdial collecting it. A small steady gap is normal, because the account only checks on a schedule rather than the instant each email arrives. A wide and growing gap means collection has fallen behind, or stopped.

Reading the number

A climbing count usually points at one of a few things:

• The account is not connecting. Wrong server, login, or password means nothing gets pulled in, so the mailbox fills.
• Mail is coming in faster than your agents can clear it. The pull is working, but the queue outpaces the team.
• No agents are staffing the group, so emails arrive but no one is logged in to take them.
• The provider locked the account from too-frequent login attempts, so the check is failing silently.

How a message leaves the count

flowchart TD
  A["Email lands in outside mailbox"] --> B["Counts toward Un-handled"]
  B --> C["Account checks mailbox on schedule"]
  C --> D{"Pull succeeds"}
  D -->|no| E["Stays in mailbox, count climbs"]
  D -->|yes| F["Pulled into VICIdial"]
  F --> G["Routed to an agent"]
  G --> H["Agent works it and dispositions"]
  H --> I["No longer un-handled"]

So the count drops as messages are pulled in and worked. A steady-low number means the whole path is flowing. A stuck-high number is your cue to walk that path backward: is the account connecting, is the group staffed, are agents clearing the queue, has the provider locked you out?

Used this way, the field is a free monitoring tool. You do not need a separate dashboard to know whether inbound email is alive; the count on the account answers it. Pair it with a glance at who is logged into the group, and you can tell a connection problem from a staffing problem in seconds. When a message does get worked, it leaves a Disposition on its Lead just like a call, so the rest of your reporting stays consistent.

If the count is stuck because mail is not arriving at all, work through the email frequency check rate first, since too-frequent checks can get an account locked. For how the whole inbound email path fits together, see the inbound email and chat guide. Keeping the count low is mostly about staffing the group with enough Agent coverage. If you would rather not babysit mailbox health yourself, our managed VICIdial plans keep the plumbing watched for you.