Element  | Description  | 
|---|---|
Call Buttons  | Defines the buttons available in the in-call area.  | 
Dashboard  | Dashboard section.  | 
Profile  | Profile section.  | 
Element  | Description  | Value  | 
|---|---|---|
audio_gain_in  | Input Audio Volume (Optional).  | A number between 1 and 8. Default: 1  | 
audio_gain_out  | Output Audio Volume (Optional).  | A number between 1 and 8. Default: 1  | 
background_logo  | Set a background image for the Zebra Voice home screen dashboard (Optional).  | Default: None (Disabled)  | 
callwaiting_interval  | An interval of call waiting tone.  | 500ms to 8000ms Default: 2000ms  | 
callwaiting_volume  | Call waiting volume.  | Percentage between 10% and 100% Default: 80%  | 
clearRecentCall  | Clear the call history on sign-out.  | True: clear the recent call history on sign-out. False: retain the recent call history on sign-out. Default: False  | 
codec_alaw_priority  | Assigns preference priority for G.711 A-Law Voice codec negotiations between PBX and Zebra Voice.  |  between -5 and 5 Negative numbers disable the codec. Default: 2  | 
codec_g722_priority  | Assigns preference priority for G.722 Voice codec negotiations between PBX and Zebra Voice.  |  between -5 and 5 Negative numbers disable the codec. Default: 4  | 
codec_g729_priority  | Assigns preference priority for G.729 Voice codec negotiations between PBX and Zebra Voice.  |  between -5 and 5 Negative numbers disable the codec. Default: 3  | 
codec_gsm_priority  | Assigns preference priority for GSM Voice codec negotiations between PBX and Zebra Voice.  |  between -5 and 5 Negative numbers disable the codec. Default: 2  | 
codec_ulaw_priority  | Assigns preference priority for G.711 u-LAW Voice codec negotiations between PBX and Zebra Voice.  |  between -5 and 5 Negative numbers disable the codec. Default: 1  | 
contacts_url  | The URL of the contacts list is located on a remote or local server (Optional).  | File type: CSV. Protocols: file, http, https, tftp. Default: none  | 
default_screen  | Change the default landing screen of the Zebra Voice Client,  | Fragment Value:
                 0: Dashboard (default value) 1: Dialpad 2: Recent 3:Contact   | 
disable_menu_sign _out  | Disable the sign-out option in the three-line menu (Optional).  | True: Disable the sign-out option. False: Enable the sign-out option. Default: False  | 
disable_speaker  | Do not answer incoming calls in speaker mode when the device is placed on a horizontal surface (Optional).  | True: Disable speaker mode. False: Enable speaker mode. Default: False  | 
gbg_color  | Background color used on all buttons, if not customized in the button element <bg_color> (Optional).  | The color is one of the following: red, blue, green, black, white, gray, cyan, magenta, yellow, lightgray, darkgray, grey, lightgrey, darkgrey, aqua, fuchsia, lime, maroon, navy, olive, purple, silver, teal, or, it is an RGB value in one of the following formats expressed as a decimal, or a hexadecimal, number: 
 Default: 0xFF001425  | 
gfg_color  | The text color used on all buttons, if not customized in the button element <fg_color> (Optional).  | The color is one of the following: red, blue, green, black, white, gray, cyan, magenta, yellow, lightgray, darkgray, grey, lightgrey, darkgrey, aqua, fuchsia, lime, maroon, navy, olive, purple, silver, teal, or, it is an RGB value in one of the following formats expressed as a decimal, or a hexadecimal, number: 
 Default: 0xFFFFFFFF  | 
headless_mode  | Headless mode (Optional).   | True: Headless mode enabled. False: Headless mode disabled. Default: False  | 
help_url  | The URL of the entry point for the on-device online help (Optional).  | Default:  file:///WFConnect/help.html  | 
http_remhost  | HTTP server address.  | Default: None (Disabled)  | 
incall_widget  | Call accept style on the incoming call screen (Optional).  | Select one of the following: 
 Default: incall_gb  | 
inCallFooterOrder  |  Arrange the position of In-Call buttons: Bluetooth, Dialpad, Mute, and Speaker.  | The following icons are assigned a specific value, and the value can be arranged  in any order:
                 
  | 
jitter_max  | Maximum jitter buffer in milliseconds.  | 250 msec to 1500 msec Default: 250 msec  | 
jitter_min  | Initial jitter delay in milliseconds.  | 30 msec to 100 msec Default: 60 msec  | 
layout_location  | The URL of the buttons layout file (Optional).  | Protocols: file, http, https, tftp. Default: none  | 
license_alias  | Identify the device on the license source. (Optional)  | Device alias.  | 
license_key  | One or more Zebra Voice activation keys. When using the license_source element, license_key can be used to list one or more PBX types.  | Comma-separated list of: 
  | 
license_source  | The URL of a licensed source running on the cloud or a local network. Use the license_key element to define PBX types. If the license_key value is not set, the client requests the PBX type set in the Zebra Voice profile.  | Default: Flexera server  | 
log_file  | Enable logging for Zebra Voice (Optional).Log files are saved to the WFConnect folder on the device.  | True: Logging enabled. False: Logging disabled. Default: False  | 
log_level  | The log level for all log messages produced by Workcloud Communication (Optional).  | Select one of the following: 
 For debugging, use Verbose. Default: Error  | 
log_sipclf  | Enable logging of SIP messages. Logs are stored as a CLF file on the device in SIP Common Log Format (Optional).  | True: Log in to a file on the device. False: Do not log in to the file. Default: False  | 
moh_enabled  | Enable music on hold to play a WAV audio file when a user is placed on hold (optional).  | Default: False  | 
moh_file  | Select a custom WAV audio file to play when a user is placed on hold (optional).  | WAV file stored in the WFConnect folder Default: None  | 
no_audio_cutoff  | Disconnect a call when no audio is detected for a set interval.  | Select one of the following: 
 Default: 30  | 
process_cell_call  | Ignore all call requests from the Android dialer. Required on the device with call service.  | True: Process Android calls False: Do not process Android calls Default: False  | 
profile_type  | Primary PBX type.  | Contents: Text Default: None  | 
profile2_type  | Second PBX type (Optional).  | Contents: Text Default: None  | 
profile3_type  | Third PBX type (Optional).  | Contents: Text Default: None  | 
profile4_type  | Fourth PBX type (Optional).  | Contents: Text Default: None  | 
profname  | Profile name (Optional).For information only.  | Contents: Text Default: None  | 
prompt_file  | Name of the audio prompt file. (Optional).  | WAV file stored in the WFConnect folder Default: None  | 
ringer_off_in_charger  | Disable the ringer while the device is charging.  | true: Disable the ringer while charging False: Enable ringer while charging Default: False  | 
ringtone_callback  | Call back ringtone (Optional).  | One of the following: 
 Default: UK_Phone  | 
ringtone_external  | Ringtone for external calls (Optional).  | One of the following: 
 Default: HI_UK_Phone  | 
ringtone_intercom  | Ringtone for intercom calls (Optional).  | One of the following: 
 Default: French_Phone  | 
ringtone_line1  | The ringtone for line #1 (Optional).  | One of the following: 
 Default: Empty (The default Android ringtone is used.)  | 
ringtone_line2  | The ringtone for line #2 (Optional).  | One of the following: 
 Default: Empty (The default Android ringtone is used.)  | 
ringtone_line3  | The ringtone for line #3 (Optional).  | One of the following: 
 Default: Empty (The default Android ringtone is used.)  | 
ringtone_line4  | The ringtone for line #4 (Optional).  | One of the following: 
 Default: Empty (The default Android ringtone is used.)  | 
ringtone_line5  | The ringtone for line #5 (Optional).  | One of the following: 
 Default: Empty (The default Android ringtone is used.)  | 
ringtone_line6  | The ringtone for line #6 (Optional).  | One of the following: 
 Default: Empty (The default Android ringtone is used.)  | 
ringtone_park  | The ringtone for park (Optional).  | One of the following: 
 Default: Empty (The default Android ringtone is used.)  | 
rtp_stats  | Show Real-Time Transport Protocol (RTP) Statistics on the in-call screen (Optional).  | True: RTP statistics are shown. False: RTP statistics are not shown. Default: False  | 
sample_rate  | Audio sample rate. Selecting an audio codec overrides this setting (Optional).  | Select one of the following: 
 Default: 8000  | 
show_department_name  | Display the department name associated with an extension (Optional).  | True: Department names are shown. False: Department names are not shown. Default: False  | 
show_extension_name  | Display extensions using both the extension number and the description set in the PBX (Optional). Requires Profile Manager.  | True: Extension names are shown. False: Extension names are not shown. Default: False  | 
show_jitter_stats  | Show jitter statistics (Optional).  | True: Jitter statistics are shown in audio debugging files. False: Jitter statistics are not shown in audio debugging files. Default: False  | 
show_update_license_button  | Display the Update License button on the About page.  | True: The Update License button is shown. False: The Update License button is hidden.  | 
sign_out_in_charger  | Automatically sign out of Zebra Voice when the device begins charging (Optional).  | True: Sign out when charging begins. False: Stay signed in while charged. Default: False  | 
keep_sign_in_after_reboot  | Keep Zebra Voice signed In after reboot.  | True: Keep signed in after the device reboots. False: Keep signed out after the device reboots. Default: False  | 
sip_auto_answer  | Auto answer mode (Optional).  | True: Zebra Voice auto-answers all incoming calls. False: The user must use Workcloud Communication to answer the call. Default: False  | 
sip_http_remhost  | Primary HTTP server address. Use with primary PBX type (Optional).  | Hostname or IP address.  | 
sip_http_remhost  | HTTP server address (Optional).  | Server address Default: None  | 
sip_localport  | The primary local listening port for SIP connections. Use with primary PBX type (Optional).  | Default: 0 (OS selects available port).  | 
sip_parknum  | SIP default call park extension. Use with primary PBX type (Optional).  | Default: None  | 
sip_pbx_logo  | Identify the PBX type on the Zebra Voice home screen dashboard. Enter text or set a logo (Optional).  | Default: Displays the default text for the PBX type.  | 
sip_mac  | Primary radio MAC address of this mobile device. Use with primary PBX type (Optional).  | MAC address Default: None  | 
sip_realm  | SIP domain. Use with primary PBX type (Optional).  | Default: None  | 
sip_remhost  | Primary TFTP server address #1. Use with primary PBX type (Optional).  | Server address Default: The server address is provided by option 150 in the DHCP.  | 
sip_remhost2  | TFTP server address #2. This is a secondary address used if the primary address is not reachable. Use with primary PBX type (Optional).  | Server address Default: None  | 
sip_remhost3  | TFTP server address #3. This is a secondary address used if the primary address is not reachable. Use with primary PBX type (Optional).  | Server address Default: None  | 
sip_remport  | TFTP server remote port. Use with primary PBX type (Optional).  | Default: 5060  | 
sip_rtp_port1  | First RTP port.  | Default: 51000  | 
sip_rtp_port2  | Last RTP port.  | Default: 51025  | 
sdp_dtmf_type  | DTMF payload size in milliseconds.  | Select one of the following:
                 
 Default: 101  | 
sip_rtp_ptime  | RTP payload size in milliseconds.  | Select one of the following: 
 Default: 20  | 
sip_transport  | SIP transport type. Use with primary PBX type (Optional).  | Select one of the following: 
 Default: TCP  | 
sip_userid  | SIP user or authentication ID. Use with primary PBX type (Optional).  | Default: None  | 
sip_userpass  | SIP authentication password. Use with primary PBX type (Optional).  | Default: None  | 
sip_vmnum  | SIP voice mail extension. Use with primary PBX type (Optional).  | Default: None  | 
sip2_confnum  | SIP default conference number. Use with second PBX type (Optional).  | Default: None  | 
sip2_http_remhost  | HTTP server address. Use with second PBX type (Optional).  | Hostname or IP address.  | 
sip2_localport  | The local listening port for SIP connections. Use with second PBX type (Optional).  | Default: 5060  | 
sip2_mac  | Radio MAC address of this mobile device. Use with second PBX type (Optional).  | MAC address Default: None  | 
sip2_parknum  | SIP default call park extension. Use with second PBX type (Optional).  | Default: None  | 
sip2_realm  | SIP domain. Use with second PBX type (Optional).  | Default: None  | 
sip2_remhost  | TFTP server address #1. Use with second PBX type (Optional).  | Server address Default: The server address is provided by option 150 in the DHCP.  | 
sip2_remhost2  | TFTP server address #2. This is a secondary address used if the primary address is not reachable. Use with second PBX type (Optional).  | Server address Default: None  | 
sip2_remhost3  | TFTP server address #3. This is a secondary address used if the primary address is not reachable. Use with second PBX type (Optional).  | Server address Default: None  | 
sip2_remport  | TFTP server remote port. Use with second PBX type (Optional).  | Default: 5060  | 
sip2_transport  | SIP transport type. Use with second PBX type (Optional).  | Select one of the following: 
 Default: TCP  | 
sip2_userid  | SIP user or authentication ID.Use with second PBX type (Optional).  | Default: None  | 
sip2_userpass  | SIP authentication password. Use with second PBX type (Optional).  | Default: None  | 
sip2_vmnum  | SIP voice mail extension. Use with second PBX type (Optional).  | Default: None  | 
sip3_confnum  | SIP default conference number. Use with third PBX type (Optional).  | Default: None  | 
sip3_http_remhost  | HTTP server address. Use with third PBX type (Optional).  | Hostname or IP address.  | 
sip3_localport  | The local listening port for SIP connections. Use with third PBX type (Optional).  | Default: 5060  | 
sip3_mac  | Radio MAC address of this mobile device. Use with third PBX type (Optional).  | MAC address Default: None  | 
sip3_parknum  | SIP default call park extension. Use with third PBX type (Optional).  | Default: None  | 
sip3_realm  | SIP domain. Use with third PBX type (Optional).  | Default: None  | 
sip3_remhost  | TFTP server address #1. Use with third PBX type (Optional).  | Server address Default: The server address is provided by option 150 in the DHCP.  | 
sip3_remhost2  | TFTP server address #2. This is a secondary address used if the primary address is not reachable. Use with third PBX type (Optional).  | Server address Default: None  | 
sip3_remhost3  | TFTP server address #3. This is a secondary address used if the primary address is not reachable. Use with third PBX type (Optional).  | Server address Default: None  | 
sip3_remport  | TFTP server remote port. Use with third PBX type (Optional).  | Default: 5060  | 
sip3_transport  | SIP transport type. Use with third PBX type (Optional).  | Select one of the following: 
 Default: TCP  | 
sip3_userid  | SIP user or authentication ID.Use with third PBX type (Optional).  | Default: None  | 
sip3_userpass  | SIP authentication password. Use with third PBX type (Optional).  | Default: None  | 
sip3_vmnum  | SIP voice mail extension. Use with third PBX type (Optional).  | Default: None  | 
sip4_confnum  | SIP default conference number. Use the fourth PBX type (Optional).  | Default: None  | 
sip4_http_remhost  | HTTP server address. Use the fourth PBX type (Optional).  | Hostname or IP address.  | 
sip4_localport  | The local listening port for SIP connections. Use the fourth PBX type (Optional).  | Default: 5060  | 
sip4_mac  | Radio MAC address of this mobile device. Use with the fourth PBX type (Optional).  | MAC address Default: None  | 
sip4_parknum  | SIP default call park extension. Use with the fourth PBX type (Optional).  | Default: None  | 
sip4_realm  | SIP domain. Use with the fourth PBX type (Optional).  | Default: None  | 
sip4_remhost  | TFTP server address #1. Use with fourth PBX type (Optional).  | Server address Default: The server address is provided by option 150 in the DHCP.  | 
sip4_remhost2  | TFTP server address #2. This is a secondary address used if the primary address is not reachable. Use with the fourth PBX type (Optional).  | Server address Default: None  | 
sip4_remhost3  | TFTP server address #3. This is a secondary address used if the primary address is not reachable. Use with the fourth PBX type (Optional).  | Server address Default: None  | 
sip4_remport  | TFTP server remote port. Use with fourth PBX type (Optional).  | Default: 5060  | 
sip4_transport  | SIP transport type. Use with the fourth PBX type (Optional).  | Select one of the following: 
 Default: TCP  | 
sip4_userid  | SIP user or authentication ID. Use with the fourth PBX type (Optional).  | Default: None  | 
sip4_userpass  | SIP authentication password. Use with the fourth PBX type (Optional).  | Default: None  | 
sip4_vmnum  | SIP voice mail extension. Use with the fourth PBX type (Optional).  | Default: None  | 
speaker_on_horizontal  | Answer calls in speaker mode when the device is placed on a horizontal surface  | True: Enable speaker mode False: Disable speaker mode Default: False  | 
use_aec  | Echo Cancellation (Optional).  | True: Echo cancellation is used. False: Echo cancellation is not used. Default: False  | 
use_agc_ear  | Automatic Gain Control (AGC) on earpiece (Optional).  | True: AGC is used. False: AGC is not used. Default: False  | 
use_agc_speaker  | Automatic Gain Control (AGC) on speaker. (Optional).  | True: AGC is used. False: AGC is not used. Default: False  | 
use_noise  | Noise Reduction (Optional).  | True: Noise reduction is used. False: Noise reduction is not used.  | 
use_prox_wake_lock  | Use the Android platform default proximity WAKE LOCK (Optional).  | True: Uses the Android platform default proximity WAKE LOCK. False: Uses a workaround solution. Default: True  | 
var_location  | The URI of the shared profile is located on a remote or local server (Optional).  | Protocols: file, http, https, tftp. Default: none (Disabled)  | 
vibrate_when_ringing  | The device vibrates when a call is received (Optional).  | True: The device vibrates when a call is received. False: The device does not vibrate when a call is received. Default: False  | 
voice_announcer_check  | Announces the number or user name of an incoming call (Optional).  | True: Incoming calls are announced. False: Incoming calls are not announced. Default: False  | 
wifi_preferred  | Connect to an available Wi-Fi network. This setting only applies after the network state changes or when the client is restarted. Applicable for Zebra Voice Client earlier version of 9.0.22409, 9.0.23101, and 9.0.23102.  | True: Connect to an available Wi-Fi network. False: Only connect to the device’s default network. Default: True  | 
encrypted_password  | Allows the administrator to change the Settings password. Password is specified with MD5 encoding (Optional).  | MD5 encoded Settings password string.  | 
vpn_configuration  | The device routes Zebra Voice traffic through VPN.  | Specify one of the following values: 
  | 
sip_srtp sip2_srtp sip3_srtp sip4_srtp  | Enables Secure RTP feature for standard clients.  | Value:
                 True:  enable false: disable Default Value: False  | 
showGroup  | Displays the Zebra Voice Group when setting the value to true.  | Value:
                 false:  disable true: enable Default Value: false  | 
Element  | Description  | 
|---|---|
Columns  | The number of columns on the dashboard area.  | 
Button  | The definition of an on-screen button. See Table 5 for details.  | 
Element  | Description  | 
|---|---|
Button  | The definition of an on-screen button. See Table 5 for details.  | 
Element  | Description  | Value  | 
|---|---|---|
action  | The button action.  | This must be one of the action types listed in Button Actions. The button is not created if this string is not a valid action type.  | 
bg_color  | Button background color (optional). The profile element <gfg_color> is used if no color is defined.  | The color is one of the following: red, blue, green, black, white, gray, cyan, magenta, yellow, lightgray, darkgray, grey, lightgrey, darkgrey, aqua, fuchsia, lime, maroon, navy, olive, purple, silver, teal, or, it is an RGB value in one of the following formats expressed as a decimal, or a hexadecimal, number: 
 Default: #FF001425  | 
confirm  | After touching the button, the operator is asked to confirm the action before it is executed (optional).  | True: Confirm the action False: Do not confirm the action Default: False  | 
description  | The LIST action type uses description.  | On the LIST action type button: 
 For all other buttons, the description is optional.  | 
enabled  | Defines whether the button is available on the Zebra Voice screen (optional).  | True: The button is visible and active. False: The button is not visible. Default: True.  | 
fg_color  | Button text color (Optional). The profile element <gfg_color> is used if no color is defined.  | The color is one of the following: red, blue, green, black, white, gray, cyan, magenta, yellow, lightgray, darkgray, grey, lightgrey, darkgrey, aqua, fuchsia, lime, maroon, navy, olive, purple, silver, teal, or, it is an RGB value in one of the following formats expressed as a decimal, or a hexadecimal, number: 
 Default: #FFFFFFFF  | 
icon  | The icon that appears on the button (Optional).  | Select one of the following: 
 Default: Default  | 
title  | Button title (Optional). This text is displayed on the on-screen button. If the string contains spaces, the text displays on two lines; otherwise, all the text displays on one line. The font size adjusts depending on the text length.  | Contents: Text Default: New  | 
value  | Additional information required by the <action> element (Optional).   | For details on the values associated with each action type, see Button Actions.  | 
Button  | The definition of an on-screen button.  | N/A  |