When sending Text to Speech messages, you may specify SSML commands to customize how words are robotically spoken.
For example:
| Input | Output |
|---|---|
| "Hello, your account code A148271 is overdue by $500. Contact us to resolve." | "Hello, your account code A-one hundred and forty eight thousand, two hundred and seventy-one is overdue by $500. Contact us to resolve." |
| "Hello, your account code <spell>A148271</spell> is overdue by <currency>$500</currency>. Contact us to resolve." | "Hello, your account code A-one-four-eight-two-seven-one is overdue by five hundred dollars. Contact us to resolve." |
A list of available commands:
| Command | Example | Explanation |
|---|---|---|
| <address> | The meeting will be held at <address>5 Smart Way, Auckland</address> | Reads text as a street address |
| <telephone> | You can contact us on <telephone>0800 555 333</telephone> | Reads text as a telephone number |
| <spell> | Your reference number is <spell>916483</spell> | Spells each character individually |
| <time> | Your appointment is booked for <time>5:45</time> | Reads text as hour:minutes |
| <date> | Your appointment is booked for <date>2021-12-25</date> | Reads text as a date (input is year-month-day) |
| <date:dmy> | Your appointment is booked for <date>25-12-2021</date> | Reads text as a date (input is day-month-year) |
| <date:mdy> | Your appointment is booked for <date>12-25-2021</date> | Reads text as a date (input is month-day-year) |
| <date:ymd> | Your appointment is booked for <date>2021-12-25</date> | Reads text as a date (input is year-month-day) |
| <number> | Your reference number is <number>916483</number> | Spells each digit individually |
| <fraction> | Special offer, <fraction>1/2</fraction> price, today only | Reads a fraction as a word (1/2 = half) |
| <cardinal> | Your current account balance is <cardinal>54.23</cardinal> | Reads text as a cardinal number (54.23 = fifty-four) |
| <ordinal> | You are the <ordinal>4th<ordinal> caller! | Reads text as an ordinal number (fourth) |
| <loud> | Please call us back <loud>now</loud> | Increases the speaking volume |
| <soft> | Thanks for calling, <soft>putting you through now</soft> | Decreases the speaking volume |
| <fast> | Thank you. <fast>Terms and conditions apply.</fast> | Increases the speaking speed |
| <slow> | <slow>Contact us today</slow> to lock in this special | Decreases the speaking speed |
| <speed:60> | I sound <speed:60>very robotic</speed:60> | Decreases the speaking speed to 60% |
| <speed:70> | I sound <speed:70>like a robot</speed:70> | Decreases the speaking speed to 70% |
| <speed:80> | I sound <speed:80>slightly slower</speed:80> | Decreases the speaking speed to 80% |
| <speed:90> | I sound <speed:90>a bit slow</speed:90> | Decreases the speaking speed to 90% |
| <speed:110> | I sound <speed:110>a bit fast</speed:110> | Increases the speaking speed to 110% |
| <speed:120> | I sound <speed:120>quite fast</speed:120> | Increases the speaking speed to 120% |
| <speed:130> | I sound <speed:130>very quick</speed:130> | Increases the speaking speed to 130% |
| <speed:140> | I sound <speed:140>extremely fast</speed:140> | Increases the speaking speed to 140% |
| <break/> | Hello <break/> thank you for taking this call | Adds a one second pause |
| <break:1/> | Call back <break:1/> at a time that suits you | Adds a 100 millisecond pause (0.1 seconds) |
| <break:2/> | Call back <break:2/> at a time that suits you | Adds a 200 millisecond pause (0.2 seconds) |
| <break:3/> | Call back <break:3/> at a time that suits you | Adds a 300 millisecond pause (0.3 seconds) |
| <break:5/> | Call back <break:3/> at a time that suits you | Adds a 500 millisecond pause (0.5 seconds) |