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 Announcer and Menu applets to announce 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. 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 runtime. For information about the Announcer and 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 and 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

The applet sends your configured text to the Amazon Polly service which turns your text into speech in the specified voice. The service returns the speech and the applet plays it.

To use text-to-speech in announcements, perform the following steps:

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


  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 1500 characters.
  4. Optionally, you can validate the audio.
    Insert excerpt
    _ExcerptValidateAudio
    _ExcerptValidateAudio
    nopaneltrue
  5. Optionally enable barge-in.
    Insert excerpt
    _ExcerptBargeIn
    _ExcerptBargeIn
    nopaneltrue
  6. 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.