The Document describes what is Wildix Integration Service (WIService), the installation process and available features.
Created: February 2019
Updated: November 2020
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), URI dialing (sip-tel-wildix).
Several other standalone components also depend on WIService: Fax Printer, Screen sharing component, Headset integration, 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.
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.11 and higher
- Windows 7 and higher. WiService for Windows also requires .NET Framework v.4.0
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: WIService on Windows supports auto update option starting from v. 3.1.2
- To enable the option, make sure the box Keep Wildix Integration Service up to date is ticked when completing WIService setup
- 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 mod
- To disable auto update, click on Wildix Integration Service icon in Quick Launch Toolbar -> go to Settings and untick
Each time a new version is available, a popup notification is displayed:
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:
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 URI, Collaboration 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.
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.