Browse
 
Tools
Rss Categories

Cisco UCCX

Reference Number: AA-02160 Views: 166 0 Rating/ Voters

LumenVox' speech recognition and synthesis software is compatible with Cisco Unified CCX (UCCX) using the MRCP interface.

After installing the UCCX system, and confirming that it is functional, you need to configure the MRCP interface that allows the UCCX system to communicate with the LumenVox Media Server, which handles all ASR and TTS requests.


Assumptions

These instructions assume that the LumenVox server, hosting the LumenVox Media Server and ASR and/or TTS services are located on a different server than the UCCX. We strongly recommend installing LumenVox on a separate server to UCCX

The following steps also assume that you have installed (Windows Linux), configured and tested your LumenVox configuration independently of UCCX.


Preliminary Information

The following configuration document is believed to be correct when working with Cisco UCCX 8.5 through UCCX 11.6, however it is still preliminary information and subject to change.

If you discover any inaccuracies or discrepancies in this documentation, please contact Support@LumenVox.com with details, so that we may update it accordingly.


Add LumenVox as your MRCP TTS Provider

You can use the UCCX TTS Providers Configuration web page to specify LumenVox as your TTS provider. This will be used in the following step to Add the LumenVox TTS Server.

From the UCCX Administration menu bar, choose Subsystem > MRCP TTS > MRCP TTS Providers. This will open the MRCP TTS Provider Configuration web page.

Click the Add MRCP TTS Provider icon in the upper left, then specify "LumenVox" as your TTS Provider, then click Add to apply the changes and return to the previous page.

Once the MRCP TTS Provider Configuration page reopens, it should look like this:



Add the LumenVox TTS Server

Once the above step has been completed to define LumenVox as an MRCP TTS Provider, you can then add a corresponding TTS Server Configuration.

From the UCCX Administration menu bar, choose Subsystems > MRCP TTS > MRCP TTS Servers to open the configuration page.

You should assign the IP address (or hostname) of your LumenVox server to the "Server Name" field

Select "LumenVox" from the "Provider Name" dropdown list (this is the entry we created above).

"Port Number" should match that listed in your RTSP_PORT setting in your media_server.conf settings on your LumenVox Server. By default, the LumenVox value for this setting is 554, however the Cisco default value may be 4900. We recommend changing the Cisco value to match the LumenVox setting of 554, however you may change both to 4900 if preferred. Whichever value you select, these should match in both your Cisco "Port Number" field and the LumenVox "RTSP_PORT" field. This will assign the RTSP (MRCPv1) connectivity port to be used.

Select any additional language options needed, based on whichever TTS voices and language you have installed and licensed on your LumenVox TTS server, then click Update.

After this, you will be returned to the MRCP TTS Server Configuration page, which should look like this:


The corresponding RTSP_PORT setting in the LumenVox dashboard can be modified as shown here:



Select the Default Gender for TTS Provider

Use the MRCP TTS Default Gender Configuration web page to specify a default gender to use per locale, per provider. This TTS default gender setting is used whenever a prompt for a specific locale is specified without specifying the gender.

From the UCCX Administration menu bar, choose Subsystems > MRCP TTS > MRCP TTS Default Genders to open the configuration page.


Choose the default gender setting for each locale (language) that is enabled. By default, "Default Gender" is set to "Neutral" unless configured explicitly here. We recommend selecting a gender of your choice for each language.


Add LumenVox as your MRCP ASR Provider

Use the UCCX ASR Providers Configuration web page to specify LumenVox as your ASR provider. This will be used in the following step to Add the LumenVox ASR Server.

From the UCCX Administration menu bar, choose Subsystem > MRCP ASR > MRCP ASR Providers. This will open the MRCP ASR Provider Configuration web page.

Click the Add MRCP ASR Provider icon in the upper left, then specify "LumenVox" as your ASR Provider, along with the number of ASR licenses you have installed in your LumenVox system, and the Grammar Variant of "Nuance Open Speech Recognizer servers version 9.0 and above (OSR 3.1.x)", which is the closest match to the LumenVox ASR then click Add to apply the changes and return to the previous page.

Once the MRCP ASR Provider Configuration page reopens, it should look like this:



Add the LumenVox ASR Server

Once the above step has been completed to define LumenVox as an MRCP ASR Provider, you can then add a corresponding ASR Server Configuration.

From the UCCX Administration menu bar, choose Subsystems > MRCP ASR > MRCP ASR Servers to open the configuration page.

You should assign the IP address (or hostname) of your LumenVox server to the "Computer Name" field

Select "LumenVox" from the "Provider" dropdown list (this is the entry we created above).

"Port" should match that listed in your RTSP_PORT setting in your media_server.conf settings on your LumenVox Server. By default, the LumenVox value for this setting is 554, however the Cisco default value may be 4900. We recommend changing the Cisco value to match the LumenVox setting of 554, however you may change both to 4900 if preferred. Whichever value you select, these should match in both your Cisco "Port Number" field and the LumenVox "RTSP_PORT" field. This will assign the RTSP (MRCPv1) connectivity port to be used.

The corresponding RTSP_PORT setting in the LumenVox dashboard can be modified as shown here (this port number will be the same for both ASR and TTS):

Select any additional Locales (language) options needed, based on whichever ASR languages you have installed and licensed on your LumenVox server, then click Add or Update to apply these settings.

After this, you will be returned to the MRCP ASR Server Configuration page, which should list the newly created LumenVox ASR Server


Configure MRCP ASR Dialog Groups

After you have completed adding the LumenVox ASR Server (above), you can use the MRCP Groups Configuration web page to specify information about MRCP ASR dialog control groups, which enable UCCX applications to use speech recognition.

From the UCCX Administration menu bar, choose Subsystem > MRCP ASR > MRCP ASR Dialog Groups to open the configuration page.

This page will display a list of preconfigured entries, if applicable, with the following information:

  

Field

  
  

Description

  
  

Group ID

  
  

Identifier for the group.

  
  

Description

  
  

Description of this dialog group.

  
  

Provider

  
  

Name of the MRCP ASR provider.

  
  

Channels

  
  

Maximum number of sessions.

  

This page also displays the number of licensed IVR channels.

Click the Add New icon displayed in the toolbar in the upper left corner, or the Add New button at the bottom of the window to provision a new MRCP ASR Group.

The MRCP ASR Dialog Group Configuration web page will open, allowing you to configure options in the fields provided:

  

Field

  
  

Description

  
  

Group ID

  
  

Associated group ID.

  
  

Description

  
  

Description of this dialog group.

  

Tip:

  

Include languages that will be used by this Group to the description. Doing so will provide insight into the languages this Group uses when you set up the dialog group in the Unified CM Telephony trigger configuration. This also ensures that the locales used by the application configured in the Unified CM Telephony trigger match the locales supported by the MRCP ASR dialog group being selected.

  
  

Number Of Provider  Licenses

  
  

Display only.

  
  

Number Of Licensed IVR  Ports

  
  

Display only.

  
  

Maximum Number Of  Sessions

  
  

Maximum number of sessions associated with this dialog group.

  

Note:

  

You can assign any value for Maximum Number Of Channels, but restrictions are placed on the system when a call is made. This restriction is imposed by the number of licensed IVR ports on your system

  

Caution:

  

Under heavy load, calls that utilize a channel from an MRCP ASR Dialog Control Group, might have a reduced call completion rate as the MRCP channels used by calls can take some additional time to clean up all the sessions set up with MRCP resources. To address this situation, you can over-provision the value of this field by a factor of 1.2 or by an additional 20 percent. For example, if your application requires 100 MRCP ASR channels, modify the value in this field to be 120 MRCP ASR channels.

  
  

Provider Name

  
  

Select a MRCP Provider name (LumenVox) from the drop-down list that contains a list of all previously defined provider names.

  
  

Enabled Languages

  
  

Select the languages that you wish to configure for this group from the list displayed.

  

The displayed languages represent the locales configured for all MRCP ASR servers for the specified provider. If there are no MRCP ASR servers configured, no languages are displayed. In this case, you must update the group configuration once MRCP ASR servers have been configured for the specified provider.

  


Testing The Integration

Once the system has been configured, make a call into the UCCX system to test the ASR and TTS functionality to confirm that connectivity between the two systems is working correctly.


Additional Information

Please refer to the Cisco Unified CCX Administration Guide for other configuration information relating to setting up your server.