Genesys Softphone architecture

From Genesys Documentation
Jump to: navigation, search
This topic is part of the manual Genesys Softphone Administrator's Guide for version Current of Genesys Softphone.

The architecture and features of Genesys Softphone when deployed in your environment.

Related documentation:


Genesys Softphone embeds the Genesys SIP Endpoint Core Library to take advantage of the SIP-based third-party call control functionality.

Standard architecture

The following diagram illustrates the Genesys Softphone architecture when it is installed on a physical workstation as a standard executable gathering all product functionalities:

Genesys Softphone 900 Architecture.png

Architecture in VDI environments

Genesys Softphone supports the Citrix Virtual Desktop Infrastructure (VDI). When deployed in this kind of environment, the Genesys Softphone software is divided into two parts:

  1. The application layer, running in the Virtualized system. This is the Genesys Softphone executable. The user interface runs here as well as connections to other applications, such as Agent Workspace. You install this through the Genesys Softphone installation package by selecting the Citrix installation option.
  2. The Signaling Protocols, the Media Protocols, and the Audio Device management. These are off-loaded to the physical workstation to optimize call quality and ensure network and data center scalability. It is a plug-in (DLL) to the VDI Client run-time (Citrix Workspace app, previously known as Citrix Receiver). It is deployed by the Genesys Softphone VDI Adapter installation package.

The two Software parts communicate over the Citrix ICA proprietary protocol already established for standard Citrix operations; therefore, there is no need for any extra connectivity settings.

The following diagram illustrates the Genesys Softphone architecture in the Citrix VDI environment:

Genesys Softphone 900 Architecture VDI Citrix.png

Features and functionality

Genesys Softphone media stack is based on Google's open source WebRTC Native Code package. Softphone includes an adaptive jitter buffer, Packet Loss Concealment (PLC), echo cancellation, and noise reduction. For more information refer to SDK for .NET.

The following are the standard features and functions of Genesys Softphone.


The Genesys Softphone supports Dual-Tone Multi-Frequency (DTMF) signalling according to the RFC 2833 standard for third-party call control.

After receiving a NOTIFY with DTMF event, the Softphone Endpoint generates DTMF signals.

DTMF can be sent by using one of the three possible methods:

  • InbandRTP
  • RFC 2833
  • SIP INFO message

Third-party call control

When the Genesys Softphone Endpoint has registered on the Genesys SIP Server, it will support the following third-party call control scenarios:

  • Make a call
  • Answer a call
  • Hold and retrieve a call
  • Single-step and two-step transfers
  • Participate in a conference that is provided by the GVP
  • Play DTMF signals.

SIP Voice

The Genesys Softphone supports the following codecs for SIP signaling:

WebRTC Voice

The Genesys Softphone supports the following codecs for WebRTC signaling:

  • OPUS
  • G711

WebRTC and TLS in Windows 7

When Genesys Softphone is used for WebRTC communication, TLS 1.2 is used; however, Windows 7 does not support TLS 1.2 by default; therefore, you must enable TLS 1.2 in Windows 7 before you can use Genesys Softphone in WebRTC mode.

Refer to the following Microsoft document for the procedure to enable TLS 1.2: Update to enable TLS 1.1 and TLS 1.2 as default secure protocols in WinHTTP in Windows.

WebRTC and OAuth Support

WebRTC with OAuth is supported in Agent Workspace/Softphone connector mode only. If you use the standalone Softphone mode, you must migrate to connector mode. To enable this feature in Agent Workspace you must configure the value of the sipendpoint.enable_webrtc_auth option to true.

Virtual Desktop Infrastructure (VDI)

Softphone supports Virtual Desktop Infrastructure (VDI) to enable agents to use Softphone in a VDI environment.

Softphone can be deployed in a Citrix virtual environment.


Starting from release, Genesys Softphone can be presented in various languages.

In Connector Mode, some agent applications like Workspace Web Edition can automatically align the language with the one selected in the controlling application. In other cases, the agent can select the language using the appropriate menu.

Comments or questions about this documentation? Contact us for support!