Workforce Troubleshooting
Workforce Management
Common situations met while managing agents, shifts and statuses, with the likely cause and the recommended resolution. Rows follow the order of the Workforce guides, and the related guide is named on the left.
Five Checks to Make First
- Is the agent on shift? Calls, call icons and many actions depend on an active shift. The Shift column of the Workforce Monitor shows it.
- What is the agent's current status? Each status has its own Call Handling settings, so the status decides whether queue calls and external calls reach the agent.
- Is a filter still active? A forgotten quick filter or drop down filter is the most common reason for a table that looks empty.
- Does the role have the Workforce Management permissions? They are in the Workforce Management group of the role, each with a scope of Own, Group or All.
- Does the agent belong to the right group? Group filters, Group scope and group based reports all depend on group membership.
Symptoms, Causes and Resolutions
| Topic | Symptom | Likely Cause | Resolution |
|---|---|---|---|
| Starting a Shift | An agent is signed in but calls do not ring. | The agent has not started a shift, or the current status has Queue Login switched off. | Check the Shift column on the Workforce Monitor. Start the shift, or change to a status such as Available. |
| Starting a Shift | The agent cannot end the shift. | The current status does not have Can be End the Shift Status switched on. | Move to a status that allows it, or switch the setting on for that status. |
| Starting a Shift | A shift runs for many hours after work has finished. | The agent did not end the shift. | End the shift from the page header, or ask the agent. The Activity Summary Report shows unusually long shifts. |
| Custom Statuses | A new status is missing from the agent's list. | The status is inactive, or the page has not been refreshed. | Set Status to active in Status Management and refresh the page. |
| Custom Statuses | An agent selects a status without asking. | Request Approval is switched off for that status. | Switch Request Approval on in Status Management. |
| Custom Statuses | An agent never appears under Breeches. | The status has no Allowed Time, so no limit applies. | Enter an Allowed Time in minutes for the status. |
| Call Handling | Calls reach an agent who is on a break. | Queue Login is on, or N/A, for the break status. | Set Queue Login to OFF on the Call Handling tab of the status. |
| Call Handling | The status changes without the agent acting. | A system workflow follows calls and the telephone system, or a supervisor forced the change. | Open the agent's Activity Logs to see when it changed, and read System Workflows, Workforce. |
| Monitoring Agents | The Make Call button is greyed out. | The supervisor is not on shift in a status that allows external calls, or has no registered phone. | Start a shift in Available and check the Enable External Calls setting of the status. |
| Workforce Filters | The table is empty or shows No data. | A quick filter or a drop down filter is still active. | Click the active quick filter again and clear the Group/Queue and Status filters. |
| Group Management | An agent does not appear under their group. | The agent is not a member of the group or queue. | Use Manage User Groups on the agent's row, add the group and click Save. |
| Break Requests | A supervisor does not see an agent's request. | The agent is outside the supervisor's Group scope, or the Requests filter is not on. | Click Requests and check the scope of Approve Break Requests on the supervisor's role. |
| Raise Hand | A raised hand stays on the list. | It has not been dismissed, or the role has no Dismiss Raise Hand permission for that agent. | Dismiss it after helping the agent, and check the scope of Dismiss Raise Hand. |
| Force Shift Start | The Start Shift button is missing for another agent. | The role has no Force Shift Start permission, or its scope excludes the agent. | Open the role and set Force Shift Start to Group or All. |
| Force Status Change | The status list does not open from an agent's Presence column. | The agent is not on shift, or the role has no Force Status Changed permission for that agent. | Check the Shift column, then the scope of Force Status Changed on the role. |
| Active Sessions | An agent is missing from Active Sessions. | The agent has no open connection, so no session exists. | Ask the agent to sign in again, then refresh the page. |
| Activity Logs | No shifts are listed for an agent. | The Start date and End date fields exclude the shifts, or the agent has not worked. | Clear or widen the date range. |
| Reports | A report shows nothing. | The date range is too narrow, or the group has no activity in it. | Widen the range and click Generate Report. |
| Reports | A user is missing from Login History. | The user did not log in within the Last Login at range. | Widen the Last Login at range and generate the report again. |
| Permissions | An administrator cannot create or edit statuses. | The Manage Status permission is switched off on the role. | Switch Manage Status on in the Workforce Management group of the role. |