Source: https://vaultcrmhelp.veeva.com/doc/Content/CRM_topics/VeevaAI/VoiceDictionary.htm

## Voice Dictionary Entries

To ensure AI agents correctly recognize and transcribe specific pronunciations—for example, unique product names, abbreviations, and regional or company-specific phrases. These entries can be applied across the Vault CRM instance or applied only to specific user languages and countries.

Veeva's AI agents natively transcribe standard medical terms and common proper nouns without requiring a specialized medical dictionary; however, abbreviations, unique brand names, and abbreviations-as-proper-nouns are not automatically recognized and must be added as a Voice Dictionary Entry to ensure accurate transcription.

**Who can use this feature?**

* Business Admin Users - Browser
* [Creating Voice Dictionary Entries](#Creating)
* End Users - iPad, iPhone
* [Using Custom Pronunciations](#Using)
* A Vault AI license is required

### Configuring Voice Dictionary Entries for

[![Closed](../../../Skins/Default/Stylesheets/Images/transparent.gif)Business Admin Users](#)

To configure this feature:

1. Ensure [Configuring Vault AI in CRM](Configuration.htm) is complete.
2. Navigate to **Admin > Users & Groups > Permission Sets**.
3. Select the appropriate permission set.
4. Select the **Objects** tab.
5. Grant the following permissions:

   | Object | Object Permission | Object Types | Fields | Field Permission |
   | --- | --- | --- | --- | --- |
   | voice\_dictionary\_entry\_\_v | CRED | core\_object\_type\_\_v | * country\_\_v * language\_\_v * name\_\_v * phrase\_\_v * pronunciation\_\_v | Edit |

[![Closed](../../../Skins/Default/Stylesheets/Images/transparent.gif)End Users](#)

To configure this feature:

1. Ensure [Configuring Vault AI in CRM](Configuration.htm) is complete.
2. Navigate to **Admin > Users & Groups > Permission Sets**.
3. Select the appropriate permission set.
4. Select the **Objects** tab.
5. Grant the following permissions:

   | Object | Object Permission | Object Types | Fields | Field Permission |
   | --- | --- | --- | --- | --- |
   | voice\_dictionary\_entry\_\_v | R | core\_object\_type\_\_v | All Fields | Read |
6. Navigate to **Business Admin > Objects > vmobile\_object\_configuration\_\_v**.
7. Ensure **voice\_dictionary\_entry\_\_v** VMOCs are active for the appropriate platforms.

### Creating Voice Dictionary Entries as

[![Closed](../../../Skins/Default/Stylesheets/Images/transparent.gif)Business Admin Users](#)

To create Voice Dictionary Entries for custom pronunciations:

1. Navigate to **Business Admin > Objects > voice\_dictionary\_entry\_\_v**.
2. Select **Create**.
3. Populate the **Phrase** field with the phrase or word’s written spelling. For example, Natevba.
4. Populate the **Pronunciation** field with the phrase or word’s pronunciation, using the [X-SAMPA Transcription Scheme](https://chromium.googlesource.com/chromiumos/third_party/espeak-ng/+/HEAD/docs/phonemes/xsampa.md).
5. Select a **Language** and/or **Country** for the entry (optional):

* Languages are matched to the language\_\_sys field on the user’s user\_\_sys record. If a language is not selected on the Voice Dictionary Entry, the entry applies to all user languages.
* Countries are matched to the country\_\_sys field on the user\_\_sys record. If a country is not selected on the Voice Dictionary Entry, the entry applies to all user countries.
* If both the Language and the Country fields are left blank on a Voice Dictionary Entry, the entry applies to all languages and countries

6. Select **Save**.

Each entry includes:

* Phrase – The written spelling of the word or phrase (for example, Natevba)
* Pronunciation – The word’s pronunciation, written using the [X-SAMPA Transcription Scheme](https://chromium.googlesource.com/chromiumos/third_party/espeak-ng/+/HEAD/docs/phonemes/xsampa.md), a standardized way to represent speech sounds using plain text characters

X-SAMPA (Extended Speech Assessment Methods Phonetic Alphabet) provides a device-independent way to specify pronunciations. It ensures consistency across regions and languages, even when device or platform-level phoneme support differs.

For example, in an organization with product names like Cholecap, Restolar, and Natevba, an admin would populate the Phrase and Pronunciation on a Voice Dictionary Entry as follows:

| Phrase | Pronunciation (X-SAMPA Transcription) |
| --- | --- |
| Cholecap | k"ol@k{p |
| Restolar | r"Est%olAr |
| Natevba | n"OtEvbO |

Because iOS phoneme support varies by region and device, some X-SAMPA symbols may not be supported everywhere. Vault CRM does not validate phoneme compatibility, so unsupported symbols may result in incorrect or unrecognized pronunciations.

Veeva recommends testing the Voice Dictionary Entries with end users who reflect the full range of accents, dialects, and languages in use before making agentic AI dictation capabilities, available to all users.

### Using Custom Pronunciations as

[![Closed](../../../Skins/Default/Stylesheets/Images/transparent.gif)End Users](#)

When users’ speech matches the Pronunciation value on a Voice Dictionary Entry, the AI agent uses the specified Phrase text to accurately transcribe the sound. Voice Dictionary Entries apply for the following AI functionalities:

* [Agentic Voice](VoiceAgent/VoiceAgentOverview.htm)
* [Agentic Insight Capture](InsightCaptureAgent/InsightCaptureAgentOverview.htm)

### Related Topics

[Agentic Voice Overview](VoiceAgent/VoiceAgentOverview.htm)

[Agentic Insight Capture Overview](InsightCaptureAgent/InsightCaptureAgentOverview.htm)