Skip to end of metadata
Go to start of metadata


Oct 28, 2021 08:41

What is WIService

The Document describes what is Wildix Integration Service (WIService), the installation process and available features.

Created: February 2019

Updated: October 2021

Permalink: https://confluence.wildix.com/x/EgAeAg

Integration service (WIService)

Wildix Integration Service (WIService) is a component that is required to be installed in order to use CDR-View, Popup App, WebRTC Phone Direct RTP (Windows, removed starting from WMS v 4.02.44497.40), URI dialing (sip-tel-wildix), Headset integration, and screen sharing.

Several other standalone components also depend on WIService: Fax Printer and Outlook integration (detailed information about these components can be found in Extensions chapter of Collaboration User Guide). When installing one of the mentioned components, WIService is automatically installed. 

Notes:

  • Headset integration is removed on Windows, all its functionality is merged into WIService starting from v 3.2.2 and call control options moved to WIService tray menu.
  • On macOS, Headset integration is also removed, all its functionality is merged into WIService starting from v 3.2.17 and call control options moved to WIService in the menu bar.
  • Screen sharing component is merged with WIService starting from v 3.4.1 (both on macOS and Windows). 

WIService integrates with Mac OS Contacts: macOS contacts lookup and call generation.

Requirements

Ports

  • Make sure that FQDN “wildixintegration.eu” is correctly resolved with the IP: 127.0.0.1 by your DNS (on the user PC or on the router side)

OS requirements

  • macOS X 10.12 and higher
  • Windows 7 and higher. WIService for Windows also requires .NET Framework v.4.0

Note: WIService is not supported on macOS 10.11 or lower starting from v 3.4.5.

Installation

Go to Collaboration Settings -> Extensions:

  • Integration service -> click INSTALL

  • WIService.pkg (macOS)/ SetupWIService.exe (Windows) is downloaded
  • Install the package following the prompts

macOS:


Windows: 

You can enable auto update option:

macOS (available from v. 3.1.4)

  • After WIService installation is completed, click Yes to enable the option Keep Wildix Integration Service up to date

  • Auto update starts every day at a random time between 1 AM and 6 AM, or right after the computer starts or wakes up from sleep mode:


or

  • Go to Menu Bar -> click on Wildix Integration Service icon and select Settings
  • Enable the option Keep Wildix Integration Service up to date:

Windows (available from v. 3.1.2)

  • When completing WIService setup, make sure the box Keep Wildix Integration Service up to date is ticked:


  • Windows Task Scheduler checks for updates every day at 01:00-06:00 or after starting PC. If a new version is available, it downloads a new installation package and runs it in silent mode

or

  • Go to Quick Launch Toolbar -> right-click on Wildix Integration Service icon and select Settings
  • Enable the option Keep Wildix Integration Service up to date:


Security permissions and settings

Once WIService is installed, the system asks for security permission to be allowed:


To check allowed sources on:

macOS:

  • Go to Menu Bar -> click on Wildix Integration Service icon and select Settings:


Windows

  • Go to Quick Launch Toolbar -> right-click on Wildix Integration Service icon and select Settings:



Manual update of WIService

Manual update may be required if you turned off auto update of WIService. If there is an update available, the button next to Integration service in Collaboration Settings -> Extensions changes to UPDATE. Click on it to get the newest version of WIService:

Supported features

After installation of WIService, the following features become available:

  • CDR-View 

CDR-View is monitoring and reporting tool.

Details: CDR-View User Guide.

  • Popup App

Popup URL/ App can be set up in Collaboration Settings -> Personal, see the guide: How to set up web application integration via Popup URL.

  • Direct RTP (experimental) (removed starting from WMS v. 4.02.44497.40)

The feature is enabled in Collaboration Settings -> Web Phone -> Enable direct-rtp (experimental). It allows RTP streams to be passed directly between devices.

Details: How to set DSCP QoS for Wildix devices and Web Phone.

  • Call generation via URI

Thanks to URI support it is possible to generate a call by clicking on a link containing a phone number. After you click on a link, a call is placed via an active device selected in Collaboration.

Details: What is Wildix URICollaboration User Guide.

  • Call generation via shortcut 

    Note for macOS: The feature is available starting from WIService v. 2.11.4. Also make sure "Wildix" is added to Accessibility permissions in macOS Security & Privacy settings.

The option is enabled in Collaboration Settings -> Personal -> Dialing hot key. It allows setting up a shortcut for click2call from applications/ web pages. To place a call, select a phone number and press the key combination. The call is placed via an active device set in Collaboration.

Details: Collaboration User Guide.

  • Headsets support

The feature ensures support of remote call answer/ hangup and volume control for Wildix and compatible third-party headsets (Jabra, Plantronics, Sennheiser). Depending on the OS of your device, you can enable it in the following way: 

Windows:

Go to WIService tray menu -> Settings -> tick off Headset integration enable. Call control options are available in WIService tray menu: 


macOS:

Go to the Menu Bar -> click on the Wildix Integration Service icon -> choose Settings, and make sure the option Headset integration enable is ticked off. You can find call control options in the Wildix Integration Service menu:


  • Screen sharing and remote control

The features allow you to share your screen with other users and let them take remote control of your device

Details: Collaboration User Guide.

Note for macOS: For screen sharing to work correctly, make sure to grant the necessary permissions in System Preferences -> Security & Privacy -> Screen Recording -> tick off Wildix



Troubleshooting

In case you have any issues with the component or want to restart/ uninstall it, follow Debugging of Wildix Integration Service and related components for instructions.


Not finding the help you need?
Join the Facebook group to ask a question!
facebook_tech-wizards