Audiocodes: Advanced Configuration – Cognigy.AI Help Center
Audiocodes: Advanced Configuration
Cognigy Support
October 27, 2022
After connecting Audiocodes to your phone number/SIP trunk and building a first simple Flow, you might want to take the next step and configure advanced settings to create even better user experiences. Some of these advanced settings are the topic of this article.
Overview
Audiocodes comes with a large number of configuration settings which can be controlled directly from within your Cognigy Flow. These settings can be applied individually to two scopes:
- sessionParams - the settings apply to the whole session from the time of applying them
- activityParams - the settings apply only to the current activity (e.g. sendMessage)
In order to set these settings, you can use the built-in Audiocodes Extension.
Setting Session Parameters
Session parameters can comfortably be set with the "Set Session Parameters" Node. When executed, the settings will apply for the remainder of the session.
Setting Activity Parameters
Activity parameters can be set per activity. If for example set on "Send Message", they will only impact the execution of this activity. An example would be setting "Barge In" to true only for a long message that is sent, allowing the user to interrupt the voicebot during this message, but not afterwards.
Parameter Details
STT Settings
These settings apply to the Speech-to-Text engine (e.g. Azure Speech Services).
| Parameter | Type | Description |
| Language Code | Text | Defines the language (e.g., "en-ZA" for South African English) of the voicebot conversation and is used for TTS and STT functionality. The value is obtained from the service provider. |
| Disable STT Punctuation | Toggle | Prevents the STT response from Audiocodes to include punctuation marks. |
TTS Settings
These settings apply to the Text-to-Speech engine (e.g. Azure Speech Services).
| Parameter | Type | Description |
| Voice Name | Text | Defines the voice name for the TTS service. |
| Disable TTS Cache | Toggle | Enables caching of TTS (audio) results from the Flow. Therefore, if Audiocodes needs to send a request for TTS to a TTS provider and this text has been requested before, it retrieves the result from its cache instead of requesting it again from the TTS provider. |
DTMF
These settings apply to the DTMF (dual tone multi frequency) features of Audiocodes.
| Parameter | Type | Description |
| Send DTMF | Toggle | Enables the sending of DTMF events to the Flow. |
| DTMF Collect | Toggle | Defines the DTMF digit collection and sending method. |
| DTMF Collect Timeout | Number | Defines the timeout (in milliseconds) that Audiocodes waits for the user to press another digit before it sends all the digits to the Flow. |
| DTMF Collect Max Digits | Number | Defines the maximum number of DTMF digits that Audiocodes expects to receive from the user. |
| DTMF Collect Submit Digit | Text | Defines a special DTMF "submit" digit that when received from the user, Audiocodes immediately sends all the collected digits to the Flow. |
Barge In
Barge In stands for the ability of the user to interrupt the voicebot by speaking during a running prompt.
| Parameter | Type | Description |
| Barge In | Toggle | Enables the Barge-In feature. |
| Barge In on DTMF | Toggle | Enables the Barge-In on DTMF feature. |
| Barge In Minimum Words | Number | Defines the minimum number of words that the user must say for Audiocodes to consider it a barge-in. |
Continuous ASR
These settings relate to the continuos ASR feature of the Voice Gateway.
| Parameter | Type | Description |
| Enable Continuous ASR | Toggle | Enables the Continuous ASR feature. Continuous ASR enables Audiocodes to concatenate multiple STT recognitions of the user and then send them as a single textual message to the bot. |
| Continuous ASR Digits | Text | This parameter is applicable when the Continuous ASR feature is enabled. Defines a special DTMF key, which if pressed, causes Audiocodes to immediately send the accumulated recognitions of the user to the Flow. |
| Continuous ASR Timeout | Number | This parameter is applicable when the Continuous ASR feature is enabled. Defines the automatic speech recognition (ASR) timeout (in milliseconds). |
User Timeouts
| Parameter | Type | Description |
| No User Input Timeout (ms) | Number | Defines the maximum time (in milliseconds) that Audiocodes waits for input from the user. If no input is received when this timeout expires, you can configure Audiocodes to play a textual or audio prompt to ask the user to say something. |
| No User Input Retries | Number | Defines the maximum number of allowed timeouts for no user input. |
| Send No User Input Event | Toggle | Enables Audiocodes to send an event message to the Flow if there is no user input for the duration configured by the "No User Input Timeout" parameter. |
| No User Input Prompt | Text | Defines the textual prompt to play when no input has been received from the user when the timeout expires. |
| No User Input URL | Text | Defines the URL from where the audio prompt is played to the user when no input has been received from the user when the timeout expires. |
Bot Timeouts
| Parameter | Type | Description |
| No Flow Input Timeout (ms) | Number | Defines the maximum time (in milliseconds) that Audiocodes waits for input from the Flow. |
| No Flow Input Retries | Number | Defines the maximum number of allowed timeouts for Flow input. |
| No Flow Input Prompt | Text | Defines the textual prompt to play to the user when no input has been received from the Flows when the timeout expires. |
| No Flow Input URL | Text | Defines the URL from where the audio prompt is played to the user when no input has been received from the Flow when the timeout expires. |
Azure Configuration
| Parameter | Type | Description |
| Azure STT Mode | Select | Defines the Azure STT recognition mode. |
| Azure STT Context ID | Text | This parameter controls Azure's Custom Speech model. The parameter can be set to the endpoint ID that is used when accessing the STT engine. |
| Azure TTS Deployment ID | Text | Defines the customized synthetic voice model for Azure's text-to-speech Custom Neural Voice feature. |
| Enable Audio Logging | Toggle | Enables recording and logging of audio from the user. |
Google Configuration
| Parameter | Type | Description |
| Google Interaction Types | Select | Defines the Google STT interaction type. |
| Google Cloud STT Context Phrases | Text Array | When using Google's Cloud STT engine, this parameter controls Speech Context phrases. |
| Google Cloud STT Context Boost | Number | Defines the boost number for context recognition of the speech context phrase configured by sttContextPhrases. |
Advanced
| Additional Session Parameters | JSON | Provides a JSON payload field to configure any of the additional or existing session parameters as per the Voice AI Connect session control documentation. |
Contact Center Automation
- Amazon Connect
- Audiocodes: Using Voice Verification and Biometrics
- Voice Language Recognition with Cognigy Voice Gateway
- Audiocodes: Advanced Configuration
- Audiocodes: Identifying call disconnect events
- Facebook Messenger: Use Facebook Handover
- RingCentral Engage: Handover Integration
- Twilio: Forward a call