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.
|
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
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. 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:
|
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.
|
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:
|
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. |
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.
|
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
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. 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. |
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.
|
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:
|
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. |
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. |
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. |