Jump to: navigation, search

Genesys Softphone

Welcome to the Genesys Softphone Deployment Guide. This document describes how to deploy and configure the Genesys Softphone in your environment.

This article describes the Genesys Softphone architecture in your environment. It covers both standard and Virtual Desktop Infrastructure (VDI) installations.


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 connectivity with other applications, such as Agent Desktop. 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


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:

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 Desktop/Softphone connector mode only. If you use the standalone Softphone mode, you must migrate to connector mode. To enable this feature in Agent Desktop 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.

This page was last modified on October 9, 2019, at 05:49.


Comment on this article:

blog comments powered by Disqus