Error handling and service continuation

Defines activities that are executed sequentially in case of an error during an ongoing call.

The value of this parameter should match the name field of one of the activityLists entries, which defines the activities to execute.

By default, the parameter is not defined.

For more information, please contact AudioCodes support.

Defines alternative speech-to-text providers in case of a speech-to-text error during an ongoing call.

• sttProvider: string

• sttContextId: string (optional field)

• sttModel: string (optional field)

This list will provide up to 5 alternative speech-to-text providers in case of an speech-to-text error.

VoiceAI Connect will add the original provider to this list (i.e., if all the providers listed fail, Voice AI Connect will retry with the original speech-to-text provider).

The following shows an example of configuration with an alternative speech-to-text provider:

{
  "sttFallbackProvider": [
    {
      "sttProvider": "other provider",
      "sttEndpointId": "Endpoint ID",
      "sttContextId": "Context Id value",
      "sttModel": "stt model type"
    }
  ]
}

Defines alternative text-to-speech providers in case of a text-to-speech error during an ongoing call.

• ttsProvider: string

• voiceName: string

• ttsDeploymentId: string (optional field)

This list will provide up to 5 alternative text-to-speech providers in case of an text-to-speech error.

Voice AI Connect will add the original provider to this list (i.e., if all the providers listed fail, Voice AI Connect will retry with the original text-to-speech provider).

The following shows an example of configuration with an alternative text-to-speech provider:

{
  "ttsFallbackProviders": [
    {
      "ttsProvider": "provider Name",
      "voiceName": "voice name output",
      "ttsDeploymentId": "deploymentId string"
    }
  ]
}

Defines how many times VoiceAI Connect tries to send the prompt when it receives a text-to-speech playback error from the SBC.

The default is 2. A value of 0 means that VoiceAI Connect does not attempt to send the prompt again.

The valid range is 0 to 5. The default is 2.

Defines what happens when the Azure bot error "retry" occurs.

• true: (Default) The error is printed to the log and the call is disconnected.

• false: The error is printed to the log, but the call is not disconnected, unless max retry is exceeded (configured in the maxAzureFailureRetries parameter) while trying to send the 'start' message.

Note: The "retry" error might occur when there is a problem or delay in the bot code. It does not necessarily indicate a non-recoverable problem. Hence, this parameter is only used on specific setups.

Defines the number of times the VoiceAI Connect attempts to send a message to an Azure bot before failing due to a timeout.

The valid range is 0 to 5. The default is 0.

Note:

• The parameter is applicable only to Azure.

• If the bot has handled the original request, the retry might occur after the bot state has changed, hence this parameter should only be used on specific setups.

Defines the maximum time (in milliseconds) that VoiceAI Connect Enterprise waits for a response from the speech-to-text provider.

The valid value is 10 to 600,000. The default is 10,000.

If no response is received when this timeout expires, VoiceAI Connect Enterprise disconnects the call with the SBC.

If the call is disconnected, the SIP BYE message sent by the SBC to the user indicates this failure by prefixing the value in the Reason header with "STT Err:".

Note:

• In this scenario (disconnect), you can also configure VoiceAI Connect Enterprise to perform specific activities, for example, playing a prompt to the user or transferring the call (see the generalFailoverActivities parameter).

• This parameter is not applicable to DNN and AWS speech-to-text providers.