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 TTSVOICE 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 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 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. On the Configuration page, enter your Base64 Service Account ID. This is 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.

  8. 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
    AWS Polly TTS

    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.

    Google TTS

    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.

     
    Google TTS Custom Voice

    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 voice model.

    Language: Select the language of your custom voice model.

    Custom Voice Model: Enter the name of the custom voice model you're using.

  9. 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 TTSVOICE action you include in your script.

  1. In Studio, open the script you're working with.
  2. If you haven't already added the TTSVOICE action to your script, do so now.
  3. Double-click the TTSVOICE 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.