Overview
Omni has capability to send Voice Messaging messages by utilising Call Control Objects.
Call Control Object is a combination of one or more Call Control Actions, together forming an object. Supported Call Control Actions are : audio stream, talk or input. Voice capability of AT&T GSMS Omni allows you to send voice orders with a combination of actions - an audio stream, text-to-speech, password and a key-press input option.
When Omni invokes a Call Control Object, associated actions will be played for the receiver. So a user can create a Call Control Object and include one or more action i.e. audio stream, talk (text-to-speech) or input options.
Call Control Object enables you to perform different combinations of these actions, providing you the ability to customize voice solution and send it to mobile or landlines devices as voice calls or to email addresses as separate attachments.
In order to send voice message through Omni, you
View Template Summary
•Login to the AT&T GSMS web portal.
•Select 'Voice' tab from the menu options in AT&T GSMS and click 'Call Control Object Summary'.
|
|
• You will be taken to the home screen as shown below:
Click an object name to view its details or one of the following icons (if available):
|
Create or Edit Templates
•Click New button to create a new Call Control Object or click on existing templates to edit them. We've explained steps to create a new Call Control Object with all call control actions. User may customize the Call Control Objects as per their needs.
•Once you are on Call Control Object creation page, enter Name and Description of the Call Control Object and click Save.
Name |
Enter a short and unique name for the Call Control Object. |
Description |
Enter an optional description to identify the Call Control Object. |
3. As soon as CCO is saved, window will display a Call Control Actions section, with a plus 
icon on its menu bar.
Add Call Control Actions
For our example, we will set three actions - STREAM, TALK and INPUT. We intend to get the following voice outcome:
a) Welcome message playing audio file, using STREAM
b) Typed in text will be read out, asking users to enter the PIN, using TALK
c) Users must enter the PIN , using INPUT
1. Now let's add the action to the object we just created in the above section. Click on button on Call Control Actions menu-bar and begin creating your action :
Below fields appear on the screen:
Sequence Number |
Indicates the sequence of the call control action. For example, the action with sequence 1 will be executed before sequence 2. The action types must be arranged in the right sequence for the IVR to generate an expected outcome.
|
Action Type |
Sending a voice request with a call control object ID will invoke the object and the linked call control action. Linked action could be one of the following:
•Input - Allows users to enter digit inputs and sends back to the system for recognition.
•Stream - Allows you to select a pre-recorded audio file in mp3 or wav format
•Talk - Reads the text content as typed in by the user. Password text can be customized so that it can be read with case-sensitive pronunciation.
Important: Input should always be the last action type. Any action added after Input is not recognised by the system. |
2. Click on Action Type drop down menu to see below options:
3. Select Stream as Action Type. On selection of Stream as Action Type, following fields appear on the screen:
Barge In |
Allow users to interrupt voice audio in the call in between by pressing a button on the keypad. Options:
•True - Allows recipients to stop the audio from playing any further by pressing a button the keypad •False - Default, Recipient cannot stop the audio from playing unless it finishes by itself
This option is particularly useful to the recipients when the audio played is familiar to them. Note that if this field is set to True, the next Call Control Action must be Input.
|
Play Message |
Number of times action is repeated before executing the next action. Options:
•Indefinitely •Once (default) •Twice •Three times
|
Volume Level |
Volume level of the played speech. Options:
•Low •Medium (default) •High
|
Upload File |
Upload the audio file that needs to be played in the voice call. Supported formats include MP3 and WAV. Please ensure that file is readily available on your local drive while setting up the stream - call control action.
|
Note that all above fields are optional and if not set, defaults values will be processed by the system.
Once you have added the fields as explained above, hit Save icon on the Call Control Actions menu-bar. Call Control Action with Stream gets saved:
4. Now let's setup next action item. Repeat step 1 & 2 and move to step 5.
5. Select Talk as Action Type. On selection of Talk as Action Type, following fields appear on the screen:
Text* |
Add the text that would be converted to voice on the call. Maximum limit:1500 characters. A comma in the text will add a short pause in the call.
Please note, if 'Add Password' check-box is enabled, this text will be util<%IS%>ed as text spoken before the password.
|
Add Password |
Enable the check-box to provide password text. If this parameter is enabled, below options appear on the screen:
•Password: Type in the password that needs to be spoken over the voice call •Text After Password: Type in the text that needs to be spoken after the password •Password Spoken Speed: Enter the speed of speech for password text. Options : Normal, Slow & Extra Slow(default).
|
Barge In |
Allow users to interrupt voice audio in the call in between by pressing a button on the keypad. Options:
•True - Allows recipients to stop the audio from playing any further by pressing a button the keypad •False - Default, Recipient cannot stop the audio from playing unless it finishes by itself
This option is particularly useful to the recipients when the audio played is familiar to them. Note that if this field is set to True, the next Call Control Action must be Input.
|
Play Message |
Number of times action is repeated before executing the next action. Options:
•Indefinitely •Once (default) •Twice •Three times
If you select option other than Once, system providing optional field for adding 'Repeat Message Interval'. This option would let you add intervals between repeated messages. Available options are :
•1 second •2 seconds •3 seconds •4 seconds •5 seconds •10 second
Note - Repeat message interval option is only available for Talk. |
Volume Level |
Volume level of the played speech. Options:
•Low •Medium (default) •High
|
Gender |
Select male or female voice.
|
Language |
Select language options - Spanish, Portuguese or English (default).
Please note, text typed in English will not be converted to Spanish automatically. Sender must select appropriate language options, compatible to the text characters.
|
Spoken Speed |
Enter the speed of the speech. Options:
•Normal(default) •Slow •Extra Slow
|
Note that apart from Text, all above fields are optional and if not set, defaults values will be processed by the system.
Once you have added the fields as explained above, hit Save icon on the Call Control Actions menu-bar. Call Control Action with Talk option gets saved:
Notice the sequence number in each Call Control Action. When a voice call is triggered with a this object, the actions configured inside them will be executed in the sequence order.
6. Now let's setup last action for this Call Control Object. Repeat step 1 & 2 and move to step 7.
7. Select Input as Action Type. On selection of Input as Action Type, following fields appear on the screen:
Time out |
Result of the callee's activity is retrieved seconds after the last action. Options:
•3 seconds (default) •10 seconds •15 seconds •20 seconds
|
Maximum Digits |
Number of digits a recipient can press on keypad. Maximum value supported- 20. Default number of digits - 4.
|
Submit On Hash |
Enable this option to give control to the recipient to send their inputs by pressing hash ( Number). If this option is disabled, result will be sent out after Time out value. Options:
•True •False
|
Note that all above fields are optional and if not set, defaults values will be processed by the system.
Once you have added the fields as explained above, hit Save icon on the Call Control Actions menu-bar. Call Control Action with Input option gets saved:
Notice the sequence number in each Call Control Action. When a voice call is triggered with a CCO object, the actions configured inside the CCO will be executed in the same sequence.