Voice Preview - Cognigy Documentation

Voice Preview Documentation

The Voice Preview feature lets users quickly test their AI Agents’ voice output in the Flow editor or Interaction Panel without going through the entire Flow with a mock call. This feature supports cloud speech-to-text (STT) and text-to-speech (TTS) services. To use the Voice Preview, you need to enter text or SSML syntax, and select the language and voice.

Restrictions

• The Voice Preview feature supports only the Google, Microsoft, Amazon AWS, Deepgram, and Speechmatics speech providers. When testing a voice Flow through the Interaction Panel, check the STT and TTS settings of the voice Nodes to ensure that one of these providers is specified. If any other provider, such as ElevenLabs, is specified in the Nodes, the Interaction Panel won’t support the voice conversation.
• SSML syntax in the Voice Preview must be supported by the speech provider. For example, ElevenLabs doesn’t support SSML. Check the documentation of your speech provider to see if it supports SSML.

Access STT and TTS Providers

If your environment has network connection restrictions or requires strict security rules, ensure that both STT and TTS providers are accessible. Add the IP address ranges of your STT and TTS providers to the firewall’s whitelist to ensure the Cognigy.AI server can interact smoothly with both providers.

How to Use Voice Preview

Set up a Speech Provider

To set up a speech provider and test your voice agents, follow these steps:

1. In the left-side menu of the Project, go to Manage > Settings.

2. Go to the Voice Preview Settings section and select one of the following providers from the Speech Provider list:

   • Microsoft
   • Google
   • Amazon
   • Deepgram
   • ElevenLabs
   • Speechmatics

3. Next to the Speech Connection field, click to enter credentials.

4. In the New Connection window, fill in the following fields:

   • Connection — specify a unique connection name.
   • API Key — specify an API key for Microsoft Azure Speech Services. For more information, read the Microsoft Azure AI documentation.
   • Region — this parameter is optional. Enter a specific region if necessary. Verify which voices are available in the provided region in the Azure AI Speech regions documentation.

5. Click Upload JSON File and upload the JSON file that you received from Google Speech Services.

6. Specify a unique name for your connection in the Connection field.

7. Fill in the following fields for AWS and Deepgram:

   • Access Key ID — specify an Access Key ID from the AWS Management Console.
   • Secret Access Key — specify a Secret Access Key.
   • Session Token — this parameter is optional.
   • Region — this parameter is optional.

8. For ElevenLabs, specify a unique connection name, an API key, and choose a region.

9. For Speechmatics, specify a unique connection name, an API key, and select a region.

10. Click Create. To check the connection, click Test.

You can set up multiple speech providers. By default, the speech provider selected in the Speech Provider list is applied to your Flows and the Interaction Panel.

Use Voice Preview

Access the Voice Preview feature in the Flow editor or the Interaction Panel. The Voice Preview button is displayed only for certain types of output, including regular text output, fallback text, and text or SSML output from channels that support voice.

More Information

• Interaction Panel
• Voice Gateway
• Voice Nodes

Last modified on May 29, 2026.