Skip to content

Use the in-browser softphone

Pick up and place calls without installing anything. Headset support, transfer, hold, mute, and the active-call drawer.

The hey-quad softphone runs in any modern browser — no install, no plugin. Sign into the dashboard, your WebRTC extension is registered, and you can pick up calls in any tab.

Get set up

  1. Sign in to app.heyquad.com.
  2. Make sure you have a WebRTC extension assigned to you. (Visit Extensions → look for one with kind = WebRTC.) If you don't, ask an admin to create or assign one.
  3. Allow microphone access when the browser prompts. Calls won't work without it.
  4. Open the Softphone page once to confirm it shows the green "Registered" pill.

That's it. From now on, the softphone runs in the background of every tab — incoming calls ring with a notification.

Place a call

Three places to dial from:

  • Softphone page — the keypad, plus a recent-calls list.
  • Contacts — click any contact to dial them.
  • Browser toaster — use the call control widget that pops on every page.

Calls leave from your assigned phone number's caller ID. If you have multiple, pick the right one from the caller-ID dropdown before dialing.

Receive a call

When a call rings:

  • The browser shows a notification (if you've granted permission) and plays a ring tone.
  • The active-call drawer slides in with caller info, hangup, hold, mute, and transfer buttons.
  • Click Answer to pick up — the call audio routes to your selected output device (usually a headset).

If you're already on a call, the second one waits in your queue ringing-window. You can switch by parking the first on hold.

Active-call controls

While on a call:

  • Mute — drops your mic. The other side hears silence.
  • Hold — plays hold music to the caller, pauses your audio. Use Resume to come back. Calls placed on hold fire onCallHold triggers in the flow.
  • Transfer — pop the dial pad and forward the caller to another extension or external number. Blind transfer (current default) hands the call off and drops you out.
  • Hangup — ends your leg of the call.

Recommended hardware

  • Wired USB headset (Plantronics / Jabra / Logitech) — the most reliable. Bluetooth works but has more failure modes.
  • No echo cancellation issues if you use a closed-back headset. Open speakers + microphone in the same room is a recipe for feedback.
  • Wired ethernet if your office Wi-Fi is congested. WebRTC tolerates jitter but not 5%+ packet loss.

Common gotchas

  • The softphone only rings while a tab is open. If you close every hey-quad tab, your extension stops registering and the call goes to voicemail (or the next agent in the queue). Add a PSTN-forward fallback on your extension to cover lunch + after-hours.
  • Browser permissions can silently lapse. If your mic was working yesterday and isn't today, check the browser's site settings — Chrome occasionally clears mic grants after long idles.
  • Audio cuts out on screen lock. macOS and Windows can suspend background audio when the laptop sleeps. Disable system sleep, or run the softphone on a docked monitor that stays awake.
  • Bluetooth devices switch profiles. When the mic activates, Bluetooth headphones drop from high-quality A2DP to low-quality HSP/HFP — that's a Bluetooth limitation, not a hey-quad bug.