Configuring the Voice Agent
Configuring the Voice Agent for
To configure the Voice Agent:
-
Ensure Configuring Veeva AI for Vault CRM is complete.
-
Ensure users have Execute permission to the Voice Agent:
- Navigate to Admin > Users & Groups > Permission Sets
- Select the appropriate permission set
- Select the Agents tab
- Select the Execute check box for the Voice Agent (voice_agent__v)
-
Select the Objects tab.
-
Grant the following permissions:
Object
Object Permission
Object Types
Fields
Field Permission
voice_dictionary_entry__v
R
core_object_type__v
All Fields
Read
-
Navigate to Business Admin > Objects > vmobile_object_configuration__v.
-
Ensure voice_dictionary_entry__v VMOCs are active for the appropriate platforms.
Creating Voice Dictionary Entries
To ensure the Voice Agent correctly recognizes and transcribes specific pronunciations—for example, product names, medical terms, and regional or company-specific phrases—admin users create Voice Dictionary Entries. These entries can be applied across the Vault CRM instance or applied only to specific user languages and countries.
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, 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.
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.
To create Voice Dictionary Entries for custom pronunciations:
-
Navigate to Business Admin > Objects > voice_dictionary_entry__v.
-
Select Create.
-
Populate the Phrase field with the phrase or word’s written spelling. For example, Natevba.
-
Populate the Pronunciation field with the phrase or word’s pronunciation, using the X-SAMPA Transcription Scheme.
-
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
-
Select Save.

