Manage Cloud TTS Hub

Required permissions : View Scripts, Create/Edit Scripts

Manage your Cloud TTS Hub service provider in CXone. To use the service in your contact center, you need to add it to your Studio scripts.

Add a New TTS Provider Profile

You only need to add a TTS provider profile if you're using your own account with that provider. If you're using an account provided by NICE CXone, use the default profile for the provider you want to use. Default profiles don't have an Edit button and cannot be deleted.

You can use one TTS provider profile with multiple Cloud TTS actions in the same script, or in different scripts. Each action can use a different voice.

  1. In Studio, open the script you're modifying and add a Cloud TTS action, if it doesn't contain one already.
  2. Double-click the Cloud TTS action to open the Cloud Text-to-Speech page.

  3. Click Add New TTS.

    The Add Text to Speech Config page, where you can add a new TTS provider.
  4. Enter a name for this provider in the Text to Speech Config Name field.
  5. Click the Text to Speech Config Provider that you're using.
  6. Click Next.

  7. Complete the Configuration page with the information required to authenticate your account with the TTS provider you chose. This information is different for each provider.

    Provider Required Information
    Access Key

    Enter your AWS Polly access key. Create your access keyAn icon of a square with an arrow pointing from the center out to the upper right corner. in AWS.

    Secret Key

    Enter the secret key for your AWS Polly account.
    Region Enter the region for your AWS Polly. For example, us-east-2.
    Engine Select which Polly TTS engine you're using, Standard or Neural.
    Language Select the language you want this profile to use.
    Provider Required Information
    Base64 Service Account

    Enter the ID for your service account in base64 format. The description under this field on the Configuration page includes a link to a converter you can use to convert your ID to base64.

     
    Use Custom Voice

    Select this option to use a custom Google TTS voice model.

    Note: Google Custom Voice TTS is only available for use with Google accounts that are directly billed to your organization (BYO TTS). It is not available if your organization is billed through the NICE CXone Google account (OEM service account).
    Language Select the language of your custom voice model. This option appears only when  Use Custom Voice is enabled.
    Custom Voice Model Enter the name of the custom voice model you're using. This option appears only when  Use Custom Voice is enabled.
  8. Click Add.

Assign a TTS Provider Profile to a TTSVOICE Action

When you want to use TTS in your script, you need to assign a provider to each Cloud TTSaction you include in your script.

  1. In Studio, open the script you're working with.
  2. If you haven't already added the Cloud TTS action to your script, do so now.
  3. Double-click the Cloud TTS action to open the Cloud Text-to-Speech page.
  4. Click to select a TTS provider from the list on the left side of the page.

  5. Scroll through the list of voices and select the language and voice that you want this action to use.

    The Select a Voice page, where you can choose a voice from the ones the selected provider offers.
  6. Test the selected voice by entering text in the Text to Speak field and clicking the speaker icon next to the voice you're testing.
  7. When you are satisfied with the voice you've chosen, click OK to save your selection to the action's properties.

Use SSML to Modify the TTS Voice

Speech Synthesis Markup Language (SSML) allows you to modify a TTS voice. You can use it in your Studio script.

  1. Write the speech synthesis modifications that you want to apply to your selected TTS voice. Use SSML markup.
  2. In Studio, open the script you want to modify.
  3. Locate the TTSVOICE action and place a SNIPPET action and a PLAY action after it. Connect them. If the script already has a SNIPPET action in this location, you can use the existing instance.

  4. In the SNIPPET action, add a line for a variable assignment. Set the variable value to be the SSML markup you wrote. For example:

    ASSIGN playSSML = "[SSML markup]"

  5. Configure the Play action's Sequence property with the name of the variable you added to the SNIPPET action. Include a percent sign ( % ) as a string reference character before the variable name to identify the value of the variable as text. Enclose the string reference character and variable name in double quotes. Enclose the variable name in curly brackets. For example: "%{playSSML}".

Test Your TTS Service

You can test your TTSClosed Allows users to enter recorded prompts as text and use a computer-generated voice to speak the content. service after adding a TTS provider profile to the Cloud Text-to-Speech page.

  1. In Studio, open the script you're modifying and add a TTSVOICE action, if it doesn't contain one already.
  2. Double-click the TTSVOICE action to open the Cloud Text-to-Speech page.
  3. Select your Cloud TTS Hub provider profile in the list on the left.

  4. In the Text to Speak field, enter the text you want to hear the TTS service speak.

    The page where you can test your TTS service and try different voices, languages, and genders.
  5. Select at least one Language and Gender to filter the list of available voices.
  6. Click the language you want to read the provided text and click the speaker icon.
  7. Repeat as needed. Before you leave the page, select the voice you want to be the default voice for this TTS service. This is the voice used if no voice is specified in the properties of the TTSVOICE action in your Studio script.

View TTS Audit Log Data

You can view audit log data for every Cloud TTS Hub provider profile. The audit log shows you a history of the changes made to the profile. It records the action taken with the profile, such as creating or modifying it. It also shows the date the change happened, the name of the affected profile, and the user who made the change.

When a profile is deleted, the audit log data is stored for 30 days. After that time, they are automatically deleted. You can create another profile with the same name as one you previously deleted. Its audit log history is maintained separately and is not affected by the auto-deletion of the old profile's data.

  1. In Studio, open the script you're modifying and add a TTSVOICE action, if it doesn't contain one already.
  2. Double-click the TTSVOICE action to open the Cloud Text-to-Speech page.
  3. Click the history icon Clock hands pointing to 5:00 with a circular arrow pointing counterclockwise around them. next to the profile you want to view. The Change History page appears and displays the available audit log data.