Zebra Workforce Connect: Voice Client Workforce Connect Voice Client 8.2.x Administrator Guide for Mitel
WORKFORCE CONNECT
Voice Client 8.2.x
Administrator Guide
for Mitel
MN-002696-07EN
Copyright
ZEBRA and the stylized Zebra head are trademarks of Zebra Technologies Corporation, registered in many
jurisdictions worldwide. All other trademarks are the property of their respective owners. ©2019 Zebra
Technologies Corporation and/or its affiliates. All rights reserved.
COPYRIGHTS & TRADEMARKS: For complete copyright and trademark information, go to www.zebra.com/
copyright.
WARRANTY: For complete warranty information, go to www.zebra.com/warranty.
END USER LICENSE AGREEMENT: For complete EULA information, go to www.zebra.com/eula.
Terms of Use
• Proprietary Statement
This manual contains proprietary information of Zebra Technologies Corporation and its subsidiaries
(“Zebra Technologies”). It is intended solely for the information and use of parties operating and
maintaining the equipment described herein. Such proprietary information may not be used, reproduced,
or disclosed to any other parties for any other purpose without the express, written permission of Zebra
Technologies.
• Product Improvements
Continuous improvement of products is a policy of Zebra Technologies. All specifications and designs are
subject to change without notice.
• Liability Disclaimer
Zebra Technologies takes steps to ensure that its published Engineering specifications and manuals are
correct; however, errors do occur. Zebra Technologies reserves the right to correct any such errors and
disclaims liability resulting therefrom.
• Limitation of Liability
In no event shall Zebra Technologies or anyone else involved in the creation, production, or delivery of the
accompanying product (including hardware and software) be liable for any damages whatsoever
(including, without limitation, consequential damages including loss of business profits, business
interruption, or loss of business information) arising out of the use of, the results of use of, or inability to
use such product, even if Zebra Technologies has been advised of the possibility of such damages. Some
jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so the above
limitation or exclusion may not apply to you.
Revision History
Changes to the original guide are listed below:
Change Date Description
-01 Rev A 1/2017 Initial release.
-02 Rev A 6/2017 Addition of call park and conference features. Update to Voice Client 8.2.x.
-03 Rev A 9/2017 Update licensing information.
-04 Rev A 3/2018 Add information on TCP/UDP port usage.
Add information on configuring multiple PBXs, WiFi Preferred, importing contacts.
2
Change Date Description
-05 Rev A 5/2019 Updating features for most recent release of the client.
-06 Rev A 7/2019 Updates to custom ringtone and audio prompt file formats. Update to Home Screen
Dashboard section.
-07EN Rev A5/2020 Ringtone option added to main menu. Sign out and reload are now separate options
in main menu. When selecting ringtone from SD card, option should read Custom
Ringtones.
3
Table of Contents
Copyright ........................................................................................................................................... 2
Terms of Use .................................................................................................................................... 2
Revision History ................................................................................................................................ 2
About This Guide
Introduction ..................................................................................................................................... 11
Chapter Descriptions ...................................................................................................................... 11
Notational Conventions ................................................................................................................... 12
Related Documents and Software .................................................................................................. 12
Service Information ......................................................................................................................... 12
Configuring the Client
Introduction ..................................................................................................................................... 13
Determine Deployment Readiness ................................................................................................. 13
Connect Android Wireless Device to Network ................................................................................ 13
Install Workforce Connect Voice Client ........................................................................................... 14
Download and Install Board Support Package (BSP) Operating System ................................. 14
Download and Install Android Application Packager (APK) Client ............................................ 14
Installing the APK Manually ................................................................................................ 14
Installing the APK Using ADB Commands .......................................................................... 14
Create a Shortcut for the Workforce Connect Voice Client ....................................................... 14
Open Workforce Connect Voice Client ........................................................................................... 15
Activate Workforce Connect Voice Client ....................................................................................... 16
Activate Using an Activation Key .............................................................................................. 16
Activate Using an MDM ............................................................................................................. 18
MDM Deployment ............................................................................................................... 18
Activate Using a USB Tether .................................................................................................... 18
Update License ......................................................................................................................... 18
Configure Workforce Connect Voice Client .................................................................................... 18
Configure Using the WFC Voice Client GUI .............................................................................. 19
Configure Using an MDM .......................................................................................................... 21
MDM Deployment ............................................................................................................... 21
Configure Using a USB Tether .................................................................................................. 21
4
Table of Contents
Configuring the PBX
Introduction ..................................................................................................................................... 22
Collect Necessary Information ........................................................................................................ 22
Create Users ................................................................................................................................... 22
System Feature Settings ................................................................................................................. 27
Check Device Settings .................................................................................................................... 29
Dynamic Configuration
Introduction ..................................................................................................................................... 31
Overview ................................................................................................................................... 31
General Device Use Cases ............................................................................................................. 31
Device Start-Up ............................................................................................................................... 32
Device Identification ........................................................................................................................ 32
Profile Configuration ....................................................................................................................... 33
Connection Attributes ................................................................................................................ 33
Dynamic Configuration .................................................................................................................... 34
Enabling Dynamic Configuration ............................................................................................... 34
Wcfvariable.xml File ................................................................................................................. 34
XML File Location ..................................................................................................................... 35
DHCP Option 150 ..................................................................................................................... 36
Configuration Resynchronization .................................................................................................... 36
Dynamic Configuration Start-Up - Server Side ............................................................................... 37
Dynamic Configuration Start-Up - Client Side ................................................................................. 38
XML File Examples ......................................................................................................................... 39
Testing Remote Dynamic Configuration ......................................................................................... 40
Settings
Introduction ..................................................................................................................................... 42
Exiting WFC Voice Client: ......................................................................................................... 42
Reloading WFC Voice Client: .................................................................................................... 42
Profile Settings ................................................................................................................................ 43
Create Profile ............................................................................................................................ 43
Change Profile Name ................................................................................................................ 43
Shared Profiles URI .................................................................................................................. 43
Load New Profile ....................................................................................................................... 44
Loading a New Profile Using the GUI ................................................................................. 44
Loading a New Profile Using XML ...................................................................................... 44
Installing the APK Using ADB Commands .......................................................................... 44
Save Current Profile .................................................................................................................. 44
Edit a Profile Using XML ........................................................................................................... 45
Connection Parameters .................................................................................................................. 46
Configuring Multiple PBX Types ............................................................................................... 47
Audio Settings ................................................................................................................................. 48
Audio Codecs Priorities ............................................................................................................. 50
Jitter Buffer ................................................................................................................................ 51
Jitter Initial Delay ................................................................................................................. 51
Jitter Buffer Max Buffer Size ............................................................................................... 51
RTP Parameters ....................................................................................................................... 52
Real-Time Transport Protocol (RTP) Parameters - Payload Size ....................................... 52
5
Table of Contents
First Real-Time Transport Protocol (RTP) Port ................................................................... 52
Last Real-Time Transport Protocol (RTP) Port ................................................................... 52
Audio Enhancements ................................................................................................................ 53
Configuring Audio Enhancements ....................................................................................... 53
Input / Output Audio ............................................................................................................ 53
Audio Debugging Tools ....................................................................................................... 53
UI Settings ...................................................................................................................................... 55
Configuration File Sections ....................................................................................................... 55
Profile Section ..................................................................................................................... 55
Footer Section ..................................................................................................................... 55
Dashboard Section .............................................................................................................. 56
Call Buttons Section ............................................................................................................ 56
Headless Mode ......................................................................................................................... 56
Background Logo ...................................................................................................................... 57
Icon Library ......................................................................................................................... 57
Custom Background Configuration ..................................................................................... 57
Custom Background Configuration ..................................................................................... 57
Buttons Padding ........................................................................................................................ 57
Dialer Padding ........................................................................................................................... 58
Graphical User Interface Design Tool ....................................................................................... 58
Using the UI Settings GUI Design Tool ............................................................................... 59
Home Screen Dashboard .......................................................................................................... 61
In-Call Dashboard ..................................................................................................................... 61
Button Configuration ................................................................................................................. 62
Call ...................................................................................................................................... 62
Dial ...................................................................................................................................... 64
Start App ............................................................................................................................. 65
Log Marker .......................................................................................................................... 66
Speed Dial 0-9 .................................................................................................................... 67
Redial .................................................................................................................................. 68
Suspend Mode .................................................................................................................... 69
History ................................................................................................................................. 70
Contacts .............................................................................................................................. 71
Favorites ............................................................................................................................. 72
Voicemail ............................................................................................................................. 73
Do Not Disturb ................................................
Add Call ............................................................................................................................... 75
Home ................................................................................................................................... 76
Hold ..................................................................................................................................... 77
Resume ............................................................................................................................... 78
Transfer ............................................................................................................................... 79
Conference .......................................................................................................................... 80
Complete ............................................................................................................................. 81
End Call ............................................................................................................................... 82
List ....................................................................................................................................... 83
Blank ................................................................................................................................... 86
Reload ................................................................................................................................. 87
Sign Out .............................................................................................................................. 88
Ringtone .............................................................................................................................. 89
Icons .......................................................................................................................................... 90
Icon Library ......................................................................................................................... 90
..................................................................... 74
6
Table of Contents
Custom Icon Configuration .................................................................................................. 90
Icon Scale Type .................................................................................................................. 91
Button Color .............................................................................................................................. 93
Button Background Color .................................................................................................... 93
Button Text Color ................................................................................................................ 94
Global Button Color Settings ..................................................................................................... 95
Global Button Background Color ......................................................................................... 95
Global Button Text Color ..................................................................................................... 96
Reset Colors to Default ............................................................................................................. 97
Restore Buttons ........................................................................................................................ 97
Call Settings .................................................................................................................................... 98
Call Waiting Volume .................................................................................................................. 99
Call Waiting Interval ................................................................................................................ 100
Ringer OFF In Charger ........................................................................................................... 100
Disable Speaker mode ............................................................................................................ 100
Speaker on table ..................................................................................................................... 101
Call Accept Style ..................................................................................................................... 102
Configure the Glow Pad Buttons ....................................................................................... 103
Auto Answer Mode .................................................................................................................. 104
Incoming Call Voice Announcer .............................................................................................. 104
No Audio Cutoff ....................................................................................................................... 104
Audio Prompt File .................................................................................................................... 104
MOH Enabled .......................................................................................................................... 105
MOH File ................................................................................................................................. 105
Ringtones ...................................................................................................................................... 106
Line Ringtones ........................................................................................................................ 106
Miscellaneous Settings ................................................................................................................. 107
Sign OUT in Charger ............................................................................................................... 107
Setting Sign OUT in Charger ............................................................................................ 107
Flexible TLS ............................................................................................................................ 107
Setting Flexible TLS .......................................................................................................... 107
WiFi Preferred ......................................................................................................................... 107
Setting WiFi Preferred ....................................................................................................... 108
Help URL ................................................................................................................................. 108
Setting Help URL .............................................................................................................
Settings Password .................................................................................................................. 108
Additional Profile URI .............................................................................................................. 109
Setting Additional Profile URI ............................................................................................ 109
Contacts URL .......................................................................................................................... 109
Setting Contacts URL ........................................................................................................ 109
Sync Contacts ......................................................................................................................... 109
Creating a Contacts List .................................................................................................... 109
Syncing Contacts .............................................................................................................. 110
. 108
Logging
Introduction ................................................................................................................................... 111
Logging Level ................................................................................................................................ 111
Setting Logging Level ........................................................................................................ 111
Logging Types .............................................................................................................................. 112
Logging to Console ................................................................................................................. 112
7
Table of Contents
Logging to File ......................................................................................................................... 112
Logging to HTTP Post URL ..................................................................................................... 112
Log Files ....................................................................................................................................... 113
Workforce Connect Logs ......................................................................................................... 113
Fusion Logs ............................................................................................................................. 113
Collecting LogCat with RxLogger .................................................................................................. 113
Enabling RXLogger ................................................................................................................. 113
Log Marker .................................................................................................................................... 115
Adding a Log Marker ............................................................................................................... 115
Configuring Log Marker ........................................................................................................... 115
Fusion Logs .................................................................................................................................. 115
Enabling Fusion Settings In Android 6 or 7 ............................................................................. 116
Enabling Fusion Settings In Android 8 or Later ....................................................................... 116
Capturing the Logs ........................................................................................................................ 116
Headless Mode and WFCVoice Service
Introduction ................................................................................................................................... 117
Integrating WFCVoice Service Plug-in .......................................................................................... 118
Enabling Headless Mode .............................................................................................................. 118
Initiating a Call .............................................................................................................................. 118
Reporting App State ...................................................................................................................... 119
WFCDemo Android Project ........................................................................................................... 120
Using the Client
Introduction ................................................................................................................................... 123
Home Screen Dashboard ............................................................................................................. 125
In-Call Dashboard ......................................................................................................................... 125
Signal Quality ................................................................................................................................ 126
Calling ........................................................................................................................................... 126
Making a Call .......................................................................................................................... 126
Receiving a Call ...................................................................................................................... 128
Accept-Reject Buttons ....................................................................................................... 128
Sliding Tab ........................................................................................................................ 128
Glow Pad ........................................................................................................................... 128
Popup Window .................................................................................................................. 128
End Call ................................................................................................................................... 129
Add Call ................................................................................................................................... 129
Call Hold and Resume .........................................................................................................
Call Park and Unpark .............................................................................................................. 132
Call Park ............................................................................................................................ 132
Call Unpark ....................................................................................................................... 133
................................................................................................................................................ 133
Voicemail ...................................................................................................................................... 134
Message Waiting ..................................................................................................................... 134
Message Retrieval .................................................................................................................. 134
Contacts ........................................................................................................................................ 135
Favorites ....................................................................................................................................... 136
Call Log / Call History ................................................................................................................... 137
View Recent Calls ................................................................................................................... 137
... 132
8
Table of Contents
Dial from Call History .............................................................................................................. 137
Delete Call History .................................................................................................................. 137
View Call History ..................................................................................................................... 137
Advanced Calling Features ........................................................................................................... 139
Multiple Lines .......................................................................................................................... 139
Multiple Line Appearances ................................................................................................ 139
Busy Indicator ................................................................................................................... 139
Transfer (attended, semi-attended) ......................................................................................... 140
Ad hoc Conference ................................................................................................................. 141
Miscellaneous Features ................................................................................................................ 144
Ringtone .................................................................................................................................. 144
Reload ..................................................................................................................................... 144
Sign Out .................................................................................................................................. 144
Speed Dial Numbers ............................................................................................................... 144
................................................................................................................................................ 144
Suspend Mode ........................................................................................................................ 145
List ........................................................................................................................................... 145
Home ....................................................................................................................................... 146
Adjusting the Ring Volume ...................................................................................................... 146
Unique Ringtone per Line Appearance ................................................................................... 146
Unique Ringtone per Contact .................................................................................................. 146
Distinctive Ringing ................................................................................................................... 146
Vibrate/Ring Tone ................................................................................................................... 146
Start Application ...................................................................................................................... 147
Log Marker .............................................................................................................................. 147
Adding a Log Marker ......................................................................................................... 147
Caller ID .................................................................................................................................. 147
Hold Recall .............................................................................................................................. 147
On-hook Dialing ...................................................................................................................... 147
Button Actions
XML Tags
XML Example - Profile
XML Example - Footer
XML Example - Dashboard
XML Example - Call Buttons
Configuring a Proxy Server
Configuring a Proxy Server ........................................................................................................... 175
9
Table of Contents
Network Ports and Protocols
Network Ports and Protocols ........................................................................................................ 176
10
About This Guide
Introduction
This manual describes how to install, configure and use Workforce Connect Voice Client (WFC Voice Client) on a
Mitel network.
NOTE: Screens and windows pictured in this guide are samples and can differ from actual screens.
Chapter Descriptions
Topics covered in this guide are as follows:
• Configuring the Client, describes the steps you need to take prior to beginning to configure the device.
• Configuring the PBX, describes the steps you need to take to configure the PBX.
• Dynamic Configuration, describes the procedures to dynamically configure the WFC client using an XML
variable file.
• Settings, provides detailed information on configuring settings.
• Logging, describes the process used to capture and collect WFC Voice Client log files and Fusion log files.
• Headless Mode and WFCVoice Service, describes the procedures to configure WFC Voice client as a
background service.
• Using the Client, explains how to use the functions and features of the WFC client.
• Button Actions, includes a table listing the XML tags used to define a button action.
• XML Tags, includes a table listing all XML tags used in the WFC Voice Client configuration file and where
they are valid.
• XML Example - Profile, provides an XML example for the Profile section.
• XML Example - Footer, provides an XML example for the Footer section.
• XML Example - Dashboard, provides an XML example for the Dashboard section.
• XML Example - Call Buttons, provides an XML example for the In-Call Buttons section.
• Configuring a Proxy Server, explains how to access a license source using a proxy server.
• Network Ports and Protocols, provides an overview of the ports and protocols the WFC Voice Client uses
on supported Zebra devices.
11
Notational Conventions
The following conventions are used in this document:
• Bold text is used to highlight the following:
• Dialog box, window and screen names
• Drop-down list and list box names
• Check box and radio button names
• Icons on a screen
• Key names on a keypad
• Button names on a screen.
• Bullets (•) indicate:
• Action items
• Lists of alternatives
• Lists of required steps that are not necessarily sequential.
• Sequential lists (e.g., those that describe step-by-step procedures) appear as numbered lists.
About This Guide
Related Documents and Software
The following documents provide more information about the WFC Voice Client.
• Best Practices Guide: Deploying VoWLAN Over Aruba Wireless Networks, p/n MN002151Axx
• Best Practices Guide: Deploying VoWLAN Over Cisco Wireless Networks, p/n MN001146Axx
• Best Practices Guide: Deploying VoWLAN Over WiNG5 Wireless Networks, p/n MN001150Axx
For the latest version of this guide and all guides, go to: www.zebra.com/support
Service Information
If you have a problem with your equipment, contact Zebra Global Customer Support for your region. Contact
information is available at: www.zebra.com/support
When contacting support, please have the following information available:
• Serial number of the unit
• Model number or product name
• Software type and version number.
Zebra responds to calls by email, telephone or fax within the time limits set forth in support agreements.
If your problem cannot be solved by Zebra Customer Support, you may need to return your equipment for servicing
and will be given specific directions. Zebra is not responsible for any damages incurred during shipment if the
approved shipping container is not used. Shipping the units improperly can possibly void the warranty.
.
.
If you purchased your Zebra business product from a Zebra business partner, contact that business partner for
support.
12
Configuring the Client
Introduction
This chapter describes how to install, activate and configure the Workforce Connect Voice Client (WFC Voice
Client).
Determine Deployment Readiness
Assess the suitability of your Wireless Local Area Network (WLAN) for voice traffic, using the Best Practices Guide:
Deploying VoWLAN Over Aruba Wireless Networks, Deploying VoWLAN Over Cisco Wireless Networks or
Deploying VoWLAN Over WiNG5 Wireless Networks.
.
WARNING: If your WLAN is not suitable for voice traffic, WFC Voice Client will perform on a best effort basis.
Contact the Zebra Software Support Desk for more information: www.zebra.com/support.
Connect Android Wireless Device to Network
Zebra WFC Voice Client for Android includes support for the following device types:
• Enterprise Mobile devices
• Consumer Smartphone devices (evaluation only).
Connect the Android wireless device to the network. See device instructions for more information. If you need
assistance, contact the Zebra Support at: www.zebra.com/support
.
13
Configuring the Client
Install Workforce Connect Voice Client
There are two ways to install the WFC Voice Client:
• USB tether or web server - This section describes using a USB tether or web server to install the WFC
Voice Client APK manually or using ADB commands.
• Mobile Device Manager (MDM) - For information on installing the WFC Voice Client APK using an MDM,
refer to the Workforce Connect Voice Client Configuration Guide for Mobile Device Managers.
Download and Install Board Support Package (BSP) Operating System
For instructions please refer to www.zebra.com/support and login using your partner login for latest BSP and
integration instructions. If you need assistance, contact Zebra Support at: www.zebra.com/support
Download and Install Android Application Packager (APK) Client
1. From a web browser, go to the Zebra Licensing End User Portal.
To access the Zebra Licensing End User Portal, follow the instructions in the Software Entitlement email from
Zebra. Portal access requires registration at Zebra.com and authorization as a portal user by Zebra Support.
2. From the Zebra Licensing End User Portal, download the latest WFC Voice APK file.
.
Installing the APK Manually
To install the APK manually:
1. Save the APK file to the root directory of the target device using one of the following methods:
• USB tether
• Web server download (if your network supports this option).
2. On the Android device, go to the Apps list and open the file browser.
3. Navigate to the APK file.
4. Run and install the APK file.
5. Check that the WFC Voice Client is available in the Apps Screen.
The WF Connect icon should be visible in the list of available applications.
Installing the APK Using ADB Commands
To install the APK using an Android Debug Bridge (ADB) connection, open a command prompt and send the
following ADB commands to the device:
adb install –g <apk_file_name>
adb shell dumpsys deviceidle whitelist +com.symbol.wfc.voice
adb shell appops set com.symbol.wfc.voice SYSTEM_ALERT_WINDOW allow
Where
<apk_file_name> is the name of the WFC Voice APK file.
Create a Shortcut for the Workforce Connect Voice Client
To create a shortcut:
1. In the Apps Screen, press and hold on the WF Connect icon.
14
Configuring the Client
Press and hold WF Connect icon
Drag icon to the Home screen
Figure 1 Apps Screen
2. Drag the WF Connect Icon to the Home screen.
Figure 2 Home Screen
3. Drop icon on Home screen.
Open Workforce Connect Voice Client
To open the WFC Voice Client, use one of the following methods:
• Touch the WF Connect icon on the Home screen.
15
Configuring the Client
Touch on the WF Connect icon on
the Android Home Screen.
Touch on the WF Connect icon on
the Android Apps Screen.
Figure 3 Home Screen
• Touch on the WF Connect icon on the Apps screen.
Figure 4 App Screen
The App Activation screen displays.
Activate Workforce Connect Voice Client
When the WFC Voice Client starts for the first time, the App Activation screen appears. A valid license is required
for each PBX. The WFC Voice Client is activated by using an activation key, Mobile Device Manager (MDM), or
USB tether.
NOTE: When activating a device that does not have direct access to the license source, use a proxy server. See
Configuring a Proxy Server on page 175.
Activate Using an Activation Key
To activate the WFC Voice Client:
16
Configuring the Client
Toggle Button
Clear All Fields
1. Open the WFC Voice Client.
Figure 5 App Activation Screen
2. Use one of the following activation methods:
• Keys or features - Acquires licenses from the default licensing source.
In the keys or features field, enter your activation code(s) separated by commas.
NOTE: The WFC Voice Client version 8.2.729 requires a license source URL when activating using an activation
key. Refer to the Workforce Connect Voice Client 8.2.x Administration Guide for Licensing.
3. To enter a device alias, touch the toggle button and, in the device alias field, enter a name to identify the
device on the license source.
4. Touch Register App.
The About screen appears, displaying currently licensed keys and features.
Figure 6 About Screen
5. Touch OK.
17
Configuring the Client
Activate Using an MDM
Configuring the WFC Voice Client using an MDM requires a deployment package and the WFC Voice Client
configuration file. The configuration file
including licensing information, as key and value pairs. For detailed information on the XML configuration file, see
Settings on page 42.
Define the licensing information using the following XML tags:
• license_key - Contains one or more WFC Voice Client activation keys separated by commas.
Example:
<license_key>abcd‐1234‐ab12‐cd34‐5678‐efgh‐ef56‐gh78</license_key>
• license_source - The URL of a license source.
• WFC Voice Client version 8.2.729 - Enter the following URL:
https://zebra-licensing.flexnetoperations.com/flexnet/deviceservices.
• WFC Voice Client version 8.2.730 or later - Leave this field blank.
• license_alias - Identifies the device on the license source. (Optional)
MDM Deployment
During runtime, WFC Voice Client listens for wfc.voice.ACTION_UPDATE_CONFIG intent. When the WFC Voice
Client receives the intent from an MDM, the configuration file uses
configuration parameters. Use a single intent to update multiple configuration parameters by including multiple
element and value pairs.
WFConnect.xmlstores all WFC Voice client configuration parameters,
WFConnect.xml to update the WFC Voice Client
For detailed information on MDM deployment, refer to the Workforce Connect Voice Client 8.x Configuration Guide
for Mobile Device Managers.
Activate Using a USB Tether
Send theWFConnect.xmlconfiguration file to the device using a USB tether, use an Android Debug Bridge (ADB)
connection.
NOTE: It is not recommended to install the WFConnect.xml file using a USB tether because it can cause
permission issues on the device.
1. Install the WFC Voice Client APK. See Download and Install Android Application Packager (APK) Client on
page 14.
2. Copy the WFConnect.xml file in the /sdcard/WFConnect directory.
3. Open a command prompt and send the following adb command to the device:
adb shell am start -a "wfc.voice.ACTION_NEW_CONFIG" --es "profile_uri"
"/WFConnect/WFConnect.xml"
Update License
To update all WFC Voice Client licenses, refer to the Workforce Connect Voice Client 8.2.x Administration Guide
for Licensing.
Configure Workforce Connect Voice Client
The WFC Voice Client is configured using the Graphical User Interface (GUI), an MDM, or a USB Tether.
18
Configuring the Client
Enter Settings password.
NOTE: It is not recommended to install the WFConnect.xml file using a USB tether because it can cause
permission issues on the device.
Configure Using the WFC Voice Client GUI
To configure the WFC Voice Client:
1. Touch the menu button.
Figure 7 WFC Voice Client Menu
2. Touch Settings.
Figure 8 Enter Password Screen
3. Enter the settings password. The default password is: zamboni.
4. Touch Connection Parameters.
Figure 9 Connection Parameters
19
Configuring the Client
User ID
Password
Server Address
PBX Type
5. Select a PBX configuration. The default configuration is: PBX#1 Configuration.
For information on configuring additional PBX types, see Configuring Multiple PBX Types on page 47.
6. Touch the PBX Type field and select Mitel.
7. Enter the User ID.
8. Enter the Password.
9. Enter the PBX server address.
Figure 10 Enter Parameters
NOTE: For information on optional configuration settings, see XML Tags on page 150.
10. Touch the back button three times to return to the WFC Voice Client home screen.
Figure 11 Confirmation Message
A confirmation that the Configuration has been saved to WFConnect.xml displays.
20
Configuring the Client
Configure Using an MDM
Configuring the WFC Voice Client using an MDM requires a deployment package and the WFC Voice Client
configuration file. The configuration file
including licensing information, as key and value pairs. For detailed information on the XML configuration file, see
Settings on page 42.
Define the licensing information using the following XML tags:
• license_key - Contains one or more WFC Voice Client activation keys separated by commas.
Example:
<license_key>abcd‐1234‐ab12‐cd34‐5678‐efgh‐ef56‐gh78</license_key>
• license_source - The URL of a license source.
• WFC Voice Client version 8.2.729 - Enter the following URL:
https://zebra-licensing.flexnetoperations.com/flexnet/deviceservices.
• WFC Voice Client version 8.2.730 or later - Leave this field blank.
• license_alias - Identifies the device on the license source. (Optional)
MDM Deployment
During runtime, WFC Voice Client listens for wfc.voice.ACTION_UPDATE_CONFIG intent. When the WFC Voice
Client receives the intent from an MDM, the configuration file uses
configuration parameters. Use a single intent to update multiple configuration parameters by including multiple
element and value pairs.
WFConnect.xmlstores all WFC Voice client configuration parameters,
WFConnect.xml to update the WFC Voice Client
For detailed information on MDM deployment, refer to the Workforce Connect Voice Client 8.x Configuration Guide
for Mobile Device Managers.
Configure Using a USB Tether
To send theWFConnect.xmlconfiguration file to the device using a USB tether, use an Android Debug Bridge
(ADB) connection.
NOTE: It is not recommended to install the WFConnect.xml file using a USB tether because it can cause
permission issues on the device.
1. Install the WFC Voice Client APK. See Download and Install Android Application Packager (APK) Client on
page 14.
2. Copy the WFConnect.xml file to the WFConnect directory.
3. Open a command prompt and send the following ADB command to the device:
adb shell am start -a "wfc.voice.ACTION_NEW_CONFIG" --es "profile_uri"
"/WFConnect/WFConnect.xml"
To update a specific parameter in the
send an ADB command to the device in the following format:
$ adb shell am start -a wfc.voice.ACTION_UPDATE_CONFIG --es element value
For a list of possible elements and values, see XML Tags.
WFConnect.xml configuration file using ADB, open a command prompt and
21
Configuring the PBX
Introduction
This chapter describes how to configure the PBX.
Collect Necessary Information
Assemble the following information before you begin to configure the Mitel PBX and the mobile device:
• User ID (extension #) and Password
• Extension Number
• Server Address
Create Users
To create a user:
1. Log into System Manager web admin.
Figure 12 Login Screen
22
Configuring the PBX
2. Click Log In button.
Figure 13 Select System Administration Tool
3. Click System Administrator Tool button.
Figure 14 User and Services Configuration
4. In the left pane, click Users and Devices > User and Services Configuration.
5. Click Add button.
23
Figure 15 User Profile Tab
Configuring the PBX
6. Click User Profile tab.
7. Enter the user’s First Name and Last Name.
8. Click Service Profile tab.
Figure 16 Service Profile Tab
9. In the Device Type drop-down menu, select Generic SIP Phone.
24
Figure 17 Select Device
.
Configuring the PBX
NOTE: To enable or disable certain features, Mitel administrator may need to edit a “Class of Service” entry as
well as a “Sip device capabilities” entry. After configuring them according to the customer needs the Mitel
administrator must match the edited COS and “SIP device capabilities” as shown in the following figure.
10. Click Service Details tab and enter any required service details.
Figure 18 Service Details Tab
11. Click Keys tab. Make any necessary changes and click the Save Changes button.
25
Figure 19 Keys Tab
Configuring the PBX
26
System Feature Settings
In order to use the Call Park and Conferencing features, the administrator needs to configure Feature Access
Codes (FAC) in the Mitel PBX.
To configure Feature Access Codes:
1. From the Mitel PBX, go to System Properties > System Feature Settings > SIP Device Capabilities.
Figure 20 SIP Device Capabilities
Configuring the PBX
2. In the Basic tab > Call Routing and Administration Options, set Replace System based with Device
based In-Call Features to No.
3. Go to System Properties > System Feature Settings > Feature Access Codes.
4. Set the FAC for the desired Call Park and Conference features.
NOTE: Ensure that the FAC set in the Mitel PBX matches the FAC set in the WFC Voice Client in Settings >
Connection Parameters > PBX#1 Configuration (Mitel).
27
Figure 21 SIP Device Capabilities
Configuring the PBX
28
Check Device Settings
In order to register WFC with Mitel gateway, the admin/user needs to configure the WFC Voice Client application
with the UserID that has been set at the voice gateway.
At the device the administrator must set the User ID.
To set the User ID:
1. Touch Menu button.
2. Touch Settings.
3. Enter password and touch Enter.
4. Enter User ID, password and server address.
Figure 22 WFC Voice Client Settings
Configuring the PBX
5. Touch the Back button to return to the WFC Voice Client home screen.
29
Figure 23 Device Setup
Configuring the PBX
30
Loading...