Create a generic SIP phone

Prerequisites
  • Telephony > Plugin > All permission

You can use generic SIP phones in any of Genesys Cloud’s telephony connection options: Genesys Cloud Voice, BYOC Cloud, or BYOC Premises.

After you create a generic SIP phone base settings profile, create the phone profile. The phone profile contains a group of settings on the Phone and Line Keys tabs that define the phone in Genesys Cloud. Most of the settings on the Phone and Line Keys tabs inherit the information from the base settings. However, you can customize the phone by altering any of the settings that it inherits from the base settings configuration without affecting the original base settings configuration. For more information, see Inherited settings.

Configure the phone

  1. Click Admin. 
  2. Under Telephony, click Phone Management.
  3. Click the Phones tab.
  4. Click Add.

Phone tab

Configure the settings on the Phone tab.

  1. Type a name in the Phone Name box.
  2. From the Base Settings list, select the generic phone base settings configuration you created.
  3. From the Site list, select your site. You can select either a cloud or premises site.
  4. Leave Standalone Features set to Off unless you are creating a conference room phone. See Enable standalone features.
  5. Choose one of the following steps:
    • To use the default phone settings, click Save Phone and proceed to Configure the line keys in this article.
    • To customize the phone settings, proceed to Customize the phone in this article.

Customize the phone

The base settings contain three expandable sections: General, Interface, and Custom. These sections allow you to change the phone settings for a generic SIP phone. 

To customize the phone settings:

  1. Select the appropriate settings from each expandable section.

Setting

Description

Use Secondary Registration

Configure the phone to use secondary registration.

The default for this setting is Enabled.

By default, Genesys Cloud provides the Phone Home service for provisioning information and to provide all the details for the primary generic sip registration. However, for phone redundancy, Genesys recommends that you use a secondary registration source.

After you complete your phone configuration, you can use the How to Register feature, described later in this article, to retrieve the primary and secondary registration addresses, and other details that you must manually configure on your generic SIP phone.

For more information about how to configure this information manually on your generic SIP phone, see your phone documentation.

Setting

Description

Message Waiting Indicator

Use this setting to configure the Message Waiting Indicator (MWI), the light that blinks to indicate that the user has a new voicemail.

To enable the feature, select the Message Waiting Indicator (MWI) check box.

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

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.

  1. To use the custom phone settings, click Save Phone and proceed to Configure the line keys in this article.

Configure the line keys

  1. Click the Line Keys tab.
  2. Edit the default name in the Line Appearance Id box.
    Note: Even though Genesys Cloud assigns the Line Appearance Id field a default name based on the content of the Phone Name field on the Phone tab, create your own name. The Line Appearance Id name can only contain alphanumeric characters including the special characters: _ % + – ~. Spaces between characters are not allowed.
  3. To specify the callback number to be sent when a call is made to an emergency service, type a number in the Emergency Number box.
  4. Choose one of the following steps:
    • To use the default line keys settings, click Save Phone.
    • To customize the line keys settings, proceed to Customize the line keys in this article.

Customize the line keys

The line keys section of the phone includes four expandable sections: General, Signaling, Interface, and Custom. Each expandable section contains settings that customize the Generic SIP phone. 

To customize the line keys settings, follow these steps:

  1. Select the appropriate settings from each expandable section.

Setting Description
Persistent Connection Settings

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

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

Maintain a persistent connection

To turn on the persistent connection feature, select the check box.

The default setting is not to use the persistent connection feature.

Timeout Sets the amount of time, in seconds, that the open connection can remain idle before Genesys Cloud automatically closes it.

Setting Description
Digest Authentication When outbound requests are challenged with digest authentication, Genesys Cloud uses these credentials.
User Name

By default the user name is admin, but you can change it.

Enter the user name that you want to assign to the phone. 

This user name is pushed down to the phone and becomes the user name for the administrative account on the physical phone. 

Password

By default the password is 1234, but you can change it.

Enter the password that you want to assign to the phone.

This password is pushed down to the phone and becomes the password for the administrative account on the physical phone. Genesys recommends using the Generate random password feature.

By default, the password is masked, but if you use a random password, 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 call is created between the new incoming call and the existing call. An announcement of the new call is played to the existing call before Genesys Cloud establishes the conference call.
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 Choose a Personal Identification Number (PIN) number to use to join the conference.
Language Select a language to use for the conference voice menu.

The Custom option allows Genesys Cloud Customer Care personnel to alter a phone configuration for troubleshooting or special circumstances. Only enter custom property settings when 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.

  1. To use the custom line key settings, click Save Phone.

Retrieve the primary and secondary registration information

After you complete your phone configuration, you can use the How to Register feature to retrieve the primary and secondary registration addresses and the port and transport protocol details that you must manually configure on your generic SIP phone.

For more information about how to configure this information manually on your generic SIP phone, see your phone documentation.

  1. Click Admin. 
  2. Under Telephony, click Phone Management.
  3. Click the Phones tab.
  4. Select your generic SIP phone.
  5. Click How to Register in the information panel. The Enter this information on the generic SIP phone dialog appears.
  6. Hover your mouse pointer over any item and click Click to Copy to copy that information to the clipboard.
  7. Save each copied item in a separate document, such as a text file. You can then use that information to configure on your generic SIP phone manually.