Skip to main content
8x8 Support

Citrix VDI integration - 8x8 Work for Desktop & Web

Overview

8x8 Work for Desktop is integrated with Citrix to improve your audio calls quality. Currently this is an optimization focused on telephony users who have a Citrix Virtual Desktop environment on their machines.

Applies To

  • 8x8 Work for Desktop on Windows 7.17 or above
  • 8x8 Work for Web on Windows 7.18 or above

Citrix VDI integration system requirements

In order to use Citrix, you must meet the following system requirements.

Clients

Server

Citrix Virtual Apps and Desktops service (XenApp & XenDesktop service) version 19.12 or above.

Whitelisting the applications

Inside the virtual desktop, IT admins must add the following registry key in order to whitelist the 8x8 Work app or the supported browser for Work web app to leverage the Citrix optimization:

Key Path: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\WebSocketService

Key Name: ProcessWhitelist

Key Type: REG_MULTI_SZ

Key Value: 8x8 Work.exe
                   chrome.exe

(Chrome.exe is needed when using VDI optimization through https://work.8x8.com)

Network firewall changes

Thin clients or the endpoints used to connect to the Citrix sessions require a network environment that doesn't block the traffic to the 8x8 data centers, as with the optimization, the voice path is offloaded to the endpoints. Please follow our default network recommendations https://support.8x8.com/cloud-phone-...ecommendations   

Network Traffic and Routing

  • RTP (voice traffic) will egress from the local machine when VDI optimization is enabled, not the Citrix Server.
  • DNS Queries will be performed on the Citrix Server, as this is where the application is homed. Please verify/take this into account when troubleshooting. Because the DNS Queries take place on the Citrix Server there may be a discrepancy in the 8x8 Global Reach Traffic Routing due to where the Client is physically located vs the Citrix Server.

Checking optimization

You can check if Citrix optimization has been activated inside the app by checking the following indicators:

Local audio devices

Within the app, check Call using dialog and assert Computer - VDI is showing.

 

Citrix optimization process

On the local machine (thin client) check the following process to be running parallel to 8x8 work.exe:

Windows: ​​HdxTeams.exe

Mac: HdxRtcEngine

 

Frequently Asked Questions

Why am I not being heard or can't record VM greetings?

It may happen that the Operating System microphone permission prevents the 8x8 Work Desktop app from accessing the microphone. Check this article on how to ensure the app has mic permissions.

Can I use 8x8 Work in multiple VDI sessions simultaneously?

When the app runs inside Citrix VDI and there's a device conflict (same Citrix user is logged on multiple machines and within 8x8 with the same user), the 'This is not the main browser tab of 8x8 Work for Web app. Only the main tab of the app can receive incoming calls.' is shown. This will be replaced with 'The 8x8 Work app is opened in other VDI instances with the same user credentials. Calls can be received in only one instance.'. Calls will be received where the user selects 'Receive calls here'.

How to make 8x8 Work ‘Highlight to Dial’ feature work inside Citrix?

For 'Highlight to Dial' to work in a Citrix environment you need to enable the bidirectional content redirection policy. 'Highlight to Dial' allows you to quickly place a call to a phone number that is currently highlighted in another app (such as in a spreadsheet, a notepad, etc) by using the  Ctrl+Shift+8 or your own shortcut. If you have not highlighted a number, use the shortcut to open the dial pad to place a call. 

Citrix offers host-to-client redirection and Local App Access for the client to URL redirection. However, we recommend that you use bidirectional content redirection for domain-joined Windows clients. For more details please go to docs.citrix.com.

Known limitations

  • This optimization is focused on VoIP / telephony only at this moment. Video Meetings optimization is not currently available.

  • UC headset call controls are not supported in VDI mode 

  • 3-way calls are not supported in 8x8 Work for Desktop while the Citrix optimization is active

  • VDI Optimization is not working when using Citrix through a browser

Additional Information

This optimization is part of the Citrix Ready Unified Communications Program and employs the Citrix Ready Unified Communications Premium integration via the Citrix WebRTC SDK. This is not using the BCR policies.

If you have further VDI inquiries related to 8x8, please email workapps-team@8x8.com.

  • Was this article helpful?
/**/