HID Device Diagnostic

What a user needs to run through to collect signals from HID headsets to determine success or generate a proper ticket to get that device added to the verified list.

Feature Toggle by Support

Xima support will need to enable the WEBRTC_HEADSET_CALL_CONTROL feature toggle. Request this in a ticket if you do not see the settings referenced in the article below.


The diagnostic tool is designed to test the signals the HID device send through the browser during a variety of actions. The goal is to capture a proper answer/hangup command but also to ensure any other actions (mute, volume up, etc) do not accidentally disconnect the call.

Have the agent who has the device connected to the PC via usb take the following steps:


  1. Have the agent first log into their CCAC
  2. Add the following slug to the CCAC URL: /headset-diagnostics
    Example https://TENANT NAME. xima.cloud/ccagent/en/headset-diagnostics
  3. The agent may remain in DND during this test
  4. The agent will see the diagnostic tool. They should select "Connect my headset"
  5. Select the HID device from the list presented in the browser pop-up
    1. If the device is not listed in the browser-pop, Xima cannot use it and the diagnostic cannot continue. The site's IT team will need to determine why the agent's browser does not recognize the device
  6. Select "Use" next to the now listed device to move on
  7. Answer the 2 questions about the connection method and use of the product client software.
  8. Select "Start the test"

    Review and follow each documented step closely

    If you make a mistake, you may select "Start Over" at any time.

  9. The expected steps:
    Step #TaskPurpose
    1Do nothing. Wait for the tool to advance to step 2 automaticallyThis step is listening for any constant signals that are coming from the device even if you are not doing anything. Such passive "noise" could result in auto-answers and disconnects if present and not accounted for.
    2Press the button on your headset that is intended to answer the callWe need the signal sent for the answer button.
    3Press the answer button again as we simulate a call. NOTE: you may not hear the call but click answer anywaysWe need the signal sent for the answer button when a (fake) call is being offered
    4Stand the microphone arm straight up, and keep it there until we ask you to move it back.Some devices send a signal when the mic arm is in the full upright position. This is a common method for muting. Xima needs to know what signal it sends and ensure it doesn't get used as an answer/disconnect command.
    5Lower the mic arm back downSimilar to #4, we need to make sure any "unmute" signals do not trigger an answer or disconnect action..
    6Press the mute button (if present). This would be a button and not the action of moving the mic arm. Capturing the signal for a mute action so we can ensure it does not trigger an answer or disconnect action..
    7Press the mute button (if present) to unmute.Capturing the signal for an unmute action so we can ensure it does not trigger an answer or disconnect action..
    8Press the volume up buttonCapturing the signal so we ensure it does not trigger an answer or disconnect action.
    9Press the volume down buttonCapturing the signal so we ensure it does not trigger an answer or disconnect action.
    10Press the hangup button (usually the same as the answer button) to end the simulated callWe need the signal sent for the disconnect action.
    11 Stand the microphone arm straight up, and keep it there.This has a dual purpose as it's detecting any signal for when the mic arm is lifted when not on a call AND prepares the agent for the next step.
    12While the mic arm remains in the upright position, press the answer buttonSometimes the signal that comes through when the button is pressed when the mic arm is up differs from when the arm is down
    13Lower the arm back down and press the button one more timeSometimes the signal that comes through when the arm has been lowered and the button is pressed differs.
  10. Once you've reached the end, you will need to "Download result file" . This file will need to be shared with Xima support for engineering review. NOTE: If you question your actions and selections during any of the steps, it is better to start over then to submit a log and explain any testing concerns.
  11. If all applicable actions registered a recognizable/usable signal, the turn around time for adding the device to the verified list and a hotfix build may take 2-4 weeks once presented to development.