To use your license key, you will need to download the Digium registration utility from http://downloads.digium.com/pub/register to your Asterisk server.
Give the utility execute permission and run it. Make sure you are logged in as the root user while performing this operation.
chmod +x register ./register
For details, refer to the installation instructions included in your license key email.
This can be verified by issuing cepstral show licenses in the Asterisk CLI. For example:
*CLI> cepstral show licenses
Cepstral Licensing Information
==============================
Allison Voice Enabled: yes
Total licensed ports: 14
In your dialplan, execute
Set(VOICE=Allison-8kHz)
Then use the SayText or SayFile diaplan applications to have res_cepstral play back text using Allison's voice.
Using the SayText diaplan application:
[Synopsis]
Say Text using Cepstral Engine
[Description]
SayText(text[|options])
Says the text 'text' using the Cepstral TTS engine
and returns -1 on hangup or 0 otherwise. If option 'i'
is specified, the user may interrupt the text with
a digit, and it will be intepreted as the beginning of
an extension. If the option 'n' is specified, the line
will not be answered if it isn't up.
Using the SayFile diaplan application:
[Synopsis]
Speak file using Cepstral Engine
[Description]
SayFile(file[|options])
Says the file 'file' using the Cepstral TTS engine
and returns -1 on hangup or 0 otherwise. If option 'i'
is specified, the user may interrupt the file with
a digit, and it will be intepreted as the beginning of
an extension. If the option 'n' is specified, the line
will not be answered if it isn't up.
Example diaplan code:
[default]
exten => 123,1,Set(VOICE=Allison-8kHz)
exten => 123,n,SayText("Thank you for buying the Allison Cepstral
voice")