Feature coming soon: Filter the agent list by user type
Prerequisites

The following permissions: 

  • AnalyticsData Export All
  • Analytics > User Aggregate > View
  • Directory > User > View
  •  UISupervisor Agent Details > View  
  • AuthorizationRoleView (to filter agent list by Role)   
  • Groups > TeamView (to filter agent list by Work Team)
  • OAuthTokenDelete (to log an agent out of Genesys Cloud)
  • Telephony > StationDisassociate (to disassociate an agent from a station)
  • Analytics > User Detail > View (to access the Login and Logout columns)
  • Workforce Management > Real-Time Adherence > View (to access the Adherence and Adherence Duration columns)

    The Agent Status Summary view displays real-time information about agents’ statuses, including the length of time agents stay in each status. Its real-time columns always display current status data for agents, even if you use the date filter to show historical data in the other columns.

    Set a default time zone in the workspace

    You can set the default time zone in the analytics workspace before viewing any analytics view.

    To set the default time zone in the workspace, follow these steps:

    1. Click Performance > Workspace.
    2. On the left side, from the Time zone drop-down menu, select the required time zone as the default time zone for the analytics workspace.

    View the Agent Status Summary view

    1. Click Performance > Workspace > Contact Center > Agent Status
    2. Click the Statuses tab. 
    3. To see the most current data, click Refresh . This view updates automatically. Data in the columns updates when agents leave a status.
    4. To save the view with your filter and column settings, click Save .
    5. To export the data in the view, click Export .
    6. To see the agent’s Status Summary detail view, click an agent’s name.
    7. To access the other Agents Performance views, click the tabs. 
      Note: Each view has its own permissions. For permission requirements, see each view’s article.

    Customize the view

    To show only certain data, customize the Agents Status Summary view. For example, you can choose to show only certain columns or filter to show previous weeks. Your customizations remain as you navigate from view to view or leave and return to a view. To quickly switch between different data of interest in the same view, you can also save your filter and column settings as a saved view

    Filter by users to populate the summary row with aggregate data about those users.

    1. (Optional) Filter by date. The exported file uses these filters for the exported data. For more information about filtering data in a view, see the article for the view you want to export.
    2. Click Export . The Export pane opens. 
    3. Change the name of the file or keep the default file name in the File Name field. The default file name includes the date and the name of the view. If you export data from the same view multiple times in one day, then all of those files have the same default name. 
    4. To export only the columns shown in the view, select Selected Columns. The columns export in your preferred order as shown in the view.  
    5. Select one of the following options:
      • Agent Log In – Log Out Details – Exports the agent’s login and logout activity.
        Note: The export data for the agent login and logout details is limited to a maximum of one month.
      • Agent Status Timeline Details – Exports the agent’s status changes.
        Note: The export data for the agent status timeline details is limited to a maximum of one month.
      • Agent Status Duration Details – Exports the time the agent spent in each status.  
    6. You can send a CSV file or a PDF report in an email. To email the CSV file or PDF report, enter up to 10 email addresses, separated by a semicolon (;) or a comma (,). To export to email addresses, you need the Analytics > Data Export > Publish permission. 
    7. To choose how often you want an export to run, select Schedule export. Choose a Time period, and then select a Recurrence for the export to run. Next, choose the options you want for your selections, such as Minutes past the hour, Day of week, Day of month, Day of quarter, Request time, Run on days, and Run on hours
      When you select Schedule export, the Selected Columns option is automatically selected. Before clicking Schedule, verify the columns that you want to export in your preferred order as shown in the view.
    8. Click Show Advanced Options.
    9. If the view contains a duration column, time values are formatted in milliseconds. To format time values in HH:MM:SS.mmm, select the Format Durations option on the Export pane. 
    10. To convert the time values in the export file from the time zone set on your computer to a different time zone, select a time zone option in the box for your export file.
    11. You can set the locale for the data exported from a view. The locale setting displays text, and date and time formats in the selected language. Select the language in the locale box.
    12. For CSV export files, select the Comma (,) Delimiter or the Semicolon (;) Delimiter to separate values.
    13. If the view has the export option Include Summary Row, you can add a row to the top of your export that includes the sum of all the numeric columns. To add this row to the export file, select the Include Summary Row check box.
    14. If the view has the export option Exclude Empty Rows, select this check box to remove rows in the export file that do not have data. 
    15. Select CSV or PDF in the file format box.
    16. Click Export. The file appears in your inbox. 

    Notes:
    • If you have scheduled the export, the Export button changes to Schedule. If you are emailing the export, the button changes to Export & Email. If you have selected to schedule and email the export, the button changes to Schedule & Email.  
    • To view your Scheduled Exports, in the Export pane click View existing export schedules
    • You cannot edit a scheduled export. If you want to modify a schedule for an export, delete or disable the existing scheduled export and create a new one.

    To customize analytics views, use the date filter.

    To filter metrics by date or configure a custom date range, use presets. When filtering metrics for this view, select any custom date range up to 6 weeks

    To use a preset to filter metrics, complete the following steps:

    1. To display the date filter, click the date.
    2. In the Presets list, select a preset date option.

    Date presets

    Presets Description
    Current interval Shows data for the current 30-minute time period.
    Today Shows data for the time period that includes the current interval.
    Yesterday Shows data for the previous day.
    This week Shows data for a Sunday through Saturday time period.
    Last week Shows data for the previous week, Sunday through Saturday.
    Previous 7 days Shows data for the previous seven days.
    This month Shows data for the current month, with no extra days.
    This month by week Shows data for the current calendar month starting on Sunday and ending on Saturday, including extra days if the month does not start on Sunday or end on Saturday.
    Last month Shows data for the previous calendar month with no extra days.
    Previous 30 days Shows data for the previous 30 days.
    Previous 3 months Shows data for the previous 3 months. For example, Nov 1, 2022 – Jan 31, 2023.
    Interval Shows data for a 30-minute time period.
    Day Shows data for a single 24-hour day.
    Week Shows data for a Sunday through Saturday time period.
    Month Shows data for the exact month with no extra days. If the current month is selected, you can see the data up to the current date.
    Month by Week Shows data for a calendar month starting on Sunday and ending on Saturday, including extra days if the month does not start on Sunday or end on Saturday.

    To use a custom date range to filter metrics, complete the following steps:

    1. Click the date to display the date filter.
    2. Select a start date and an end date on the calendar, and click the filter arrow .

    To view data for a different time period using the same date presets, click the arrows on either side of the date display.

    For example, to view data for the previous day, click the Day preset, and then click the arrow on the left side of the date.

    To view data for a different time zone using the same date presets, from the Time zone drop-down menu, select the required time zone. You can create and save reports with the same selected time zone.

    Data in the view can be displayed in a chart. To view the chart, click the Show/Hide chart icon .

    To show or hide topic columns, click the Pick columns icon on the right side and then search or scroll to select the columns you want to view. 

    To rearrange topic columns, click a column header and drag it.

    To reset a view to default column settings, click Reset view to defaults .

    You can select up to 20 topic columns.

    For more information about the metrics shown in the columns, see the Available Columns section in this article.

    The Agents Status Summary view displays certain columns together as groups if the table columns are sorted as default. To rearrange column groups, click a column group header and drag it.

    To reorder columns within the column groups:

    1. Click the Pick columns icon
    2. In the Table Columns pane, hover over the table column header name you want to move.
    3. Click the up or down arrowsReorder columns

    To enter names of users you want to view, click the Filter user(s) search icon . Genesys Cloud populates the summary row with aggregate data about those users. You can filter by a User name, Division name, Group name, Work Team name, Role, or a Location. As you enter a name, the suggested names are displayed in the search results with the filtering type on the right. When entering a user name, you can also select the Reports to filtering type, to display the user's direct reports. You can continue to enter and select additional users to add to the view. 

    Filter by selecting multiple users

    You can select multiple users to filter by. 

    1. In the user's row, select the check box.
    2. Continue selecting user check boxes to add to filters. 
    3. Click Add to filters.

    To use the summary row to see aggregate metrics for multiple users, search for and select multiple users. The summary row then shows aggregate metrics for the selected users. 

    Note: The summary row can populate aggregate data for up to 50 agents at once.

    View aggregate data

    To view aggregate data for several users, filter for multiple users and click View as group. Genesys Cloud displays the Agents Performance Detail view with aggregate data for the users you selected. Use the Back arrow icon to return to the Agents Performance Summary view.

    To filter the agent list by user type, in the top left-hand corner, choose any one of the required user types from the Active Users filter:

    • Active Users (Default) – To filter only the active agents in the organization from the agent list.
    • Inactive Users – To filter only the inactive agents in the organization from the agent list.
    • Active and Inactive Users – To filter both the active and inactive agents in the organization from the agent list.
    • Deleted Users – To filter only the deleted agents in the organization from the agent list.

    Note: You can filter the deleted users only by using the user name and cannot filter by using other user filters such as division, group, location, reports to, role, or work team. 

    From the Agents Status Summary view, hover over the presence dot beside an agent’s name.

    To set the agent's status to Off Queue or On Queue, select On Queue or Off Queue. If you change the status from On Queue to Off Queue, then the agent's status automatically also changes to Available.   

    To set the agent's user status, select a status from the status drop-down. If the agent's status is On Queue, selecting a user status also sets them to Off Queue.

    Note: You cannot select Out of Office as a status.

    If the status you select has secondary statuses, select a secondary status in the drop-down below the primary status. 

    From the Agents Status Summary view, hover over the presence dot beside an agent’s name.

    To log out an agent, click Log off. If the agent is On Queue, set the agent's status to Off Queue, and then click Log off.

    Important: When you log out an agent, all active connections will be ended.

    From the Agents Status Summary view, hover over the presence dot beside an agent’s name.

    To disassociate an agent from the station, click Disassociate Station.

    Note: Users with Telephony > Station > Disassociate and Directory > User > View are able to disassociate agents from stations even if those agents are not within their divisions.

    Available columns

    Your customizations determine which metric columns that the view shows.

    Real-time columns

    Note: The real-time status columns do not export since they are a point-in-time snapshot, while the export is an asynchronous operation. The following real-time columns are not available in the export:
    • Time in Status
    • Status
    • Secondary Status
    • Routing Status
    • Time in Routing Status
    • Station
    • Media Types
    • Interactions
    • Duration / Duration 2 / Duration 3
    • Adherence
    • Adherence Duration
    • Scheduled Activity

    These columns always show current, real-time data, even if you use the date filter to show historical data. 

    Column  Description
    Column Description
    Time in Status

    The amount of time agents have been in their current primary status.

    Status

    The current primary status of an agent, such as Available, Away, or Busy.

    Secondary Status

    The current secondary status of an agent. If there is no secondary status, then this column displays the agent's primary status. 

    Time in Routing Status

    The amount of time agents have been in their current routing status.

    Routing Status

    The current routing status of an agent.

    Skills

    The routing skills and languages assigned to an agent. 

    Station Icon that shows if an agent is associated with a station. Hover over the icon to display the Station Name.
    Division

    Displays the name of a division that an agent or queue belongs to. For more information, see About access control

    Agent

    The full name for the user.

    ID

    Unique system ID for the user.

    Email

    Email address configured for the user.

    Group

    Official Genesys Cloud groups that the user is part of.

    Reports To

    The manager as defined for the user within Genesys Cloud.

    Location

    Location for the user as defined in Genesys Cloud.

    Media Types

    The media types an agent is permitted to handle, such as voice, callback, chat, email, and message.

    Title

    Title of the user as defined within Genesys Cloud.

    Department

    Department of the user as defined within Genesys Cloud.

    Primary Phone

    Phone number for the user as defined in Genesys Cloud.

    Adherence Status

    The current adherence status of the user, including In Adherence, Out of Adherence, Unscheduled, Ignored, or Unknown.

    Scheduled Activity

    The activity for which the user is currently scheduled, including On Queue Work, Break, Meal, Meeting, Off Queue Work, Time Off, Training, Unavailable, or Unscheduled.

    Adherence Duration

    The amount of time represented in days, hours, minutes, and seconds, of the adherence exception.

    Interactions

    The number of interactions assigned to the queue that agents are currently interacting with.

    Duration

    Duration 2

    Duration 3

    The amount of time an agent has been working on an interaction. If an agent is working multiple interactions, then Genesys Cloud displays each interaction's duration in a separate column labeled Duration 2 or Duration 3. 

    Historical data columns

    These columns show current data if you use the date filter to show the current date. If you use the date filter to show a past date, then these columns display historical data. 

    Column Description
    Column Description
    Logged in

    The total amount of time a user is logged in for the specified period.

    On Queue The time spent in the On Queue status for the specified period.
    Idle

    The amount of time an agent spends in the Idle routing status. This routing status represents agents who are On Queue and able to take interactions but are not currently working with interactions.

    Not Responding

    The amount of time an agent spends in the Not Responding routing status after not accepting an interaction. The Not Responding routing status is when an agent was On Queue or Interacting and did not answer an offered interaction. The agent could still be handling and completing other previous interactions. While Not Responding, the agent does not receive new interactions.

    Off Queue The time spent in any status other than Offline and On Queue for the specified period.
    Available

    The time spent in the Available status for the specified period.

    Busy

    The time spent in the Busy status for the specified period.

    Away

    The time spent during the specified period in the Away status when the user sets their status to Away.

    Note: If Genesys Cloud automatically sets the user’s status to Away due to inactivity, then this view displays that time in the System Away column. 

    Meeting

    The time spent in the Meeting status for the specified period.

    Break

    The time spent in the Break status for the specified period.

    Meal

    The time spent in the Meal status for the specified period.

    Training

    The time spent in the Training status for the specified period.

    Communicating

    The agent is on a non-ACD call, and, in relation to agent utilization and call routing, Genesys Cloud treats the non-ACD call like an ACD call. For example, administrators could configure agent utilization so Genesys Cloud does not route new interactions to agents while they are on an ACD or non-ACD call. This status only appears if administrators have selected “Block calls when on a non-ACD call (excludes transfers)” within the agent utilization configuration.

    Interacting

    The time that the agent was handling interactions.

    Division

    Displays the name of a division that an agent or queue belongs to. For more information, see About access control

    System Away

    The time spent during the specified period in the Away status when Genesys Cloud automatically sets the user's status to Away due to inactivity.

    Note: If users manually set their status to Away, then this view displays that time in the Away column. 

    Agent

    The full name for the user.

    Email

    Email address configured for the user.

    Log in

    The time the user first logged in within the supplied interval.

    Data for this column is limited to a one-month time range for data that is up to 558 days old.  If the column is blank, a log in event did not occur within the view’s requested interval.

    Log out

    The last time the user logged out within the supplied interval. 

    Data for this column is limited to a one-month time range for data that is up to 558 days old.  If the column is blank, a log out event did not occur within the view’s requested interval.

    Total ACD

    The amount of time that an agent spent in the Interacting, Idle, and Not Responding statuses. For example, an agent spent 5:01:00 interacting, 1:47:30 idle, and 0:21:30 not responding. The total ACD time is 7:10:00.

    Primary Status Off Queue %

    The percentage of time that an agent spent off queue. For example, in the Available, Away, and Busy statuses.

    Primary Status On Queue %

    The percentage of time that an agent spent on queue. For example, in the Interacting, Idle, and Not Responding statuses.

    ACD Status Interacting %

    The percentage of on-queue time that an agent spent in the Interacting status, calculated by:

    Interacting / (INTERACTING + IDLE + NOT RESPONDING) * 100

    ACD Status Idle %

    The percentage that an agent spent in the idle status, calculated by:

    Idle / (INTERACTING + IDLE + NOT RESPONDING) * 100

    This routing status represents agents who are On Queue and able to take interactions but are not working with interactions.

    ACD Status Not Responding %

    The percentage of time that an agent spent in the Not Responding status, calculated by:

    Not Responding  / (INTERACTING + IDLE + NOT RESPONDING) * 100

    Occupancy

    The percentage of time that an agent spent handling ACD conversations against the total time on queue calculated by: (total time in "Interacting" routing status / (total time in “idle”, “interacting”, and “communicating” routing statuses in interval)) * 100; range: 0-100%