Skip to content

Voice and speech synthesis

On every call the assistant runs a three-model chain (runtime.engine: cascade): speech recognition (STT) turns the customer’s voice into text, the language model (LLM) writes the answer, and speech synthesis (TTS) speaks it. Each has a primary and an optional fallback provider; if the primary fails, the fallback takes over.

Built-in values of the general e-commerce template:

StagePrimaryFallback
Speech recognitionDeepgram nova-3, language trOpenAI gpt-4o-mini-transcribe
Language modelOpenAI gpt-5.6-lunaOpenAI gpt-4.1-mini
Speech synthesisElevenLabs eleven_turbo_v2_5OpenAI gpt-4o-mini-tts
Semantic searchOpenAI text-embedding-3-small—

The voice fallbacks use a separate provider: if ElevenLabs or Deepgram can’t be reached (e.g. the quota runs out), the assistant doesn’t go silent; it continues with OpenAI. The fallback voice sounds different from the primary voice.

Anthropic Claude can also be selected as the language model (runtime.llm.provider: anthropic; e.g. claude-haiku-4-5, claude-sonnet-5-5). The platform admin changes the model. All of these providers are outside Turkey (US; US/EU for ElevenLabs), so call data is transferred abroad. Privacy and retention →

FieldDefaultLimitMeaning
voice_id—requiredVoice ID from the ElevenLabs panel
speed1.0 (template: 1.08)0.7–1.3Speaking rate
seed2026—Fixed seed so the same text sounds the same every time
chunk_length_scheduleempty—When empty, text is spoken sentence by sentence. If chunk sizes are given, text is sent in those sizes
pronunciations{}up to 200 entriesPronunciation dictionary
fallback——Fallback voice model

Text sent to the voice first goes through the Turkish transform: prices, phone numbers, percentages, capacity and inch values, part codes, order numbers, numbers and number ranges are written out as words; email and web addresses are made readable. Then the pronunciation dictionary is applied. The transcript always keeps the original text.

FieldDefaultLimit
temperature0.5 (template: 0.4)0–2
max_tokens500 (template: 400)16–4096
service_tierpriorityOpenAI only
reasoning_effort—none, minimal, low, medium, high
verbosity—low, medium, high

The language is tr. Keyterms are passed to speech recognition as hints so product and brand names are heard correctly.

In Settings → Integrations you can enter your own API key for OpenAI, Anthropic (Claude), ElevenLabs and Deepgram. If the field is left empty, the platform key is used. Keys are stored encrypted and never shown again; the console only shows the last four characters (••••1234).

If Voice selection is on in your plan, admins pick the voice from the platform’s voice catalog in Assistants → assistant → Voice. They set the speed (0.85–1.15) and the volume (−6 to +12 dB) and use Listen to hear the greeting in the chosen voice. Changes are saved as a draft first; publishing creates a new version.