Manage Prompts

A prompt is a message that plays for the contact. Prompts can ask the contact to input information or convey information without asking for input. Prompts can be played by auto-attendants, interactive voice response (IVR Automated phone menu that allows callers to interact through voice commands, key inputs, or both, to obtain information, route an inbound voice call, or both.) systems, and other voice processing tools. In CXone, prompts can be prerecorded audio files or text that's read by a text-to-speech (TTS Allows users to enter recorded prompts as text and use a computer-generated voice to speak the content.) service.

Create a TTS Prompt

Required permissions: Applications > Studio > Scripts Create/Edit , Applications > Studio > Prompts > Record (to record an audio file in Studio)

You can add a TTS Allows users to enter recorded prompts as text and use a computer-generated voice to speak the content. prompt using the sequence editor or by entering the prompt directly to the Sequence property of a Studio action that supports prompts. These actions include:

• Play : Plays custom audio WAV files or text-to-speech (TTS Allows users to enter recorded prompts as text and use a computer-generated voice to speak the content.) prompts. The entire file is played. Only the contact can hear the audio.
• Reqagent: Plays custom audio WAV files or text-to-speech prompt that only the agent hears. The prompt plays before the agent and the contact are linked, so the prompt doesn't cause the contact to hear silence.
• Whisper: Plays custom WAV files or text-to-speech prompts. You can set it to be audible by the contact only, the agent only, or both. The prompt plays after the agent and the contact are linked, so if the action plays for only the agent or the contact, the other party hears silence for the duration of the prompt.

1. Add a Voiceparams action to your script somewhere before the action that supports TTS Allows users to enter recorded prompts as text and use a computer-generated voice to speak the content.. If the properties set by the TTS-supporting action will be passed to other scripts, you may want to also place a Voiceparams action in the sub-scripts to ensure that those properties are not ignored.

2. In the properties of the Voiceparams action, click the drop-down in the TTSVoice field and select the language and voice that you want to speak the prompt.
3. Create the prompt using the sequence editor or typing it into the Sequence property.
4. Type the text of the prompt in the Phrase field without formatting. This allows you to see the entire prompt in one place, instead of broken into segments in the Sequence field. Content in the Phrase field is for your benefit only. The prompt doesn't speak this text.
5. Click Apply to save the prompt to the selected action.

Create a TTS Prompt in the Sequence Editor

The sequence editor allows you to create a TTS prompt using an interface that adds the formatting for you. When you use the sequence editor, you add sequences A segment of an audio prompt played for the contact. to the Sequence field. Each numbered item that appears in the field is a sequence. These items appear when you click a Play option on the left side of the editor window, such as Play a Date or Synthesize Text.

Each sequence has a limit of 300 characters. You can add additional sequences if the text you need to play is longer than that amount. For example, if you need to play text that's 540 characters long, you can add two Text to Speech sequences with the text split between them.

1. In Studio, open or create a script. If necessary, add an action that supports prompts, such as Menu.
2. Double-click the action you want to add a prompt to.

3. In the Sequence Editor window, click Synthesize Text. Default text appears in the Sequence and Sequence Value fields. The default text for Synthesize Text is The little brown fox.

   View image

   

4. In the Sequence Value field, delete the default value, then enter the value you want for the prompt. For example, you would delete The little brown fox and add Thank you for calling Classics, Inc. We're here to help you read more.

5. If you are including money, dates, time, or text that you want spelled out letter by letter, such as the contact's name, use the other sequence options in the Sequence Editor.

   Learn about the fields in this step

   Sequence Type	Details
   Play a Date	Click to add text that you want spoken as a date in your prompt. Enter the date in the Sequence Value field. The default text is 1/23/2006. Supported formats: mm-dd-yyyy mm/dd/yyyy Day of Week, Day Month Day of Week, Month Day Examples and how they're read: 1-23-2006: Monday January twenty third two thousand six 1/23/2006: Monday January twenty third two thousand six Tuesday, 10 May: Tuesday tenth of May Tuesday, May 10: Tuesday May tenth Note: Date formats differ by language and country. Use the format that your contacts will recognize and understand.
   Play Letters	Click to add text to your prompt that you want spelled out letter by letter. Enter the text to spell out in the Sequence Value field. The default text is ABC. Example: 2 May 2022 12:04:00 AM Read as: two M A Y two zero two two one two colon zero four colon zero zero A M You can also have text spelled out by using a <spell> </spell> tag in a Synthesize Text sequence. For example:  "%I have your name as <spell>{Name}</spell>. If this is correct, press 1, otherwise press 2"
   Play Money	Click to add text that you want spoken as money in your prompt. Enter the amount of money in the Sequence Value field. The default text is 543.21. Example: 3.50 Read as: Three dollars and fifty cents
   Play Numbers	Click to add text that you want spoken as numbers in your prompt. Enter the numbers in the Sequence Value field. The default text is 12345. Example: 42 Read as: Forty two
   Play Time	Click to add text that you want spoken as a time in your prompt. Enter the time in the Sequence Value field. The default text is 12:34 PM. Supported formats: hh:mm hh:mm:ss Examples and how they're read: 12:34 PM: Twelve thirty-four PM 12:45:15 PM: Twelve forty-five and fifteen seconds PM
   Synthesize Text	Click to add text to your prompt. Enter the text in the Sequence Value field. The default text is The little brown dog. Example: Wednesday, April 27, 2022 Read as: Wednesday April twenty-seven two thousand twenty-two

6. If you want to change the order of the segments in the Sequence field, select the sequence you want to move and click the up or down arrows . When the script plays a prompt, its sequences are read in order from top to bottom.

7. Insert a pause between words or phrases using one of the following methods:

   • Use a recorded file of silence: Create a WAV file or upload a sound file of silence using the Sequence Editor. Click Play a Wave File and select the silence file. If necessary, click the WAV file in the Sequence field and use the arrow keys to move the prompt to where you want it to be.
   • Use a Wait action: Use one Play action for the segments of the prompt that you want to separate with silence, then add a Wait action between them. Configure Wait with the length of the pause.
8. Modify entries in the Sequence field if necessary. Select a sequence in the Sequence field and change the content in the Sequence Value field.
9. Type out the full text of the prompt in the Phrase field without formatting. This allows you to see the entire prompt in one place, instead of broken into sequences in the Sequence field. Content in the Phrase field is for your benefit only. The TTS service doesn't speak this text.
10. Click Apply to save the prompt.

Create a TTS Prompt in the Sequence Property

You can create a TTS Allows users to enter recorded prompts as text and use a computer-generated voice to speak the content. prompt in an action's Sequence property by entering sequences with the appropriate formatting. A sequence is a series of characters, words, or phrases, or sentences. The TTS service recognizes several types of sequences. You can include more than one sequence in the Sequence property. Each sequence must:

• Be enclosed in double quotes.
• Include the string reference character required by the type of information the sequence contains. The only sequence type that doesn't require a string reference character is an audio file sequence.
• Follow supported formats for information such as dates, time, and money.
• Contain no more than 300 characters. If you need to include text that's more than 300 characters, split it between multiple sequences.

Create a Dynamic TTS Prompt

You can create a dynamic prompt in a Snippet action. This is helpful if you have a prompt that changes continually. You can enter the prompt directly into the Snippet editor window, or you can create it in the Sequence Editor and copy it into the Snippet action.

1. In Studio, open an existing script or create a new one.
2. Add a Snippet action and the action that will play the prompt, such as Play.
3. Place Snippet before Play and connect them.

4. Create the prompt in the sequence editor, then copy the contents of the action's Sequence property.

   Some actions have a Sequence property but not the sequence editor. If the action you need to use doesn't support the sequence editor, add a Play action to your script, create your prompt, and copy it from the Sequence property. Delete the extra action after creating the prompt.

5. Double-click the Snippet action.

6. In the Snippet editor window, create the dynamic object and assign the sequence to it using this syntax:

   DYNAMIC [dynamic object name] = [sequence]

7. Add a dollar sign character ( $ ) to the front of the sequence definition, before the first double quote. Use backslash characters to escape all double quotes in the prompt. For example:

   ASSIGN promptList = $"\"{promptPath}YourAccountBalanceIs_{lang}.wav\" \"%{accountBalance}\" \"{promptPath}ToPayYourBillPress_{lang}.wav\"" 

8. Add any other variables to the snippet that are required to complete the prompt, if they're not in your script already.

   For example:

   ASSIGN env = "PROD"
   ASSIGN lang = "ENG"
   ASSIGN promptPath = "Prompts\{env}\"
   ASSIGN accountBalance = "$52.65"
   ASSIGN promptList = $"\"{promptPath}YourAccountBalanceIs_{lang}.wav\" \"%{accountBalance}\" \"{promptPath}ToPayYourBillPress_{lang}.wav\""

9. Click Apply.
10. On the script's canvas workspace, select the action that will play the prompt.
11. In the Sequence property, enter the name of the dynamic object that holds the prompt in the Snippet action. For the example used in this section, you would enter {promptList}.
12. Click Apply.

Record Audio Prompts in Studio

Required permissions: Applications > Studio > Scripts Create/Edit , Applications > Studio > Prompts > Record

You can record a voice prompt through the Sequence Editor in Studio. You must have access to a phone to record a prompt with this method. You'll provide the phone number, then receive an automated call that will record what you say.

The audio files you record in Studio are stored as WAV files in your CXonetenant High-level organizational grouping used to manage technical support, billing, and global settings for your CXone environment. You can use them as audio prompts in any action that supports sequences. You can see all available audio files on the Browse ACD Files page in CXone.

1. In Studio, open an existing script or create a new one.

2. Add an action that supports the Sequence Editor to the script, such as Play or Whisper.

3. Double-click the action icon to open the Sequence Editor.

4. Click Play a Wave File and select New.

5. Select NewPrompt().wav in the Sequence field, then type over the default value in the Sequence Value field to rename the WAV file. When you change the name of a file in the Sequence Value field, the name also changes in the list of sequences.

6. Click the Connect Prompt Manager icon in the toolbar to open the Prompt Manager Login window.

7. Enter the phone number of a phone that you have access to right now. You will receive a call on that phone so that you can record the prompt.

8. Click Connect to receive a call from the recording service.

9. Answer the phone call. Some of the icons in the Sequence Editor toolbar become available and the toolbar displays a Prompt Manager Ready message. The icons that are now available allow you to control the recording during the call.

   View image

   

10. Click the Record icon to begin recording your prompt.

11. When you hear a beep from the call, clearly speak your prompt or message.

12. When you are done recording, click the Stop icon . Don't hang up until you've reviewed the prompt.

13. To review your recording, click the Play icon .

14. If the voice prompt is acceptable, end the call. If it is not acceptable, click the Record icon to record the prompt again.

Assign an Audio Prompt to an Action

Required permissions: Applications > Studio > Scripts Create/Edit

After you record or upload a new audio prompt, you can add it to the action you want to play that prompt.

You can enter the file name for a recorded, uploaded audio prompt in the Sequence property of the action. You can also use the Sequence Editor, as described in this task.

1. In your script, double-click the action you want to assign the prompt to.
2. In the Sequence Editor, click Play a Wave File and select Browse.
3. Select the prompt you want to play and click OK.
4. Click Apply to save your selection and close the Sequence Editor.

Edit Prompts in Studio

Required permissions: Applications > Studio > Scripts Create/Edit

The Wave Editor allows you to trim unwanted audio from the beginning and end of a WAV file.

1. Double-click an action that supports prompts. The Sequence Editor may already be open if you just recorded a prompt.
2. Click the Edit Wave icon in the toolbar to launch the Wave Editor.
3. Select the WAV file that you want to edit from the Prompts column.
4. Click the left mouse button to highlight the beginning of the prompt that you want to trim out.
5. Click the right mouse button to highlight the end of the prompt that you want to trim out.
6. You can check that you've trimmed the appropriate amounts of audio by clicking the green Play icon to play the prompt with the highlighted sections you want to remove.
7. Click Edit>Trim to remove the highlighted sections of the WAV file.
8. Save your changes.

Upload Audio Prompts

Required permissions: Applications > Studio > Prompts > File Browser

If you use a third-party audio application to record a prompt, you can upload it in Studio. Any prompt you upload must be in the supported audio format:

• Bit rate: 64 kbps
• Audio sample size: 8 bit
• Channels: 1 (mono)
• Audio sample rate: 8 kHz
• Audio format: CCITT μ-Law

You can also view, upload, and manage prompts and other files on the Browse ACD Files page in CXone.

1. On the Files tab in Studio, expand the folder you want to upload the file to. If you're uploading a prompt, expand the Prompts folder.

2. Drag a file from the file browser on your computer to the Files window in Studio.
3. Click the Refresh icon and verify the prompt's Date Modified field has been updated.

Download or Delete Audio Prompts and Other Files

Required permissions: Applications > Studio > Prompts > File Browser

You can download or delete prompts and other files from Studio to your computer. You can also do this on the Browse ACD Files page in CXone.

1. On the Files tab in Studio, expand the folder where the file is located.

2. To download a file, drag it from the Studio file browser to the desktop or a folder on your computer.
3. To delete a file, select it and click the red X icon . Click Yes to confirm you want to delete the file.