Docs

Configuration Reference

This page documents every option available in each configuration section of the Voice Agent settings form. See The Voice Agent Editor for an overview of the form layout and how to navigate between sections.

Speech-to-Text (STT) Providers

Select the STT provider using the Transcriber Provider dropdown at the top of the Input Speech Details section. Fields update automatically based on the selected provider.

Custom Transcriber

FieldDescription
Default LanguagePrimary transcription language (BCP-47 code, e.g. en-US).
Candidate LanguagesAdditional languages for multi-language detection. Multi-select.
Speech KeyAzure Cognitive Services subscription key.
Speech RegionAzure region for the Speech service (e.g. eastus).
Use External VADUse an external Voice Activity Detector instead of Azure’s built-in VAD. Off by default.
VAD Silence ThresholdDuration of silence (seconds) before the external VAD ends a speech segment. Default: 1. Only visible when Use External VAD is on.
VAD Sample RateAudio sample rate (Hz) for the external VAD. Default: 16000. Only visible when Use External VAD is on.

AWS Transcriber

Amazon Transcribe streaming transcription.

FieldDescription
Auto Language IdentificationLet Amazon Transcribe detect the spoken language automatically. On by default.
LanguageFixed transcription language. Only visible when Auto Language Identification is off. Options span 26 languages including English (US/UK/AU/IN), Vietnamese, Thai, Indonesian, Malay, Tagalog, Tamil, Telugu, Hindi, Arabic, Japanese, Korean, Mandarin Chinese, and major European languages.
Preferred LanguageThe language to favour when multiple candidate languages are detected. Only visible when Auto Language Identification is on. Default: English (US).
Candidate LanguagesLanguages the identifier may choose between. At least 2 required when Auto Language Identification is on.
Use External VADUse an external Voice Activity Detector. Off by default.
VAD Silence ThresholdDuration of silence (seconds) before the external VAD ends a speech segment. Default: 0.5.
VAD Sample RateAudio sample rate (Hz) for the external VAD. Default: 16000.
Enable DenoiserApply audio denoising before transcription. Off by default.
Denoiser TypeDenoising algorithm to use. Options: RNNoise, Other. Only visible when Enable Denoiser is on.

Deepgram

Deepgram real-time streaming transcription API.

FieldDescription
API KeyDeepgram API key. Required when On-Premise is off.
LanguageTranscription language (BCP-47 code). Default: en-US.
ModelDeepgram model to use. For English, select nova-2. For Indonesian (id-ID), Vietnamese (vi-VN), or Malay (ms-MY), select a language-specific model version from the dropdown.
Model VersionVersion string for the selected model.
WebSocket URLDeepgram streaming endpoint URL. Leave empty to use Deepgram’s default cloud endpoint.
On-PremiseConnect to a self-hosted Deepgram instance via the WebSocket URL instead of Deepgram’s cloud. On by default.

ElevenLabs (STT)

ElevenLabs real-time speech-to-text using the scribe_v2_realtime model.

FieldDescription
API KeyElevenLabs API key. Required.
ModelElevenLabs STT model. Default: scribe_v2_realtime.
Auto Language DetectionDetect the spoken language automatically. On by default.
LanguageFixed transcription language. Only visible when Auto Language Detection is off. Supports 28 languages including English, Spanish, French, German, Italian, Portuguese, Mandarin Chinese, Cantonese, Japanese, Korean, Vietnamese, Thai, Indonesian, Malay, Filipino, Arabic, Hindi, Tamil, Telugu, Kannada, Malayalam, Javanese, Cebuano, Khmer, Lao, Burmese, Afrikaans, and Swahili.
WebSocket URLElevenLabs STT streaming endpoint. Default: wss://api.elevenlabs.io/v1/speech-to-text/realtime.

Advanced Settings (toggle to expand):

FieldDescription
VAD Silence Threshold (secs)Duration of silence before the VAD ends a speech segment. Default: 0.5.
VAD ThresholdSensitivity of the Voice Activity Detector (0–1). Default: 0.4.
Min Speech Duration (ms)Minimum audio length to be treated as a speech event. Default: 150.
Min Silence Duration (ms)Minimum silence length to be treated as end-of-turn. Default: 100.

Soniox

Soniox real-time speech-to-text.

FieldDescription
API KeyYour Soniox API key. Required.
ModelSoniox model ID, for example stt-rt-v5.
Language HintsExpected languages, to improve accuracy. Leave empty for automatic detection.
Strict Language HintsOutput only the hinted languages. Requires at least one language hint. Default: off.
Enable Endpoint DetectionDetect when the caller finishes speaking from intonation, pauses, and context. Default: on.
Max Endpoint Delay (ms)Maximum silence before the utterance is committed. Range: 500–3000. Lower gives faster replies; higher gives fewer mid-sentence cut-offs.

Advanced Configuration adds Per-Token Language Tagging, Speaker Diarization (up to 15 speakers), Context Terms (comma-separated words to boost recognition), Context Text (background text about the domain), and a custom WebSocket URL.

OpenAI Realtime

OpenAI Realtime transcription.

FieldDescription
API KeyYour OpenAI API key. Required.
Modelgpt-realtime-whisper (Low Latency) — streams partial transcripts and ends the turn on the client side — or gpt-4o-transcribe (Server VAD), which supports OpenAI turn detection.
LanguageExpected language. Leave unset for automatic detection.

Advanced Configuration adds a custom WebSocket URL and, for gpt-4o-transcribe, Turn Detection: Server VAD (silence-based), Semantic VAD (model-based), or None (client-side silence detection). Server VAD has Silence Duration (ms) (default 250), Server VAD Threshold (0–1, default 0.5), and Server VAD Prefix Padding (ms) (default 300). Semantic VAD has Eagerness — Auto (balanced), Low, Medium, or High.

NVIDIA

Self-hosted NVIDIA speech recognition. Choose the Model: Nemotron (default) or Parakeet.

FieldModelDescription
gRPC ServerNemotronhost:port of the self-hosted Riva/NIM ASR endpoint.
Model NameNemotronLabel for the deployed model; the NIM chooses the actual model.
WebSocket URLParakeetws://host:port of the Parakeet ASR server.
LanguageBothLanguage code for transcription, for example en-US.
Interim ResultsBothStream partial transcripts as the caller speaks. Needed for barge-in and low-latency turn detection.
Automatic PunctuationNemotronAdd punctuation and capitalisation to the transcript.

For Nemotron, Advanced Configuration adds Use SSL/TLS (off for an in-cluster or local NIM), and API Key (cloud only) and Function ID (cloud only) for NVIDIA’s cloud endpoint.

Text-to-Speech (TTS) Providers

Select the TTS provider using the Synthesizer Provider dropdown at the top of the Output Speech Details section.

ElevenLabs (TTS)

ElevenLabs high-quality voice synthesis.

FieldDescription
API KeyElevenLabs API key. Required.
Collection ID (Optional)ElevenLabs voice collection ID. When provided, the Voice ID field becomes a dropdown listing voices from that collection.
Voice IDElevenLabs voice identifier. Entered as free text when no collection is specified; shown as a dropdown when a collection ID is set. Required.
ModelElevenLabs TTS model. Options: Eleven v3, Eleven Flash v2.5, Eleven Flash v2, Eleven Turbo v2.5, Eleven Turbo v2, Eleven Multilingual v2, Eleven Multilingual v1, Eleven English STS v2, Eleven English STS v1. Required.
PreviewPlay/pause button to audition the selected voice before saving.

Advanced Settings (toggle to expand):

FieldDescription
StabilityVoice consistency slider (0–1). Higher values produce more consistent output; lower values allow more expressive variation. Default: 0.82.
SpeedSpeech rate (0.7–1.2). Default: 1.0.
StyleStylistic intensity of the voice (0–1). Default: 0.
Similarity BoostHow closely the synthesis adheres to the original voice sample (0–1). Default: 0.81.
Optimize Streaming LatencyLatency optimisation level (integer). Higher values reduce latency at the cost of some quality. Default: 3.
Use Speaker BoostApply speaker boost enhancement. On by default.
Experimental StreamingEnable experimental streaming mode for lower latency. On by default.
Experimental WebSocketUse an experimental WebSocket connection for streaming. On by default.

AWS Polly

Amazon Polly neural, standard, and generative voice synthesis.

FieldDescription
LanguageLanguage for voice selection. Options: English (US/UK/AU/IN), Spanish (US/Spain), French (France), German, Italian, Japanese, Korean, Portuguese (Brazil), Mandarin Chinese, Hindi, Arabic (Gulf).
EngineSynthesis engine: Neural (Recommended), Standard, or Generative.
VoiceAvailable voices are loaded dynamically based on the selected language. Each option shows the voice name and gender. Required.
PreviewPlay/pause button to audition the selected Polly voice.

NVIDIA Magpie (Multilingual)

Self-hosted NVIDIA Magpie text-to-speech.

FieldDescription
NIM Server (gRPC)host:port of the Magpie TTS NIM gRPC endpoint. Required.
VoiceMagpie voice name. Default: Magpie-Multilingual.EN-US.Aria. Required.
LanguageSynthesis language; should match the voice’s locale. Options: English (US), Spanish (Spain), German, French (France), Italian, Chinese (Mandarin), Hindi, Japanese, Vietnamese. Default: English (US).
Use SSLDefault: off. Leave off for a local NIM.
Model NameRiva/NIM model name. Default: magpie-tts-multilingual.

Language Model (LLM) Providers

Select the LLM provider using the LLM Provider dropdown at the top of the Language Model Configuration section.

Bedrock

FieldDescription
Client TypeAWS SDK client to use: Boto3 (default) or Langchain.
AWS RegionAWS region for the Bedrock service (e.g. us-east-1). Default: us-east-1.
Endpoint URL (Optional)Custom endpoint URL for private or on-premise deployments.
Model ProviderThe model provider, chosen from the LLM models enabled for the workspace.
Model IDThe model, chosen from the enabled models for the selected provider. To add models to this list, enable them under Integrations → LLMs.
TemperatureSampling temperature (0–2). Default: 0.3.
Max TokensMaximum tokens in the model’s response (1–10000). Default: 3000.
Enable StreamingStream responses token by token for lower latency. Default: on.
Enable StreamingStream the model response token-by-token for lower perceived latency. On by default.

Custom LLM1

FieldDescription
API KeyAPI key for the endpoint.
ModelModel identifier. Options: Custom Model1, Custom Model2.
TemperatureSampling temperature (0–2). Default: 0.
Max TokensMaximum tokens in the response (1–32000). Default: 1024.
Enable StreamingStream the model response. On by default.

Custom LLM2

FieldDescription
API KeyAPI key for the endpoint.
EndpointResource endpoint URL.
DeploymentDeployment name (e.g. gpt-4o).
Model NameModel name for the deployment (e.g. gpt-4o).
API VersionAPI version string. Default: 2024-02-15-preview.
TemperatureSampling temperature (0–2). Default: 0.3.
Max TokensMaximum tokens in the response (1–32000). Default: 1024.
Enable StreamingStream the model response. On by default.

NVIDIA Nemotron

An NVIDIA NIM endpoint serving a Nemotron model.

FieldDescription
Base URLOpenAI-compatible NIM endpoint. Must end in /v1. Required.
Model IDNemotron Nano 30B (nvidia/nemotron-3-nano-30b-a3b). Required.
API KeyOnly needed for NVIDIA’s cloud endpoint. Leave blank for a local NIM.
TemperatureSampling temperature (0–2). Default: 0.3.
Max TokensMaximum tokens in the response, including reasoning (1–32000). Default: 2048.
Enable StreamingDefault: on.

Custom LLM

A model registered with the Custom provider and enabled for the workspace. See LLM Management.

FieldDescription
ModelThe custom model to use, from the workspace’s enabled models. Required.
TemperatureSampling temperature (0–2). Default: 1.0.
Max TokensMaximum tokens in the response (1–32000). Default: 3000.
Enable StreamingDefault: on.

Phone Configuration Reference

See The Voice Agent Editor for the full Phone Configuration field list. Key parameters to note:

  • Auth Token vs API Keys — you must provide either an Auth Token, or both API Key SID and API Key Secret. Providing both sets is also valid.
  • Status Callback Events — any combination of Initiated, Ringing, Answered, Completed can be subscribed to independently.
  • Extra Parameters — arbitrary Twilio TwiML parameters can be passed as key/value pairs. Common examples include region (e.g. us1) and edge (e.g. sydney) for Twilio Global Low Latency routing.

Call Termination Reference

  • Terminate Call on Keyword — off by default. When enabled, the agent monitors transcribed speech for any of the configured keywords and hangs up the call when a match is detected.
  • Termination Keywords — entered as a comma-separated string (e.g. goodbye, bye, end call). Case-insensitive matching.