Skip to main content

​
Overview

Voice agents may occasionally mispronounce certain words — especially proper nouns, brand names, street names, or Hebrew words with ambiguous pronunciation (Hebrew is written without vowels, so one spelling can be read several ways). Pronunciation groups let you define overrides once and reuse them across agents. A pronunciation group is a named list of overrides. It belongs either to your account (any of your agents can use it) or is global (managed by Voicy, available to every account). An agent uses a group by attaching it; a global group can also be pinned to all agents, in which case every agent gets it without attaching anything.
Pronunciation overrides apply to every agent — both agent types run the chained Speech-to-Text → LLM → Text-to-Speech pipeline.

​
Format

An override is niqqud-pointed Hebrew — the same vowel points used to disambiguate Hebrew in print. Each entry pairs a phrase with its pointed form: Both Text-to-Speech engines (Soniox and Gemini) read this one format, so an override keeps working if you change the agent’s voice.

​
How to Use

  1. Go to your agent’s settings in the dashboard
  2. Open the Pronunciation section — it lists the groups attached to this agent
  3. Click + Add group to attach an existing group or create a new one for your account
  4. Tap a group to open it, then + Add phrase to add an entry: the Hebrew phrase, then its niqqud-pointed form
  5. Press ▶ to hear it in the agent’s own voice before saving
  6. Save — the change takes effect on the next call of every agent that uses the group

​
Priority

Groups are listed in priority order: when two groups define the same phrase, the group higher in the list wins. Drag a group to reorder it. Pinned global groups always sit at the bottom, so your own groups override them. The section footer shows how many phrases are shadowed by a higher group, so you can see when an override is not taking effect.

​
Tips

  • Only add mispronounced words — most Hebrew words are pronounced correctly by default
  • Group by topic — for example, one group of street names shared by every agent in a city, and one per agent for its own brand names
  • Test after adding — make a test call to verify the pronunciation improved
  • Iterate — if the first override doesn’t sound right, try a different one
  • Include meaning for homographs — if a word has multiple readings (like שקל), add separate entries with context in the phrase field (e.g., “שקל מטבע” and “שקל פועל”)

​
Generating Overrides

If you’re unsure how to write the override: nakdan.dicta.org.il adds vowel points to plain Hebrew text. The dashboard links to it directly under the override field.

​
How It Works

The phrase is replaced with its niqqud-pointed form before the text reaches the Text-to-Speech engine, which renders the vowel points. Because this is a deterministic text substitution (not a hint to a model), an override applies on every utterance where the phrase appears. Groups are resolved when a call starts, so editing a group never requires re-saving or re-deploying the agents that use it.

​
Limitations

  • Works best for proper nouns, brand names, and uncommon words
  • Common Hebrew words are usually pronounced correctly without overrides
  • An override only applies when the phrase appears exactly as written in the phrase field, and as a separate word — a Hebrew prefix or suffix glued to it (בוויסי, וויסים) will not match
  • Niqqud cannot express stress, so a word whose only problem is which syllable is stressed cannot be fixed this way
  • Maximum 200 entries per group