Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

How do I use text-to-speech in announcements?

You can configure an Announcer applet and Menu applets to announce some text in a voice of your choosing. You can either define the exact text to be announced , or the data sources that will contain the text to be announced at run time, in the applet. You can also specify the voice you want to use for the text in the applet, or use a data source that will contain the name of the voice at run timeruntime. For information about the Announcer appletand Menu applets, see Announcer applet and Menu applet.

Insert excerpt
_ExcerptCallsOnly
_ExcerptCallsOnly
nopaneltrue

Expand
titleUsing data sources

To use any dynamic elements in the Announcer appletand Menu applets, you must configure data sources. These data sources must contain the required values for the elements when Vonage Contact Center routes the call to the applet.

Insert excerpt
_ExcerptDataSourceApplets
_ExcerptDataSourceApplets
nopaneltrue

...

  1. In the same interaction plan as your data sources (if using data sources), create an Announcer or Menu applet.
  2. In the Announcement type list, click Text

    . The Voice and Text fields appear

    to speech. Depending on which applet you are creating, you can configure the voice that announces the menu options in different ways.

    Expand
    titleMenu applet

    If you are creating a Menu applet, the Dynamic voice check box appears.

    • To announce the menu options in a voice that is set at runtime from the data source you define in Voice data source, select Dynamic voice. Voice data source appears.
      Voice data source contains a list of available data sources. S
      elect the data source that will contain the required value at run time.
    • To announce the menu options in the same voice every time, clear Dynamic voice. Voice appears.
      Voice contains a list of voices available in Amazon Polly. Select the voice you want to use to announce menu options.


    Expand
    titleAnnouncer applet

    If you are creating an Announcer applet, Voice appears.

    In Voice, define the voice you want to use to announce the text. You can use either a static value or a dynamic value from a data source.

    • To use a static value, type the voice you want to use. The applet validates the voice when you click Update.
    • To use a dynamic value from a data source, type the dollar sign ($). A list of available data sources appears. Click the data source that will contain the required value at run time.
      For example, $(Contact|TextToSpeech_voice__c).

    The Voice field can contain a maximum of 50 characters.  

    Whether you use a static or dynamic value for the voice, it must match the voice ID provided by Amazon Polly. The voice is not case-sensitive. For a list of voices available in Amazon Polly and their IDs, see Voices in Amazon Polly (Amazon help).

    Note
    titleNeural voices
    We only support standard voices; neural-only voices are not supported. For information about neural voices, see NTTS Speaking Styles.
    The applet validates the voice when you click Update
    .

    The Voice field can contain a maximum of 50 characters.  


  3. In Text, define the text you want to be announced.
    The Text field can contain text, digits, or a combination. You can include both static values and dynamic values from data sources.
    To use a dynamic value from a data source, type the dollar sign ($). A list of available data sources appears. Click the data source that will contain the required value at run time
    For example, Balance is $(account(1)|balance)
    The Text field can contain a maximum of 500 1500 characters.
  4. Optionally enable barge-in, you can validate the audio.
    Insert excerpt
    _ExcerptBargeInExcerptValidateAudio
    _ExcerptBargeInExcerptValidateAudio
    nopaneltrue
  5. In the Next applets section, click the applet that Vonage Contact Center routes the interaction to after the Announcer applet on success and failure.
  6. Optionally, you can validate the audioOptionally enable barge-in.
    Insert excerpt
    _ExcerptValidateAudioExcerptBargeIn
    _ExcerptValidateAudioExcerptBargeIn
    nopaneltrue
  7. Click Update. Configure the rest of your interaction plan as required and click Update.

Now when Vonage Contact Center routes a call through the

...

applet, the caller hears the configured text in the specified Amazon Polly voice.