Skip to main content
UpdatedAdded support for On-device audio capture in the Web SDK. You can now capture audio from the system audio of the browser window that contains your telehealth call.
Quick summary
Telehealth sessions allow you to capture audio from different tabs on a browser window for remote patient care. The Web SDK also supports on-device audio capture for care management, telehealth, and VoIP workflows when you share system audio from the browser. This feature is opt-in and disabled by default.

The Web SDK supports audio capture from different tabs in the same browser window (with or without a headset). With supported browsers and operating systems, it can also capture on-device audio when the user shares system audio from the browser share dialog.
Last updated:June 2026
Telehealth sessions are a special type of ambient session that you can use for remote patient care. The Suki Web SDK (version 2.1.0 and later) supports capturing audio from different tabs directly from your browser. The Web SDK now supports on-device audio capture when you share system audio from the browser. This helps partners go deeper with care management, telehealth, and VoIP use cases where patient audio plays through the device rather than only through a shared browser tab.
Compatibility:
  • Tab audio: Capture audio from a browser tab in the same window (with or without a headset).
  • On-device audio capture: Share system audio from the browser share dialog. Requires macOS 14.2+ or Windows 11, Google Chrome 142+, and the user to enable Share system audio (macOS may require a one-time permission in System Settings).
  • Not supported: Audio capture from local or native desktop applications (for example, a standalone Zoom or Teams app) outside the browser share flow.

​
How to enable the Telehealth Audio Capture feature

Enable the Telehealth Audio Capture feature in the Suki Web SDK UI.
Telehealth Audio Capture feature is an opt-in setting and is disabled by default.
To enable Telehealth Audio Capture feature, follow these steps:
1

Navigate to Settings

In the Suki Web SDK UI, navigate to the Ambient Settings option.Settings
2

Turn on Capture Telehealth Audio

Turn on the Capture Telehealth Audio toggle button.Telehealth Audio Capture

​
How it works

When you enable Telehealth Audio Capture and click Start Ambient or Re-Ambient, the SDK prompts you to share your screen.

​
Tab audio

For tab audio, select the browser tab that contains your telehealth call.
In the browser share modal, select the correct Chrome tab and enable Also share tab audio (or similar).

​
On-device audio capture

For care management, telehealth, and VoIP workflows, you can capture on-device audio by sharing Entire Screen (or the window that contains your call) and enabling Also share system audio.
Requirements for on-device audio capture:
  • macOS 14.2+ or Windows 11
  • Google Chrome 142+
  • Share system audio turned on in the browser share dialog
On macOS, Chrome may prompt you to open System Settings and allow System Audio Recording Only for Chrome. After you enable that permission, restart Chrome and start the ambient session again.
Chrome share dialog on macOS with Entire Screen selected, Also share system audio enabled, and a prompt to allow System Audio Recording Only for Chrome in System Settings.
On macOS, select Entire Screen, turn on Also share system audio, then follow the Open System Settings prompt if Chrome asks you to allow System Audio Recording Only for Chrome.

​
Session behavior

The following are the different states of the ambient session when telehealth audio capture is enabled:

On Pause

If you close the shared tab or click the browser’s Stop Sharing button, the ambient session will automatically pause.

On Resume

To restart the session, click Resume in the SDK. This action will open the browser’s share modal again.

On Window/Screen Selection

The SDK uses browser screen-capture APIs for telehealth audio. Select a tab for tab audio, or Entire Screen (or a window) with system audio enabled for on-device audio capture.

​
Recommendations for partners

For the best compatibility and performance, follow these recommendations:
  • Use Google Chrome 142+ on macOS 14.2+ or Windows 11 when you need on-device audio capture.
  • Use browser-based telehealth workflows.
  • For tab audio, select a browser tab and enable Also share tab audio.
  • For on-device audio capture, select Entire Screen (or the relevant window), enable Also share system audio, and complete any macOS System Settings permission for Chrome.
On-device audio capture depends on browser and operating system support. Verify the share dialog shows Also share system audio and that macOS permissions are enabled before you start an ambient session.
Suki supports tab audio and on-device audio capture through the browser share dialog. Ensure you select the correct share target and enable the matching audio option when prompted.

​
Error handling

Cause: This error occurs if you did not enable the required audio option in the browser share modal. The SDK requires a tab audio stream or a system audio stream, depending on your share selection.Solution: Start the ambient session again. For tab audio, select the correct browser tab and enable Also share tab audio. For on-device audio capture, select Entire Screen, enable Also share system audio, and on macOS confirm System Audio Recording Only is allowed for Chrome in System Settings.

​
Next steps

Refer to Branding guide to learn more about how to brand the Suki Web SDK.
Last modified on June 30, 2026