Add Queue Rules¶
Queue Rules adjust caller priority and agent penalty thresholds over time while a caller is waiting. Use them when you want a low-priority queue to "open up" to higher-penalty agents after callers have been waiting too long.
Before You Start¶
- A queue exists.
- You understand agent penalty: each agent has a penalty number; the queue starts only ringing agents whose penalty is at-or-below the current min/max thresholds, and rules raise those thresholds over time.
Steps¶
- Go to Group Attributes → Queue Rules.
- Click Add Queue Rule.
- Fill in:
- Rule Name — e.g.
Tier-Spillover. - For each step, add a line in this format:
N,X,YN— seconds since the caller joined.X— change tomin penalty(use+1to raise,-1to lower, or absolute number).Y— change tomax penalty.
- Example — start ringing only penalty-0 agents, then expand to penalty-1 after 60 seconds, penalty-2 after 120:
0,0,0 60,0,1 120,0,2
- Rule Name — e.g.
- Click Submit.
- Open the Queue that should use the rule and set Queue Rules to your new rule.
- Click Submit on the queue, then Apply Config.
Verify¶
Have a caller in the queue. After the configured times, additional agents (with higher penalty) should start to ring.
Common Issues¶
- No effect. The queue isn't pointed at the rule, or the queue strategy ignores penalty (e.g.
ringall). - All agents ring immediately. Your minimums/maximums are too wide from the start. Begin tighter (e.g.
0,0,0). - Field syntax error. Each step on its own line, comma-separated, no spaces.