V-Blaze and V-Cloud Online Help

Configuring Handlers

Handlers contain V‑Blaze transcription parameters to interact with the ASR engine to transcribe audio. Additionally, handlers include a list of actions that perform various tasks based on the transcription results. Multiple handler configurations are useful to connect to different V‑Blaze servers or if multiple transcription configurations are required.

Configuring Handler Transcription Settings

Each handler configuration has a separate section that specifies a set of parameters to interact with V-Blaze. The default [Adapter] section within /config/default.cfg contains two handlers to separate transcription requests:

  1. [LiveCall] — Activates at the start of a call. The [LiveCall] handler contains transcription settings optimized for speed.

  2. [PostCall] — Activates when a call has completed. The [PostCall] handler contains transcription settings optimized for quality.

The following is a sample [LiveCall] handler:

server = localhost
actions = LiveLog
activitylevel = 50
uttminactivity = 100
uttmaxsilence  = 800
uttpadding = 100
reconnectdelay = 1
reconnectattempts = 0
reconnectmaxdelay = 600

The following is a sample [PostCall] handler:

server = localhost
actions = PostLog
gender = true
emotion = true
scrubdir = /var/lib/vociadapter/json
utthandler = true
mincalldur = 10
maxcalldur = 7200
maxcalls = 100000
Table 1. Handler Settings — /config/custom.cfg





localhost (default), URL: HTTP or HTTPS

Specify the hostname or address of the ASR engine for the handler to use.


No default

Define the list of actions for the handler to use.


No default

V-Blaze API parameter — Enables the ASR engine to redact sensitive information from transcripts.


No default

Specify a directory to save redacted transcripts.


true (default), false

If utthandler=true (default), actions designed to work with the live-stream URL run whenever an utterance is transcribed. If utthandler=false, actions run when the call completes and the full transcript is available.


10 (default)

Specifies the minimum call length (seconds) for the handler to accept. mincalldur doesn't apply to real-time configurations.


7200 (default

Specifies the maximum call length (seconds) for the handler to accept.



Specifies the maximum number of simultaneous calls the handler allows.


No default

Specifies which filter configurations to call.


No default

V-Blaze API parameter — Set gender=true to enables gender detection. For each utterance, the ASR engine will attempt to determine if the speaker is male or female.


No default

V-Blaze API parameter — Set emotion=true to enable emotion detection. Each utterance will be categorized as strongly positive, positive, neutral, negative, or strongly negative.


1 (default)

Initial delay (seconds) for reconnect attempts.


0 (default)

Maximum number of reconnect attempts before shutting down the service. For unlimited attempts, set reconnectattempts=0.


600 (default)

Upperbound in seconds for the exponential backoff for reconnect attempts.


Refer to V-Blaze Transcription Parameters for more information on the V-Blaze API parameters in the table above.

Configuring Handlers for Multiple Servers

Connect to multiple servers by setting the value of server to a comma-separated list of separate servers. You can also limit the number of simultaneous streams by adding @n, where n is the number of streams. The following configuration is an example of multiple servers with limited streams:

server = hostname_1 @10, hostname_2 @15, hostname_3


The adapter assigns each transcription request to the server with the smallest load.

If @n isn't specified, the value is set to the match the value of maxstreams returned by a V‑Blaze API /status query.