...
Detailed instructions are beyond the scope of this wiki, but there are two general ways to change the language in a call flow.
Using the Languages module (not to be confused with the Sound Languages module), you can dynamically change the language used, anywhere in the call flow.
Many other modules have the option to change the language. Look for a "Languages" option, and visit the module-specific wiki for more information. For example, in the inbound routes module, you can set a language for a specific DID. If the French language is installed (confirmed by checking the Sound Languages module), you can choose French for the inbound route. Sound prompts would then be played in French for calls inbound to this DID, and this selection would carry over to other points in the call flow unless it is changed later in the flow.
...
Available Language Packs
The following languages are available as built-in options at the time of this writing:
...
Log into the PBX GUI.
In the top menu go to Admin
In the drop down menu go to Sound Languages
...
How to Install and Remove Language Packs
When you arrive at the Sound Languages module, the Language Packs section is shown by default. Otherwise you can select it from the options at the right.
This screen displays a list of languages. (Note the list may be several pages long). Here is what the columns mean:
Module: core-sounds or extra-sounds
Language: The name of the language and its language code (i.e. "en" for English)
Format: The codec (i.e. alaw, g722, g729, or ulaw)
Available: The latest available verison
Installed:The version installed on your system, if any
Actions: A button to install or remove the language
= Download 
- = Remove
...
...
To Install: Click the download button:
To Remove: Click the remove button:
When finished, click the Apply Config button to apply your changes.
...
How to Set the Global Language
From the options at the right, click the Global Language option to navigate to that section.
Select a language from the drop-down menu.
Click the Submit button.
Click the Apply Config button.
How to Define a Custom Language
...
After you have defined a custom language, you can upload your own custom language recordings. You can also upload files via System Recordings and the CLI.
From the options at the right, click the Custom Languages option to navigate to that section.
Click the +Add New Custom Language button.
This is what the Add Custom Language section looks like.
Enter the Language Code (for example we're calling this "pi" for Pirate) and a brief Description to help you identify this custom language. This name will appear in other modules where you can select a language.
Here you can upload your custom language recordings. Either Browse your computer or Drag and Drop Multiple Files or Archives. Supported upload formats are: WAV, aiff, alaw, flac, g722, gsm, mp3, oga, ogg, sln, sln12, sln16, sln192, sln24, sln32, sln44, sln48, sln96, ulaw, wav, wav16, tgz, gz, tar, zip. This includes archives (that include multiple files, such as tar,gz,zip) and multiple files. If uploading an archive, the main sound files must be in the root of the archive with individual folders such as 'digits' and 'silence' as appropriate.
Once your file(s) is uploaded, the blue progress bar will be full and File to Upload will populate with the corresponding number of files.
Lastly check all file formats you would like this system recording to be encoded into.
Click the Submit button and a progress bar will let you know when you're finished.
.jpg?version=1&modificationDate=1705417758559&cacheVersion=1&api=v2&width=154)
Your new custom language will show up in a list. You can click the pencil button
to edit or the trash button to delete.
Additional Ways to Add Custom Recordings
If you SSH into your PBX and go to /var/lib/asterisk/sounds, you will see a directory with the name of the language code you entered earlier. In our example we see "pi" for "Pirate" in addition to the built-in English (en), Spanish (es), and French (fr) language packs on our system.
Another way to add sounds to your new language directory is to use the System Recordings module. If you do this, your new sounds will be placed inside a "custom" directory within the specific language directory. See the System Recordings Module User Guide for more information.
| Info |
|---|
If you have selected a custom language at a point in the call flow, but a required sound file is not available, the system will revert to the global language defined in the Sound Languages module for that sound prompt. |
...