Skip to content

Manage Sound Files & Languages

Sound Languages manages the system prompt sound packs UnifiedBX uses — the voice that says "please enter the number," "the user is unavailable," etc. Default is en-US (English, female). Add other languages or higher-quality voices.

Steps

Install a sound pack

  1. Go to System Admin → Sound Languages.
  2. The page lists installed packs and available downloads.
  3. Click Install next to a desired pack:
    • English variants (US, Australian, UK).
    • Spanish, French, German, etc.
    • Premium "core sounds" packs at higher bit rates.
  4. Wait for download/install to complete.
  5. Click Apply Config.

Set system default language

  1. Go to System Admin → Advanced Settings.
  2. Search for Default Language.
  3. Set to the locale code, e.g. en (US English), es (Spanish), fr (French).
  4. Save → Apply Config.

Per-extension language

  1. User Attributes → Extensions → click extension → Other tab.
  2. Language dropdown — pick.
  3. Submit → Apply Config.

The user now hears system prompts in the chosen language.

Per-DID language

  1. Trunk Attributes → Inbound Routes → click the route → Other tab.
  2. Language — pick.
  3. Submit → Apply Config.

The caller's session uses this language for system prompts.

Verify

Call into the IVR or trigger a system prompt (e.g. dial an unmonitored extension and let it go to "the user is unavailable"). Confirm the prompt language matches.

ls /var/lib/asterisk/sounds/<lang>/
# Should show the language's sound files.

Common Issues

  • Language installs but plays English. The extension or route still has Default (which is English). Set explicitly.
  • Custom recordings still in English even with language set. System Recordings are language-agnostic by default — they play whatever was uploaded. To localize, upload separate recordings per language and reference them in language-aware modules.
  • Premium sound pack expired. Some commercial packs require a license. Check Module Admin activation.
  • Sound pack download fails. Outbound HTTPS to Sangoma blocked. Check firewall.
  • Disk full after installing many packs. Sound packs can be 100+ MB each. Remove unused.