Objective
This article helps you map a specific locale to a Text to Speech provider and voice, so that calls in that locale always use the voice you choose without naming it in your TwiML.
Product
Programmable Voice
Environment
Twilio Console
User Account Permission/Role(s) Required
Read access to your account's Text to Speech settings is required to open the page. Creating a mapping requires update access to Voice settings.
Procedure
- In the Twilio Console, select Communications in the left sidebar.
- Select Voice, then Settings.
- Select the Text to speech tab.
- In the Language mapping section, select Create Language Mapping.
- In the Create locale mapping dialog, under Voice settings, choose a Provider. The available providers are Amazon Polly, Google Text-to-Speech, and Basic.
- Choose a Language. Each option shows the language name followed by its locale code, for example English (US) (en-US).
- Choose a Voice. The list shows only the voices the selected provider offers for that language, with each voice's gender.
- Select Save. A confirmation message reads "Locale mapping saved successfully" and the new row appears in the Language mapping table.
Additional Information
- Provider, Language, and Voice are all required. Save stays unavailable until each one is filled in.
- Changing the provider clears the language and voice selections when the language you picked is not offered by the new provider.
- If a mapping already exists for the locale you choose, saving replaces it rather than adding a second row.
- Select Cancel to close the dialog without saving. Nothing is added to the table.
- If the mapping cannot be saved, an error message reads "Failed to save locale mapping. Please try again later." Retry the save.
This content was generated by AI and reviewed, edited, and verified by a human.