Setup Guide

Install ClearVoice and start taking clearer calls

Before You Begin: Super User Setup

Before agents can use ClearVoice, your company's Super User (admin) must register and complete onboarding first. This sets up the company domain and enables agent registration.

Step 1: Super User Registration

  • The platform owner registers the Super User — the account is created instantly
  • The Super User signs in with their work email at the login page — no password needed
  • On first login, they are guided through onboarding — this includes setting the company email domain (e.g. acme.com)
  • The domain controls data isolation — only users with a matching email domain will see the company's data

Step 2: Register Agents

  • Once onboarding is complete, the Super User goes to the Billing Dashboard
  • They click "Register Agent" and enter each agent's work email
  • Agent accounts are created instantly — agents can sign in with their email right away, no password or invite email needed
  • The Super User can also bulk-import agents via CSV from the Import page

✅ Only after the Super User has registered and set the domain can agents be registered.

Account & Role Flow

This diagram explains how accounts are created in ClearVoice and who manages what at each level.

Platform Owner (Admin)

  • Registers Super Users at each client company
  • Manages billing, plans, seat limits & invoices
  • Full visibility into all tenants

Super User (Client Admin)

  • Registered by platform owner → signs in with email only (no password)
  • Completes onboarding (sets company domain)
  • Registers agents individually or via bulk CSV import

Agent

  • Registered by Super User → account created instantly (no password needed)
  • Or bulk imported: record created, signs in with email right away
  • Installs ClearVoice + VB-Cable, uses daily suppression

💡 Agents always log in with their email only — no passwords are needed. Once registered (individually or via bulk import), the agent can sign in immediately.

What to Expect — Noise Suppression Performance

ClearVoice uses AI-powered noise suppression to significantly reduce background noise on your calls. Here's what you can realistically expect:

  • •Keyboard / typing noise: 70–80% reduction
  • •HVAC / air conditioning hum: 75–80% reduction
  • •General office chatter: 60–75% reduction
  • •Loud environments (TV, crowds): 50–65% reduction

⚠️ ClearVoice does not eliminate noise 100%. Typical real-world suppression is 60–80%, which delivers a significant improvement in call clarity for most contact centre environments. For best results, use a quality closed-back headset and close unnecessary applications during calls.

Installation

ClearVoice can be used as a desktop app or directly in a browser tab — choose whichever fits your environment.

Desktop App vs Web App

🖥️ Desktop App

  • Standalone window that can't be accidentally closed
  • Auto-updates via installer
  • System tray icon for quick access

🌐 Web App (Browser)

  • Zero installation — just open a browser tab
  • Works on locked-down / BYOD machines with no admin rights
  • Agent must manually keep the browser tab open
Recommended

Desktop App

Install the ClearVoice desktop app for the best experience — standalone window, auto-updates, and persistent settings.

Step 1: Download & Install

  1. Download the installer: ClearVoice Setup 1.1.2.exe
  2. Run ClearVoice Setup 1.1.2.exe
  3. ClearVoice installs and launches automatically
  4. Pin it to your taskbar for quick access

✅ Success check: ClearVoice opens as a standalone desktop app.

Web App (Browser) — No Installation Required

ClearVoice works entirely in a browser tab with no installation. Ideal for locked-down or BYOD machines where you can't install software.

Steps

  1. Open your browser and go to clearvoice.africa
  2. Sign in with your work email (no password needed)
  3. Click "Start Session" and grant microphone access when prompted
  4. Keep this browser tab open for your entire shift — unlike the desktop app's standalone window, a browser tab can be accidentally closed, so treat it like an active call window and don't close it mid-shift
  5. For full dual-channel suppression (using the Customer Noise Filter toggle to also filter the other caller's audio), the same VB-Cable (Windows) / BlackHole (Mac) virtual audio driver is still required — this is a one-time OS-level driver install, completely independent of whether you use the desktop app or a plain browser tab
  6. Set your softphone's microphone to "CABLE Output" exactly as documented in the Desktop App section above — that part of the setup is identical either way

⚠️ The browser tab is your suppression engine — closing it stops filtering immediately.

Step 2: Set Up Virtual Audio Cable

⚠ One-time setup — requires IT / local admin

ClearVoice processes audio in its own window. To route the clean audio into your softphone, a virtual audio cable driver must be installed on each agent's machine. This requires local admin privileges and should be deployed by the client's IT team.

Windows — VB-Cable

  1. Download from vb-audio.com/Cable/ (free) — get the standard "Virtual Audio Cable (2ch)" version
  2. Right-click installer → "Run as administrator"
  3. Reboot after installation

🔍 Identifying the correct devices

After install you'll see two devices:

  • 🎧 Playback tab → "CABLE Input (VB-Audio Virtual Cable)" — set as ClearVoice output
  • 🎤 Recording tab → "CABLE Output (VB-Audio Virtual Cable)" — select as mic in softphone

Ignore any "CABLE In 16ch (VB-Audio Virtual Cable)" devices — those are leftovers and stay disabled. Always pick the standard "(VB-Audio Virtual Cable)" variants, never the "16ch" ones.

The CABLE Output Levels slider will show 0% and cannot be changed — this is normal and does not affect audio.

If the wrong devices appear, uninstall VB-Cable entirely, reboot, and reinstall the standard (2ch) version only.

Mac — BlackHole

  1. Download from existential.audio/blackhole/ (free)
  2. Run the installer package
  3. Reboot after installation

Configure the Softphone

  • Open your softphone's audio / microphone settings
  • Set the microphone input to "VB-Cable" (Windows) or "BlackHole 2ch" (Mac)
  • ClearVoice automatically routes processed audio to the virtual cable

✅ Success check: Make a test call — the other person should hear your voice with background noise removed.

Step 3: Start Your Day

  1. Open ClearVoice from your taskbar / dock
  2. Click "Start Session" once to grant microphone access
  3. Your saved suppression level and channel gains load automatically
  4. Minimize the window — the engine keeps running while you take calls

Step 4: During Calls

  • ClearVoice filters your mic in real time — no per-call action needed
  • Adjust the Suppression slider if a call is noisy (higher = more aggressive)
  • Use Pause if you step away; the engine auto-resumes when you return to the window

Step 5: End of Day

  • Just close the window — your session is logged automatically
  • No need to click "End Session" — closing stops the engine and saves your session

Enterprise / IT-Managed Deployment

For larger contact centres, IT can automate most of the setup across all agent machines. Here is what can and cannot be pushed centrally today:

What IT Can Push Centrally

  • ✅ Virtual audio cable driver (VB-Cable on Windows / BlackHole on Mac) — standard MSI/PKG installers deployable via SCCM, Intune, Jamf, or Group Policy
  • ✅ Chrome managed storage policy — pre-configure auto-start URLs and suppression settings for all users

What Requires Manual Action Per Agent (Today)

  • ⚠️ Desktop app installer — standard .exe install; IT can package and deploy it via SCCM, Intune, or Group Policy

💡 Alternatively, IT can provision a bookmarked link to clearvoice.africa for the Web App path instead of deploying the .exe installer — useful for locked-down or BYOD machines. The VB-Cable driver push is still required either way for full feature parity (dual-channel suppression via the Customer Noise Filter).

Summary: IT can handle the driver today, and the desktop installer can be centrally deployed via SCCM, Intune, or Group Policy — or skipped entirely in favour of a bookmarked web link.

📋Agent Quick-Start SheetPrint & Hand Out

Hand this one-page guide to each agent for a 5-minute setup. No IT knowledge needed beyond the initial VB-Cable installation.

Your 1-Minute Morning Routine

  1. Open ClearVoice from your taskbar
  2. Click "Start Session" — grant microphone permission when asked
  3. Minimize the window (the engine stays running)

That's it. You're ready for calls all day.

Quick Test (Check It's Working)

  • In your softphone audio settings, confirm microphone is set to "CABLE Output"
  • Make a test call — "Can you hear me with background noise gone?"
  • If muffled → lower the Suppression slider
  • If noisy → raise the Suppression slider

Important Tips

  • ClearVoice filters your mic by default — toggle on Customer Noise Filter to also filter the other caller\'s audio
  • Set MICROPHONE to "CABLE Output", leave SPEAKER on your headset
  • The Windows CABLE Output slider at 0% is normal — audio passes at full volume
  • Start ClearVoice before joining a call, not during

Session Timeout

For security, ClearVoice automatically signs you out after 2 hours of inactivity (no mouse, keyboard, scroll, or touch activity). Your session is properly closed with a logout timestamp so it won't appear as a stale "open" session. Simply sign back in to resume.

Troubleshooting Checklist

Go through each check:

  • ☐ ClearVoice showing "Active" (not "Idle")?
  • ☐ Audio bar moving green when you speak?
  • ☐ Softphone mic set to "CABLE Output (VB-Audio Virtual Cable)"?
  • ☐ Softphone speaker set to headset (NOT the cable)?
  • ☐ Did you click "Start Session"?
  • ☐ Suppression slider above 50%?

Still not working? Quit ClearVoice, re-open it, click Start Session, and rejoin the call.

What to Look Out For

Signs the test is working correctly

  • 🟢 The visualizer shows audio activity when you speak
  • 🟢 Status indicator shows "Active"
  • 🟢 Background noise is clearly reduced when you toggle suppression on
  • 🟢 Your voice sounds natural — not robotic or muffled
  • 🟢 No noticeable audio delay (under ~20ms)

Common issues to watch for

  • 🔴 Audio doesn't activate — click "Start" before joining the call, or refresh and retry
  • 🔴 No suppression effect — check the suppression slider is above 50%
  • 🔴 Voice sounds robotic — lower suppression to 60–70%
  • 🔴 Mic access not granted — check your browser's microphone permissions and site settings
  • 🔴 Not working on your softphone — confirm your platform URL and let us know

Sending Us Feedback

  • Which softphone platform you tested on
  • A/B comparison notes (suppression on vs off)
  • Any errors or unexpected behaviour
  • Your overall audio quality rating (1–5)

ClearVoice processes all audio locally in your browser. No audio is ever sent to external servers.