Sangoma Softphones - Web App for Switchvox

Table of Contents

• Overview

  • Key Benefits of the Sangoma Desktop Client (Web Browser Version)

• Prerequisites

• How to Register / Login

• How to Capture Logs

• Troubleshooting Tips

  • Issue - Login Not Working — Client Keeps Reloading (Self-Signed Certificate Warning / WSS Connection Issue)

    • Resolution -

• Current Limitations / Known Issues

The Sangoma Phone Browser-Based Client https://phone.sangoma.com/ provides a powerful, feature-rich softphone experience—accessible directly from your web browser, with no software installation required. It delivers the same robust communication features as the Sangoma Phone desktop application, ensuring a consistent user experience across platforms.

Designed for today’s flexible work environments, the browser-based client integrates effortlessly with Switchvox, enabling reliable communication from virtually anywhere.

• Zero Installation Required
  Access your communications instantly—no software downloads or setup needed. Perfect for fast deployments and remote users.

• Built-In Softphone Functionality
  Place and receive calls directly through your browser using a headset and microphone.

• Integrated Advanced Queue Management
  Easily manage all queue operations—including advanced features such as whisper, barge, and monitor—directly from the browser interface.

• Integrated Visual Voicemail Management
  Listen to, manage, and respond to voicemails from anywhere, at any time.

• Call Logs Access
  View detailed call history—including inbound, outbound, and missed calls—directly from the browser, helping you track and manage communications effectively.

• Unified Contact Directory
  Quickly access your Switchvox phonebook for easy dialing and efficient communication.

• Secure, Encrypted Access
  Communications are protected with secure, encrypted browser sessions.

• Optional Real-Time Chat
  Enable instant messaging with colleagues for quick and seamless collaboration.

• Cross-Platform Compatibility
  Works smoothly on Windows, macOS, and Linux using modern browsers like Chrome, Firefox, and Safari. Its recommended to use the latest Chrome browser.
  
  

Sangoma Phone Desktop client is on Switchvox 7.x+ systems.

Open browser → Navigate to https://phone.sangoma.com/

Open

Host: Enter the Switchvox IP address or hostname.

Username / Extension: Use your extension.

Password: Enter your extension password.

Configure Audio Permissions:

• After logging in, click on the Settings icon.

• A popup will appear asking for microphone access.

• Click "Allow while visiting the site"

  Open

  

• Refresh the page to access the audio devices.

• Navigate again to Settings and select the audio devices as needed:

  Open

  

• Microphone – Select the microphone you want to use.

• Speaker – Select the audio playback device.

• Ringer – Choose where the incoming call ringing should play.

1. Navigate to Settings ->Log Settings.

2. Enable the Log Settings toggle to start capturing logs.

3. Once logging is enabled, the Download Logs button will become active. Click it to download the logs.

   Open

   

Browsers may block secure WebSocket (WSS) connections to Switchvox systems using self-signed SSL certificates due to security restrictions. Follow the steps below to manually allow the connection:

Steps to Resolve:

1. Open a new browser tab.

2. Enter the Switchvox IP address or hostname using https. Example: https://mypbx.local

3. Click on Advanced.

4. Click Proceed to the site (unsafe).

5. Once the connection is established, go back to https://phone.sangoma.com/ and try logging in again. if required.

1. Click-to-call functionality does not work from browser phone.

   1. Browser version currently does not support “tel: protocol handler” setting.