Table of Contents

• Overview

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

• Prerequisites

  • PBXact/FreePBX System -

• 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

• References

Overview

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 Sangoma PBX systems such as PBXact and FreePBX, enabling reliable communication from virtually anywhere.

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

• 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.

• Voicemail with Scribe (Transcription)
  Read transcribed voicemails directly in the interface, making it faster and more convenient to process messages, even in noisy or busy environments. Applicable only for PBXact and Freepbx with licensed Scribe module.

• Unified Contact Directory
  Quickly access your PBX 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.

Prerequisites

PBXact/FreePBX System -

Sangoma Phone Desktop client is only on PBXact/Freepbx v15+ systems.

A valid commercial license for the softphone is required for the FreePBX/PBXact systems.

PBXact/FreePBX system must be updated to the following module versions (or newer):

• Sysadmin: v17.0.2.32 or v16.0.49.12 or v15.0.33.31

• Sangomartapi: v17.0.9.18 or v16.0.54.18 or 15.0.60.11

• Restapps: v17.0.1.39 or v16.0.36.26 or v15.0.42.16

• Sangomaconnect: v17.0.3.25 or v16.0.51.22 or v15.0.63.13

Once the modules are updated, generate the new compatible HAProxy configuration by executing the following command:

fwconsole sa rebuildhaproxy

Then, restart the HAProxy service to apply the changes:

haproxy-ctl restart

Please note that restarting HAProxy will temporarily drop all active connections from the desktop client app. However, users will be automatically reconnected and logged in again.

How to Register / Login

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

Host

FreePBX/PBXact - Enter the PBX IP address or hostname using https along with RTAPI port. Example: https://mypbx.local:6443

Username / Extension

FreePBX/PBXact - Use your User Control Panel (UCP) login name.

Password

FreePBX/PBXact - Enter your UCP login 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"

  

• Refresh the page to access the audio devices.

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

  

• Microphone – Select the microphone you want to use.

• Speaker – Select the audio playback device.

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

How to Capture Logs

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.

   

Troubleshooting Tips

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

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

Resolution -

Steps to Resolve:

1. Open a new browser tab.

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

   1. Use RTAPI port if connecting to PBXact/Freepbx for example with RTAPI port. Example: https://mypbx.local:6443

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.

Current Limitations / Known Issues

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

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

References

1. Refer to the following wiki to set up the Sangoma Desktop Phone in your PBXact / FreePBX.
   Softphones - Sangoma Desktop phone Setup Wizard

2. Refer to the following wiki to enable the Supervisor feature in your PBXact / FreePBX.
   Softphones - Sangoma Desktop phone Supervisor Wizard