Voice Browser service properties

Set these parameters in Management Station.

The Voice Browser service interprets VoiceXML content and executes commands and logic specified by speech applications written in VoiceXML. This table lists service properties you can set on the Advanced tab for the Voice Browser service:

Service property

Description

App-
settable

Data type

Default

browser.authentication.password

Password for HTTP basic authentication.

No

STRING

No default

browser.authentication.username

Username for HTTP basic authentication.

No

STRING

No default

browser.caching.resource_type.maxCacheEntrySize

Maximum file size (bytes)for a cacheable resource type.

No

INT

480000

browser.caching.resource_type.maxCacheSize

Maximum size (bytes) for cached resource types.

No

INT

Resource types:

  • context: 1000000
  • data: 1000000
  • page: 2000000
  • script: 1000000

browser.characterEncoding

Character encoding for parsing language-specific application data.

No

STRING

System encoding of machine

browser.errorPage

Generic error page to load when a system error is encountered.

No

STRING

No default

browser.errorPage.initial_page

Application-specific error page to load when a system error is encountered.

No

STRING

No default

browser.loading.acceptableResponseLatencyMillis

Threshold (milliseconds) for the web server or application server response time.

No

INT

5000

browser.loading.fetchtimeout

Timeout for fetching new content.

No

INT

10000

browser.loading.resource_type.freshnessFraction

The fraction of a resource’s age used to calculate the freshness lifetime.

No

FLOAT

0.10

browser.loading.resource_type.maxFreshnessLifetime

Maximum freshness lifetime (seconds) of a cached resource.

No

INT

86400

browser.LogDirectoryHierarchy

Writes diagnostic log files in a hierarchical directory structure that indicates the year, month, day, and hour when the call started.

No

BOOL

FALSE

browser.LogPerCall

Creates one diagnostic log file per call.

No

BOOL

FALSE

browser.maxAppPostCallProcessingSecs

Number of seconds to wait after a remote or a local hangup for the application to finish hangup processing.

No

INT

5

browser.maxPlatformPostCallProcessingSecs

Number of seconds permitted after a remote or local hangup for the platform to be ready to take the next call before generating an alarm.

No

INT

5

browser.maxspeechtimeoutfactor

Multiplier for adding a margin when converting value of a maxspeechtimeout to a Recognition-Timeout header.

No

FLOAT

1.25

browser.mrcp.nomatch.getConfidence

Sends the confidence score for REJECTED recognition results to the VXML application.

No BOOL FALSE

browser.mrcp.serverAddress

Hostname and port number for the Voice Browser service to communicate with Nuance Speech Server.

No

STRING

Per Nuance Speech Server (NSS) in role:

  • NSS #1: 127.0.0.1:5066
  • NSS #2: 127.0.0.1:5076
  • NSS #3: 127.0.0.1:5086
  • NSS #4: 127.0.0.1:5096

browser.mrcp.session.keepalive.timeout

Maximum time (milliseconds) to wait before sending a message to the Nuance Speech Server to keep the session alive.

No

INT

50000

browser.override.java.networkaddress.cache

Caching policy for successful lookups from the Domain Name System.

No

INT

No default
(Java default applies)

browser.preloadURI.document_name

Name and URL of a VoiceXML document to preload.

No

STRING

No default

browser.primaryLocale

Primary locale of the Voice Browser service.

No

STRING

en-US

browser.removeCachedCookies

Browser cookies to be removed from the cache (to ensure a unique cookie of the type is created for each instance).

No

STRING

jsessionid

browser.security.allow.sip.uri_suffix

Indicates support for sip: URIs in transfers and outbound calls.

No

BOOL

TRUE

browser.security.allow.tel.uri_suffix

Indicates support for tel: URIs in transfers and outbound call.

No

BOOL

TRUE

browser.security.ssl.disableCertVerification

Disables SSL verification during development.

No BOOL FALSE

browser.security.limit.maxCallDuration

Maximum call duration (milliseconds).

No

INT

-1 (meaning no limit)

browser.security.limit.maxCallWarningPrompt

Warning prompt to be played before a call is terminated.

No

STRING

No default

browser.security.limit.maxCallWarningTime

Time (milliseconds) before terminating call when the warning prompt will be played.

No

INT

No default

browser.security.limit.maxEventsForCall

Number of VoiceXML events that can take place during a call.

No

INT

-1 (meaning no limit)

browser.security.limit.maxStatesBetweenUserInput

Number of states allowed between user inputs before throwing a security exception.

No

INT

2000

browser.security.ssl.keyStoreURL

Location of the client keystore for establishing secure connections between the Voice Browser service and the application server.

No

STRING

No default

browser.security.ssl.keyStorePassword

Password for accessing the client keystore.

No

STRING

No default

browser.security.ssl.TrustStoreURL

Location of the server truststore used to establish a two-way secure connection between the Voice Browser service and the application server.

No STRING No default
browser.security.ssl.keyTrustStorePassword

Password for access to the server truststore.

No STRING No default

browser.sip.gateway.port

Port number for the Voice Browser service to send SIP messages to the Telephony Session service.

No

INT

Per Voice Browser service instance (VBS):

  • VBS #1: 5064
  • VBS #2: 5074
  • VBS #3: 5084
  • VBS #4: 5094

browser.sip.useragent.listeningport

Port number the Voice Browser service to receive SIP messages from the Telephony Session service.

No

INT

Per Voice Browser service instance (VBS):

  • VBS #1: 5062
  • VBS #2: 5072
  • VBS #3: 5082
  • VBS #4: 5092

High-availability roles:

  • VBS #1 HA: 6002
  • VBS #2 HA: 6012
  • VBS #3 HA: 6022
  • VBS #4 HA: 6032

browser.suppressUrlLogging

Suppresses TRANSITION and EXECUTING_URL events in call logs, and suppresses Executing events in diagnostic logs.

No

BOOL

FALSE

browser.systemErrorPrompt

System error prompt to play when errors occur at the platform level (or when errors are not handled by the application).

No

STRING

system_error.wav

browser.systemErrorPrompt.fallback

Text played for a system error event.

No

STRING

TTS version of the default system_error.wav prompt

browser.tonedetection.amd.enable

Enables answering-machine tone detection.

No

BOOL

TRUE

browser.tonedetection.amd.maxgreeting

Maximum time (milliseconds) to wait for the greeting message of a detected answering machine to finish.

No

INT

30000

browser.tonedetection.fax.enable

Enables fax tone detection.

No

BOOL

TRUE

browser.tonedetection.sit.enable

Enables SIT tone detection.

No

BOOL

TRUE

browser.tonedetection.tty.enable

Enables TTY tone detection.

No

BOOL

TRUE

call.maxtime

Maximum duration of a transferred call.

No

INT

(unlimited)

call.sipsessioncleanupwait

How to treat leftover calls.

No

INT

0

call.warningPrompt

Warning prompt to play immediately before a bridged transfer is terminated.

No

STRING

No default

call.warningTime

Time (milliseconds) before the end of a bridged transfer when the call.warningPrompt is played .

No

INT

10000

voicexml.helpHandlerPrompt

Prompt played when a help event is thrown and not handled by the application.

No

STRING

help.wav

voicexml.helpHandlerPrompt.fallback

Text played for a thrown help event.

No

STRING

TTS version of the default help.wav system prompt

voicexml.maxspeechtimeoutHandlerPrompt

Prompt played when a maxspeechtimeout event is thrown.

No

STRING

maxspeechtimeout.wav

voicexml.maxspeechtimeoutHandlerPrompt.fallback

Text played when a maxspeechtimeout event is thrown.

No

STRING

TTS version of the default maxspeechtimeout.wav system prompt

voicexml.nomatchHandlerPrompt

Prompt played if a nomatch event is thrown and not handled by the application.

No

STRING

nomatch.wav

voicexml.nomatchHandlerPrompt.fallback

Text played when a nomatch event is thrown.

No

STRING

TTS version of the default nomatch.wav system prompt

voicexml.NumECMAScriptInstr

Number of instructions allowed when executing an ECMAScript snippet.

No

INT

2000000

voicexml.recordBeepPrompt

Prompt played if executing a <record> element when the beep attribute is set to TRUE in a VoiceXML document.

No

STRING

beep-default.wav