Troubleshoot Webex Contact Center Agent Desktop

Introduction

This document describes how to troubleshoot Webex Contact Center (WxCC) related issues and how to gather relevant information that helps Technical Assistance Center (TAC) Engineer to understand and resolve the problem effectively.

Prerequisites

Requirements

Cisco recommends that you have knowledge of these topics:

• WxCC
• Contact Center and Voice Over Internet Protocol (VoIP)
• HTTP/Websocket connections

Note: This document is targeted towards customers and partners who uses Webex Contact Center

Components Used

This document is not restricted to specific software and hardware versions.

• WxCC Agent desktop application
• WxCC Portal
• WxCC Reporting Analytics

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, ensure that you understand the potential impact of any command.

Webex Contact Center Agent desktop

High Level connection image

Agent Desktop Requirements

For more information please refer: Cisco Webex Contact Center Agent Desktop User Guide

Collect Generic Information for all Webex Contact Center Issues

• Problem Description - Gather complete information about the exact issue. Include information such as how many users are affected, the exact timestamp, is it a new deployment? and so on.
• Environment - On virtual desktop? Work from home? Connected via VPN?
• Configuration Changes - Any recent changes on WxCC or network?
• Business Impact - Define the exact business impact. Associate it to a number if possible. For example, this issue impacts 20 agents, 9 out of 10 calls to the call center fails, and so on.
• Customer Org ID: - This is found on the bottom of control hub page, as shown in the image.

Customer Org ID:

Common Issues, Troubleshoot Steps and Data Collection for TAC

Type of Issue	Description	Troubleshoot Steps	Details to Analyze	Data to Collect
Agent Desktop Looses Connectivity Image 1:"Connection Failure. Trying to recover" Image 2: Network Error	Agent Applet is the web user interface (UI) for the agents to perform day-to-day operations on Voice, Email, Chat so on.. Agent desktop connection stays active based on keepAlives between Agent desktop and WxCC Every 4 seconds Agent desktop sends keepAlive to WxCC KeepAlives are sent on WebSocket connection Image 1 : Connection Failure : Agent desktop declares its a Connection failure when 3 heart-beats are missed consecutively In Technical terms for connection failure to occur the connection between Agent desktop and WxCC should be down for a total of 12secs Image 2: Network Error : If agent desktop browser session loses connectivity for more than 120 seconds, they are logged out Once you see Image 2: Network Error: the agent session is logged out on WxCC and requires agent desktop to refresh or re-log in	Image 1 : Connection Failure: If you see this intermittently and agent desktop recovers automatically and connects back then the problem could be very local Check the immediate network connection stability : Laptop/PC <> Wifi router connection You can run a continues ping to your router IP address eg: ping 192.168.1.1 -t Monitor the ping and when you see Image 1: immediately check the ping window, if you see drops then the network connection between laptop and your wifi router is not stable If there were no drops seen between Laptop/PC <> Wifi router then the problem can be on the path of router <> ISP or ISP <> WxCC To further identify and isolate the problem one can run and monitor the ping parallel to router IP and as well as any internet resource(eg: google DNS) eg: ping 4 2 2 2 -t If image 1: occurs followed by image 2: that means agent desktop encountered network disconnect for 120 secs and more	Are agents randomly logged out or unable to log in? If it happens to more then one Agent Are these failures specific to agents at a particular site? How many agents experience this issue? Are there any known network issues at the location/site? Isolate the problem if it occurs only on a particular type of browser and version? If you monitor a particular agent problem collect the ping information which proves that the immediate connection Agent Desktop <> Router & Router <> ISP(internet) stayed online during the connection failure	Exact timestamp of the issue Agent Information Screenshot of any error (ensure that all details are captured on the screen) Browser logs Download the client logs from Agent desktop application Information of ping tests performed on Agent desktop PC/Laptop AAR report of Agent for the whole day who sees this problem (to provide the exact timestamps when the connection is lost)
Agent Desktop APS(Agent Personal Statistics) not Load Data/Accurate Data Image 1: APS does not load(idbroker.webex.com refused to connect) Image 2: APS does not load "The data is unavailable or insufficient to render"	APS reports are loaded from Analyzer Agent desktop loads APS on an iframe hence the session towards analyzer is separate from agent desktop session. Image 2: APS does not load "The data is unavailable or insufficient to render" If the APS does not load data and show "The data is unavailable or insufficient to render" this is probably because User Profile with Access rights set to specific Sites or EPs or Queues and run the dashboard - there is a workaround for this problem and the next session defines the defect to track the same Cisco bug ID CSCuv02215	Image 2: APS does not load(idbroker.webex.com refused to connect) The browser must be configured to allow third-party cookies when is run in incognito mode. This has been necessitated by recent changes in Chrome (from version 83) which by default block third-party cookies in incognito mode. Intuitive privacy and security controls in Chrome Chrome security settings The Google Chrome Enterprise release notes for version 83 - Google Chrome Enterprise release notes for version 83 If the issue happens when the agent desktop is IDLE for a long time (more than 6hrs) this requires a re-log in to fix the problem	Is there an issue with agent personal statistics on the agent applet? Is the agent applet frozen? Is there any problem to update agent state changes?	Exact timestamp of the issue Agent Information Screenshot of any error (ensure that all details are captured on the screen) Browser logs Download the client logs from Agent desktop application Information of ping tests performed on Agent desktop PC/Laptop AAR report of Agent for the whole day who sees this problem (to provide the exact timestamps when the connection is lost)

Capture Browser Logs

Browser logs are a great source of information to help understand browser behavior. There are times when TAC asks you to provide browser logs to understand the communication and data exchange between the agent desktop and the server. Browser logs constitute Console logs and Network logs.

Download Error Report

The desktop application caches logs upto 1MB in browser cache automatically and it  retains the latest logs unless the browser cache is cleared.  To download the error report you can choose one of the these options.

• Load the desktop page on browser and Press Ctrl+Shift+2. Click Save File and Download a local copy.
• Load the desktop page on browser, click the user profile circle on the top right corner of the screen, click Download Error Report.

Enable Timestamps on Your Browser

Before you collect browsers logs (or console logs) from Chrome or Firefox, enable timestamps on your browser. This helps synchronize client and server timings.

Enable timestamps and preserve logs upon navigation

Chrome

Step 1. From the menu bar, choose View > Developer > Developer Tools.

Step 2. Click the Customize and control Dev Tools button (3 vertical dots).

Step 3. Click Settings.

Step 4. Under Preferences, check these check boxes:

• Log XML HTTPRequests
• Show timestamps
• Preserve log upon navigation 

Firefox

Step 1. From the menu bar, choose Tools > Web Developer > Toggle Tools .

Step 2. Click Customize Developer Tools and Get Help.

Step 3. Click Settings (the cog button).

Step 4. Check the Enable timestamps check box.

Collect Console Logs

The console gives you information about a page while that page is open. Ultimately, the messages you see in the console either come from the web developers who built the page, or the browser itself. When someone logs a message to the console, they can indicate the importance, or severity level, of the message.

Chrome or Firefox

Step 1. Open the Developer Tools (right-click anywhere on the browser and choose inspect).

Step 2. Perform the steps of the scenario to capture.

Step 3. Navigate to the Console Tab.

Step 4. Right-click and choose Save as (notepad text file).

• Right-click and choose Select All. Right-click and choose Copy.
• Paste that into a text file.

Step 5. Attach the text files to your support ticket.

Internet Explorer (IE)

Step 1. Press the F12 key to open the Developer Tools Window.

Step 2. In the Console tab, enter the AgentSDK.EnableIE11DebugLogging(true) command to enable extra logging.

Step 3. Perform the steps of the scenario to capture.

step 4. From the Console tab, right-click and choose Copy All as shown in the image.

Step 5. Enter the AgentSDK.EnableIE11DebugLogging(false) command to disable extra logging:

Collect Hyper Text Transfer Protocol Archive Format (HAR) Logs

The HTTP Archive format, or HAR, is a JSON-format archive for logging of a web browser's interaction with a site.

Chrome or Firefox

Step 1. Open Google Chrome and navigate to the page where the issue occurs.

step 2. Open the Developer Tools (right-click anywhere on the browser and choose inspect).

Step 3. Look for a round Record button () in the upper-left corner of the Network tab; red indicates record in is progress and grey indicates it is disabled.

Step 4. Check the Preserve log check box.

Step 5. Click the Clear button () to clear out any previous logs from the Network tab.

Step 6. Perform the steps of the scenario to capture.

Step 7. Right-click anywhere on the grid of network requests, choose Save as HAR with Content or Save all as HAR, and save the file to your computer.

Microsoft Edge or Microsoft Internet Explorer

Step 1. Browse to the URL where you wish to start the capture.

Step 2. Navigate to Developer Tools (use F12 as a shortcut) and click the Network tab.

Step 3. Perform the steps of the scenario to capture.

Step 4. Click Export as HAR.

Step 5. Click Save As... to save the HAR file (or Extensible Markup Language (XML) if you use an older version of Internet Explorer).