voximplant KitDocs
  1. Getting started
  2. Troubleshooting
  3. Guide for collecting data to troubleshoot the softphone desktop app
Rate this page:

Guide for collecting data to troubleshoot the softphone desktop app

The desktop softphone is an application you install on your PC (Windows, Mac, Linux) to make and receive calls from anywhere on your desktop using Voximplant Kit telephony.

If you encounter an issue with the desktop softphone, its logs can help support specialists quickly identify and resolve the problem.

In this article, you will find a step-by-step guide on how to collect logs and other information about the softphone for bug analysis and troubleshooting.

Contents

Copy URL

Developer tools setup

Copy URL

Softphone logs record all user actions in chronological order. Log entries will help support staff understand the root cause of an issue more quickly and find workarounds and possible fixes.

Before downloading debug logs you need to set up developer tools.

Note

The developer tools are configured once beforehand. No re-configuration is required.

  1. Expand the tray menu and right-click the softphone icon.
  2. Click Show app with the Shift key pressed.
Show app

The developer tools window opens.

Dev tools
  1. Go to the Console tab.
Console
  1. Click the console settings icon.
Console settings
  1. Select the Preserve log checkbox.
Preserve log

Collecting logs

Copy URL
Important

Collect logs immediately after detecting a bug so that the bug events are not replaced with new log entries. We recommend that you collect logs in the first minutes after a bug occurrs.

  1. On the Console tab, right-click any log and select Save as… to download it.
Saving log
  1. Save the log file to your PC for future investigation.
Saving log

Recording bug meta information

Copy URL
  1. Record your softphone version or make a screenshot of the tray menu.
Softphone version
  1. Note the time the bug occurred and the user's timezone.
  2. Indicate whether any tabs of the Voximplant Kit web app or other softphones were open at the time the bug occurred, where the user was logged in.
  3. Specify the user's operating system version (Windows 7/8/10/11 or MacOS and version).
  4. If the bug is reproducible and visible, take a screenshot or screen recording.

Submitting data to support

Copy URL

After collecting the required data, submit it to support specialists for analysis and bug fix.

  • Log file

  • Bug details (including bug occurrence time)

  • Softphone and operating system versions

  • Whether the user was simultaneously logged into the Voximplant Kit web app or softphones

  • Screenshots and recordings (if any)

Troubleshooting update installation errors

Copy URL

If you encounter an error while installing updates for the softphone on Windows OS, you need to delete the folder with the old version of the application and install the updated app.

  1. Open File Explorer.
  2. Select View > Options > Change folder and search options.
  3. On the View tab, under Advanced settings, select Show hidden files, folders, and drives.
  4. Click OK.
  5. In the tray menu, right-click the softphone icon and select Log out.
  6. Delete the folder at: C:\Users\\AppData\Local\Programs\kit-softphone-electron.
Note

You may need Administrator permissions to delete the folder.

  1. Install the new version using the link.