Email pronunciation
# support
d
I have been facing email issue. The agent doesn't pronounce the email right. For example - abc123@gmail.com It pronounces - abc minus 1 minus 2 minus 3 d gmail dot com.
v
To fix the email pronunciation issue, enable SSML parsing in your Vapi agent configuration:
Copy code
bash
curl -X PATCH https://api.vapi.ai/assistant/YOUR_ASSISTANT_ID \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "voice": {
         "provider": "11labs",
         "enableSsmlParsing": true
       }
     }'
After enabling SSML, you can control how numbers are pronounced by using the
<say-as>
tag in your agent's responses. Sources: - [Discord Channel](https://discord.com/channels/1211482211119796234/1296031572956549171) - [Discord Channel](https://discord.com/channels/1338644573207007304)
e
Ask the Ai to read the email in natural languages
d
I am using the dashboard to create and configure the agent. How to should I enable ssml?
k
Vapi TTS may mispronounce email addresses, so improve accuracy by spelling them out, replacing symbols with words like "at" for "@", or capturing them via text instead.
d
When I request for confirming the email, at for @ is fine, but it spells out number in the email as minus 1, minus 2 for '1', '2'.
s
I’m seeing the same issue. In my customer calls, it is reading out numbers as minus 1, minus 2 instead of just 1 and 2
e
@Dev Shah @Shraddha In your prompt, ask the assistant to read the numbers. Add this. When confirming an email like
john123@example.com
, say: "john one two three at example dot com".
d
Got it will try that! Thanks
e
Also Check the Voice Formatting Plan settings, specifically the number-to-digits cutoff and any substitution rules
d
But like because many email ids are quite complex like - azerrox289@example.com its pronounced the entire word and misspells it.
So I should provide 3 instructions - 1. Spell out the email letter by letter 2. replace symbols with words like '@' as 'at' 3. numbers as words like '1' as 'one' So example - johnrocks123@example.com should be pronounced as j o h n r o c k s one two three at e x a m p l e dot c o m Is this the better approach?
Where can I find it and how can I change it?
e
Look for the System Prompt field (under the assistant’s behavior or prompt settings). Find the Voice Formatting Plan or Substitutions section (often under advanced settings or voice configuration) to add rules for symbols and numbers.If you don’t see these options, they may be nested under the assistant’s model or voice settings (e.g., TTS provider settings like PlayHT or ElevenLab Also if you're using vapi API, to manage assistants, retrieve the assistant’s configuration with a GET /assistant/{id} request, update the systemPrompt and voice.formatting.substitutions fields, and save changes with a PATCH /assistant/{id} request.API documentation is available at docs.vapi.ai.
Add this prompt. When confirming an email address, follow these rules: 1. Read the local part (before '@') and the domain (after '@', including subdomains and top-level domain) naturally as words or phrases, pronouncing them as they sound (e.g., 'johnrocks' as 'john rocks', 'example' as 'example', 'com' as 'com'). 2. Pronounce '@' as 'at' and '.' as 'dot'. 3. Pronounce numbers as their word form (e.g., '1' as 'one', '2' as 'two'). For example,
johnrocks123@example.com
should be read as: "john rocks one two three at example dot com".
c
Hey Dev Shah, checking if this is resolved/solved for you?
d
Ill test it today and will respond. Thank you
Email is working fine now
Thank you so much
c
No problem!
2 Views