Polycom VVX 500 settings

This reference describes all the settings associated with the Polycom VVX 500 phone.

For information on creating the actual phone configuration in Genesys Cloud, see Create the base settings and Create a phone.


Base settings

Before you create a phone, create a Base Settings configuration for that phone model. The Base Settings configuration contains a group of settings that define how a particular phone model operates in Genesys Cloud. After you create a Base Settings configuration, assign it to a phone with the default settings or customize the settings. This section describes the settings that you can configure when you choose to customize a Base Settings configuration.

Menu: Telephony / Phone Management / Base Settings / Create-Edit Base Settings

Tab: Base Phone

Section: Phone Configuration

Setting Description
Dynamic Reload

Enabled (Default): Allow the dynamic reloading of the phone configuration.

Disabled: Do not allow dynamic reloading.

Persist User Settings

Enabled (Default): Persist those users settings that are configured via a web-based interface or from the Telephone User Interface/LCD on the phone.

Disabled: Do not persist user settings.

Enhanced 911

For more information, see Configure HTTP Enabled Location Delivery (HELD) for E911.

Use HTTP-Enabled Location Delivery (HELD)

Select this check box to enable the phone to share location information with responders when dialing 911.

Emergency Routing Service Account Identifier

Enter the Emergency Routing Service Account Identifier you received from your emergency service provider.

Location Information Server URL

Enter the Location Information Server URL you received from your emergency service provider.

Emergency Numbers

Enter the the numbers the phone will recognize as emergency numbers. 

The default is 911.

Web/TUI Authentication

Password

Set up an administrative password to configure the phone from a web-based interface or from the Telephone User Interface/LCD on the phone. By default the password is masked, but you can select the Show Password check box to see the password in plain-text.
Time Settings  
Timezone Discovery

Disabled (Default): Allows manually setting the timezone difference.

Enabled: Automatically sets the timezone for the phone based on the timezone of the DHCP server.

SNTP Server Sets the name of the Simple Network Time Protocol (SNTP) server from which the phone obtains the current time.
GMT Offset

Sets the number of hours to offset the time of the phone from GMT.

Note: When you use the Daylight Saving Time setting, calculate the GMT offset based on the standard timezone.

Daylight Saving Time

Enabled (Default): Allows Daylight Savings Time (DST) to display on the phone. Use the Start and End fields (Week, Day, Month, and Time) to specify the period that DST is in effect. 

Disabled: Do not display DST on the phone.

Setting Description
DSCP

Use the list to choose the Differentiated Services Code Point (DSCP) value of Quality of Service (QoS) for RTP packets.

The system places this value in the upper 6 bits of the TOS (Type Of Service) field. The TOS field is in the IP header of every RTP packet. The range of values available is 00 (0,000000) through 3F (63, 111111). 

RTP Audio Port Start Range  Defines the UDP port of the remote computer where the system sends the recorded packets. The valid range is 1024–65,535. The default port is 16384.
Preferred Codec List Use the list to select and build a list of preferred media codecs in mime format. Use the arrows next to the codec name to change the order in which the codecs in the list are used.
DTMF Settings  
DTMF Payload

Specify the payload type value to use when the DTMF Method type is RTP Events. Valid range is 96–127.

Valid only when DTMF Method value is set to RTP Events. The default value is 101.

DTMF Method

Use the list to select the method to use to transmit dual-tone multifrequency (DTMF) signaling.

Select RTP Events to enable out-of-band processing of events from the RTP stream (RFC 4733).

Select In-band Audio for the processing, detection, and synthesis from the audio codec stream.

The default value is RTP Events.

Setting Description
Provisioning
Provision Source

Use the Provision Source list to select the source that the phone uses to obtain the provision configuration data.

  • From the Genesys Cloud provisioning service - Configure the phone to obtain provision configuration data from the Genesys Cloud provisioning service.
  • From Edges within the Site - Configure the phone to obtain provision configuration data from an Edge on your site.
  • From a third party URI - Configure the phone to obtain provision configuration data from a third-party URI.
Provisioning Third Party URI

When you select From a third party URI in the Provision list, this box is enabled.

Enter the URI to the third-party resource that the phone uses to obtain provision configuration data.

TLS Authority ID

Specify the trusted certificate authority to validate connections when using TLS.

Custom Configuration Files

Allows specifying a location for a custom configuration file containing additional provisioning information for phones. The information in a custom configuration file is appended to the provisioning information already passed to the phone. The content and format of a custom configuration file is the administrator's responsibility. The Custom Configuration Files field just allows you to point to the file's location.

For more information, see Working with Configuration Files in the Poly Documentation Library.

Note: Attributes defined in the custom configuration file cannot be used to override attributes previously defined by the standard configuration file.

Custom Directory

Specify a corporate directory file containing contact information for people in your company. For more information, see the Corporate Directory page in the Poly Documentation Library.

Hostname Format

Note: This setting only applies to the following Poly / Polycom VVX phones
  • VVX 150, 250, 350 and 450 business IP phones.
  • VVX 101, 201, 301, 311, 401, 411, 501 and 601 business media phones.

If you have a Poly VVX phone that was manufactured after June of 2022, then you must select the Use RFC 1035 compliant format setting. If you have a Poly VVX phone that was manufactured before June of 2022, then you you can select either the Use RFC compliant format or Use legacy format.

Fore more information, see Choose a hostname format for VVX phones.

Signaling
Differentiated Services Code Point (DSCP)

Use the list to choose the DSCP value of Quality of Service (QoS) for SIP packets.

The system places this value in the upper 6 bits of the TOS (Type Of Service) field. The TOS field is in the IP header of every SIP packet. The range of values available is 00 (0,000000) through 3F (63, 111111). 

TCP Keep-Alive Messages

Use this setting to configure the sending of keepalive messages between the Edge/Genesys Cloud and the phone. Keepalive messages are probe packets that contain no data but have the ACK flag turned on; forcing the phone to respond.

Disabled (default): Disables the sending of keepalive messages.
Enabled: Periodically send the phone keepalive messages.

When you enable the TCP Keep-Alive Messages, set the number of seconds in the Every box to specify how often you want the Edge/Genesys Cloud to send keepalive messages. The default is every 30 seconds. The valid range is 10-7,200.

Note: Setting a keep-alive timer generates extra network traffic.

Strict User Validation

Use this feature to control how the phone handles incoming calls and to strengthen the security of the phone.

To enable the feature, select the Phone only accepts SIP INVITE requests from Genesys registration servers option.

After this this setting is enabled, the phone will ignore any SIP messages that do not come from the Genesys SIP servers to which the phone is registered.

Warning: Enabling this setting could interfere with remote site survivability configurations. More specifically, do not enable this setting if your phones connect to an external device for site survivability.

The Do not validate SIP requests to the phone disables this feature and is the default setting.

Setting Description
Phone Display Language

Use this feature to set the language for the physical phone display.

English - United States (en-US) is the default.

Select any language from the list.

Notes:
  • This setting does not apply to CCX phones.
  • This setting applies only to VVX phones that provide support for languages.

Message Waiting Indicator (MWI)

Use this feature to configure the Message Waiting Indicator, the light that blinks to indicate that the user has a new voicemail.

Enabled (default): Enables the MWI light.

Disabled: Disables the MWI light.

For more information, see Configure the Message Waiting Indicator setting.

Do Not Disturb (DND) Sync

Disabled (default): Disables Do Not Disturb synchronization between Edge and the phone.

Enabled: Enables DND synchronization between Edge and the phone.

Setting Description
System Logging (Syslog)

Use the toggle to enable or disable a phone's ability to log data.

Disabled (Default): Do not log data.

Enabled: Log data to either an Edge or a Syslog Server.

Note: When you enable this setting, you must also enable Phone System Logging in the Diagnostic>Phone System Logging section of the Phone Trunk Connection Configuration. See Create a SIP phone connection trunk.

Send Syslogs to Edges

Configure the phone to send data to an Edge.

Note: When you choose this option, the Send Syslogs to Syslog Server setting is disabled. However, you must set the Syslog Port Number to either the default port number (514) or to the port number specified in the Diagnostic>Phone System Logging section of the Phone Trunk Connection Configuration.

Send Syslogs to Syslog Server

Configure the phone to send data to a Syslog Server.

Note: When you choose this option, you must specify both the Syslog Server Address and the Syslog Port Number.

Syslog Server Address Specify the address of the server to which you want to send the logs.
Syslog Server Port  Specify the port number on the server that is configured to receive the logs.

Trace Levels

Severity level settings for each option are as follows:

  • Fatal error: The tracing shows those errors that immediately cause the system to crash.
  • Major error: The tracing shows those errors that could disable the system.
  • Minor error: The tracing shows only those errors from which the system recovers gracefully.
  • Low detail class event: The tracing includes the lowest amount detail about the class of event that you selected.
  • Moderate detail class event: The tracing includes a medium amount of detail about the class of event that you selected.
  • High detail class event: The tracing includes significant detail about the class of event that you selected.
  • Debug: The highest level of tracing available.
Application Sets the tracing level for the Application syslog topic.
Configuration Sets the tracing level for the Configuration syslog topic.
Micro Browser Sets the tracing level for the Micro Browser syslog topic.
Copy Sets the tracing level for the Copy syslog topic.
Curl Sets the tracing level for the CURL syslog topic.
Key Sets the tracing level for the Key syslog topic.
SIP Sets the tracing level for the SIP syslog topic.
Support Objects Sets the tracing level for the Support Objects syslog topic.
TLS Sets the tracing level for the TLS syslog topic.
Wapp Mgr Sets the tracing level for the Wapp Mgr syslog topic.
The Custom option allows Genesys Cloud Customer Care personnel to alter a phone configuration for troubleshooting or special circumstances. Only enter custom property settings as directed by Genesys Cloud Customer Care.
Setting Description
Property Name The name to assign to the custom property.
Data Type  The data type for the custom property.
Value The value to assign the custom property.

Tab: Base Line Appearance

Section: Configuration

Setting Description
Calls Per Line The number of calls that this line can handle.
Persistent Connection Settings

When the persistent connection feature is disabled, Genesys Cloud creates a connection for every call.

When you enable the persistent connection feature and set a timeout value, you improve Genesys Cloud’s ability to process subsequent calls. More specifically, calls that come in while the connection is still active are immediately alerted via the UI or are auto answered if the Auto Answer feature is configured for the user.

Enable Persistent Connection

Disabled (Default): Do not use persistent connection feature.

Enabled: Turn on persistent connection feature.

Persistent Connection Timeout Sets the amount of time, in seconds, that the open connection remains idle before being automatically closed.
Setting Description
Protocol Use the list to select the SIP protocol the phone uses to register: UDP, TCP, or TLS. The default is UDP.
Listen Port  Defines the local SIP listen port for SIP messages. The listening ports are the network ports on which the station expects to receive messages from SIP peers. While you can enter a custom port number, each protocol has a default listen port.
Registration period The periodic delay (in seconds) between sending a SIP REGISTER).
Max Bindings Specifies the maximum number of bindings.
SIP Servers or Proxies

The SIP Servers or Proxies setting is not configurable for the first line appearance to ensure that Genesys Cloud sends all outbound requests to the Edge. More specifically, this default configuration for the first line appearance ensures that the phone uses the Edge for the default call control.

As long as you did not enable the Span appearance to remaining keys setting, you can choose to define where Genesys Cloud sends outbound requests for the remaining Line Keys. You can choose the Edge or specify custom SIP server or proxy server addresses and ports.

Use Edge Send all outbound requests to the Edge.
Use the following Use the Hostname or IP Address and Port fields to construct a prioritized list of SIP servers or proxy servers to use to process outbound requests. Use the + to add the server to the list. Use the arrows next to the address name to change the order in which the servers in the list are used.
Digest Authentication When outbound requests are challenged with digest authentication, use the following credentials:
User Name The user name pushed down to the phone that changes the password on the administrative account for the physical phone menus.
Password The password pushed down to the phone that changes the password on the administrative account for the physical phone menus. By default the password is masked, but you can select the Show Password check box to see the password in plain-text.
Setting Description
Auto-Conference Settings When this setting is enabled, and if a call is already connected or held at the station, a conference is created between the new incoming call and the existing call. An announcement of the new call is played to the existing call before the conference is established.
Enable Auto-Conference

Off (Default): Do not use auto-conference settings.

On: Use the following fields to specify the auto-conference settings.

Auto-Conference PIN Number required to join a conference.
Language Speech language selected to use for the conference voice menu.

Phone settings

When you create a phone and assign to it a base settings configuration, the phone is ready for use in Genesys Cloud. However, if you want, you can override the inherited base settings and customize the settings for a specific phone. This section describes the settings that you can configure when you choose to customize a specific phone. 

Menu: Telephony / Phone Management / Phones / Create-Edit Phone

Tab: Phone

Section: Phone Configuration

Setting Description
Dynamic Reload

Enabled (Default): Allow the dynamic reloading of the phone configuration.

Disabled: Do not allow dynamic reloading.

Persist User Settings

Enabled (Default): Persist those users settings that are configured via a web-based interface or from the Telephone User Interface/LCD on the phone.

Disabled: Do not persist user settings.

Web/TUI Authentication

Set up an administrative password for configuring the phone from a web-based interface or from the Telephone User Interface/LCD on the phone. By default the password is masked, but you can select the Show Password check box to see the password in plain-text.
Time Settings  
Timezone Discovery

Disabled (Default): Allows manually setting the timezone difference.

Enabled: Automatically sets the timezone for the phone based on the timezone of the DHCP server.

SNTP Server Sets the name of the Simple Network Time Protocol (SNTP) server from which the phone obtains the current time.
GMT Offset

Sets the number of hours to offset the time of the phone from GMT.

Note: When you use the Daylight Saving Time setting, you should calculate the GMT offset based on the standard timezone.

Daylight Saving Time

Enabled (Default): Allows Daylight Savings Time (DST) to display on the phone. Use the Start and End fields to specify the period that DST is in effect. 

Disabled: Do not display DST on the phone.

Setting Description
DSCP

Use the list to choose the Differentiated Services Code Point (DSCP) value of Quality of Service (QoS) for RTP packets.

The system places this value in the upper 6 bits of the TOS (Type Of Service) field. The TOS field is in the IP header of every RTP packet. The range of values available is 00 (0,000000) through 3F (63, 111111). 

RTP Audio Port Start Range  Defines the UDP port of the remote computer where the system sends the recorded packets. The valid range is 1024–65,535. The default port is 16384.
Preferred Codec List Use the list to select and build a list of preferred media codecs in mime format.
DTMF Settings  
DTMF Payload

Specify the payload type value to use when the DTMF Method type is RTP Events. Valid range is 96–127.

Valid only when DTMF Method value is set to RTP Events. The default value is 101.

DTMF Method

Use the list to select the method to use to transmit dual-tone multifrequency (DTMF) signaling.

Select RTP Events to enable out-of-band processing of events from the RTP stream (RFC 4733).

Select In-band Audio for the processing, detection, and synthesis from the audio codec stream.

The default value is RTP Events.

Setting Description
Provisioning
Provisioning Source

Use the Provision Source list to select the source that the phone uses to obtain the provision configuration data.

  • From the Genesys Cloud provisioning service - Configure the phone to obtain provision configuration data from the Genesys Cloud provisioning service.
  • From Edges within the Site - Configure the phone to obtain provision configuration data from an Edge on your site.
  • From a third party URI - Configure the phone to obtain provision configuration data from a third-party URI.
Provisioning Third Party URI

When you select From a third party URI in the Provision list, this box is enabled.

Enter the URI to the third-party resource that the phone uses to obtain provision configuration data.

TLS Authority ID

Specify the trusted certificate authority to validate connections when using TLS.

Custom Configuration Files

Allows specifying a location for a custom configuration file containing additional provisioning information for phones. The information in a custom configuration file is appended to the provisioning information already passed to the phone. The content and format of a custom configuration file is the administrator's responsibility. The Custom Configuration Files field just allows you to point to the file's location.

For more information, see Working with Configuration Files in the Poly Documentation Library.

Note: Attributes defined in the custom configuration file cannot be used to override attributes previously defined by the standard configuration file.

Custom Directory Specify a corporate directory file containing contact information for people in your company. For more information, see the Corporate Directory page in the Poly Documentation Library.
Hostname Format

Note: This setting only applies to the following Poly / Polycom VVX phones
  • VVX 150, 250, 350 and 450 business IP phones.
  • VVX 101, 201, 301, 311, 401, 411, 501 and 601 business media phones.

If you have a Poly VVX phone that was manufactured after June of 2022, then you must select the Use RFC 1035 compliant format setting. If you have a Poly VVX phone that was manufactured before June of 2022, then you you can select either the Use RFC compliant format or Use legacy format.

Fore more information, see Choose a hostname format for VVX phones.

Signaling
DSCP

Use the list to choose the Differentiated Services Code Point (DSCP) value of Quality of Service (QoS) for SIP packets.

The system places this value in the upper 6 bits of the TOS (Type Of Service) field. The TOS field is in the IP header of every SIP packet. The range of values available is 00 (0,000000) through 3F (63, 111111). 

TCP Keep-Alive Messages

Use this setting to configure the sending of keepalive messages between the Edge/Genesys Cloud and the phone. Keepalive messages are probe packets that contain no data but have the ACK flag turned on; forcing the phone to respond.

Disabled (default): Disables the sending of keepalive messages.
Enabled: Periodically send the phone keepalive messages.

When you enable the TCP Keep-Alive Messages, set the number of seconds in the Every box to specify how often you want the Edge/Genesys Cloud to send keepalive messages. The default is every 30 seconds. The valid range is 10-7,200.

Note: Setting a keep-alive timer generates extra network traffic.

Strict User Validation

Use this feature to control how the phone handles incoming calls and to strengthen the security of the phone.

To enable the feature, select the Phone only accepts SIP INVITE requests from Genesys registration servers option.

After this this setting is enabled, the phone will ignore any SIP messages that do not come from the Genesys SIP servers to which the phone is registered.

Warning: Enabling this setting could interfere with remote site survivability configurations. More specifically, do not enable this setting if your phones connect to an external device for site survivability.

The Do not validate SIP requests to the phone disables this feature and is the default setting.

Setting Description
Phone Display Language

Use this feature to set the language for the physical phone display.

English - United States (en-US) is the default.

Select any language from the list.

Notes:

This setting does not apply to CCX phones.
This setting applies only to VVX phones that provide support for languages.

Message Waiting Indicator (MWI)

Use this feature to configure the Message Waiting Indicator, the light that blinks to indicate that the user has a new voicemail.

Enabled (default): Enables the MWI light.

Disabled: Disables the MWI light.

For more information, see Configure the Message Waiting Indicator setting.

Do Not Disturb (DND) Sync

Disabled (default): Disables Do Not Disturb (DND) synchronization between Edge and the phone.

Enabled: Enables DND synchronization between Edge and the phone.

Setting Description
System Logging (Syslog)

Use the toggle to enable or disable a phone's ability to log data.

Disabled (Default): Do not log data.

Enabled: Log data to either an Edge or a Syslog Server.

Note: When you enable this setting, you must also enable Phone System Logging in the Diagnostic>Phone System Logging section of the Phone Trunk Connection Configuration. For more information, see Create a SIP phone connection trunk.

Send Syslogs to Edges

Configure the phone to send data to an Edge.

Note: When you choose this option, the Send Syslogs to Syslog Server setting is disabled. However, you must set the Syslog Port Number to either the default port number (514) or to the port number specified in the Diagnostic>Phone System Logging section of the Phone Trunk Connection Configuration.

Send Syslogs to Syslog Server

Configure the phone to send data to a Syslog Server.

Note: When you choose this option, you must specify both the Syslog Server Address and the Syslog Port Number.

Syslog Server Address Specify the address of the server to which you want to send the logs.
Syslog Server Port  Specify the port number on the server that is configured to receive the logs.

Trace Levels

Severity level settings for each option are as follows:

  • Fatal error: The tracing shows those errors that immediately cause the system to crash.
  • Major error: The tracing shows those errors that could disable the system.
  • Minor error: The tracing shows only those errors from which the system recovers gracefully.
  • Low detail class event: The tracing includes the lowest amount detail about the class of event that you selected.
  • Moderate detail class event: The tracing includes a medium amount of detail about the class of event that you selected.
  • High detail class event: The tracing includes significant detail about the class of event that you selected.
  • Debug: The highest level of tracing available.
Application Sets the tracing level for the Application syslog topic.
Configuration Sets the tracing level for the Configuration syslog topic.
Micro Browser Sets the tracing level for the Micro Browser syslog topic.
Copy Sets the tracing level for the Copy syslog topic.
Curl Sets the tracing level for the CURL syslog topic.
Key Sets the tracing level for the Key syslog topic.
SIP Sets the tracing level for the SIP syslog topic.
Support Objects Sets the tracing level for the Support Objects syslog topic.
TLS Sets the tracing level for the TLS syslog topic.
Wapp Mgr Sets the tracing level for the Wapp Mgr syslog topic.
The Custom option is designed to allow Genesys Cloud Customer Care personnel to alter a phone configuration for troubleshooting or special circumstances. Only enter custom property settings as directed by Genesys Cloud Customer Care.
Setting Description
Property Name The name to assign to the custom property.
Data Type  The data type for the custom property.
Value The value to assign the custom property.

Tab: Line Keys

Section: Configuration

Setting Description
Calls Per Line The number of calls that this line can handle.
Persistent Connection Settings

When the persistent connection feature is disabled, Genesys Cloud must create a connection for every call.

When you enable the persistent connection feature and set a timeout value, you improve Genesys Cloud’s ability to process subsequent calls. More specifically, calls that come in while the connection is still active are immediately alerted via the UI or are auto answered if the Auto Answer feature is configured for the user.

Enable Persistent Connection

Disabled (Default): Do not use persistent connection feature.

Enabled: Turn on persistent connection feature.

Persistent Connection Timeout Sets the amount of time, in seconds, that the open connection can remain idle before being automatically closed.
Setting Description
Protocol Use the list to select the SIP protocol the phone uses to register: UDP, TCP, or TLS. The default is UDP.
Listen Port  Defines the local SIP listen port for SIP messages. The listening ports are the network ports on which the station expects to receive messages from SIP peers. While you can enter a custom port number, each protocol has a default listen port.
Registration period The periodic delay (in seconds) between sending a SIP REGISTER).
Max Bindings Specifies the maximum number of bindings.
SIP Servers or Proxies

The SIP Servers or Proxies setting is not configurable for the first line appearance to ensure that Genesys Cloud sends all outbound requests to the Edge. More specifically, this default configuration for the first line appearance ensures that the phone uses the Edge for the default call control.

As long as you did not enable the Span appearance to remaining keys setting, you can choose to define where Genesys Cloud sends outbound requests for the remaining Line Keys. You can choose the Edge or specify custom SIP server or proxy server addresses and ports.

Send all outbound requests to the Edge.
Use the following Use the Hostname or IP Address and Port fields to construct a prioritized list of SIP servers or proxy servers to use to process outbound requests. Use the + to add the server to the list. Use the arrows next to the address name to change the order in which the servers in the list are used.
Digest Authentication When outbound requests are challenged with digest authentication, use the following credentials:
User Name The user name pushed down to the phone that changes the password on the administrative account for the physical phone menus.
Password The password pushed down to the phone that changes the password on the administrative account for the physical phone menus. By default the password is masked, but you can select the Show Password check box to see the password in plain-text.
Setting Description
Auto-Conference Settings
Enable Auto-Conference

Off (Default): Do not use auto-conference settings.

On: Use the following fields to specify the auto-conference settings.

Auto-Conference PIN Number required to join a conference.
Language Speech selected to use for the conference voice menu.
The Custom option is designed to allow Genesys Cloud Customer Care personnel to alter a phone configuration for troubleshooting or special circumstances. Only enter custom property settings as directed by Genesys Cloud Customer Care.
Setting Description
Property Name The name to assign to the custom property.
Data Type  The data type for the custom property.
Value The value to assign the custom property.