This is an old revision of the document!
Configuration of Voximal
All the configuration is managed throw a web interface based on the FreePBX project.
To access to the web interface, open the link http://your_server_address
.
It's protected by a login.
Login
After installation there are 3 default login, with differents access permissions
- user : access to Voximal configuration and reports.
- admin : user access and network configuration
- root : all access.
Each login has a default login, that can be updated with the root account.
– add screenshot –
Configuration steps
To configure the Voximal IVR you have 3 steps to do :
- Configure the operator access (SIP accounts)
- Create VoiceXML service (VoiceXML service)
- Create Voximal accounts (Voximal accounts)
- Configure the relation between the DID and the VoiceXML service you want to use (Routes configuration)
WARNING: On each configuration page, don't forget to click on Submit
button at the bottom page before changing page. If you don't click on Submit
you'll lose all your changes.
SIP accounts
You can create a SIP trunk with an operator with the page Connectivity/SIP Accounts. You have to enter informations :
- A trunk name : a string to identify you accounts
- The peers details : enter all trunk informations (host, username, password, type)
host=myprovider.com username=0033123456789 type=peer
- Register informations : enter registry informations like :
0033123456789:password@myprovider.com/33123456789
- Click on submit button
– add screenshot –
VoiceXML service
You have to create VoiceXML services, by uploading it or writing it directly with embedded editor.
Uploading VoiceXML service
In page Applications/Voximal click on Editor
tab.
At the end of the page, you have the way to upload files :
- Click on
Browse
and select your file - Then click on
Upload
. You file will appear in list.
Create VoiceXML service with editor
You can update VoiceXML file (extension .vxml
), by clicking on the filename. The file content will appear, and you'll be able to update it, and check the syntax.
The editor page allow to create folders and files, and edit them.
To create folders or files, click on right items on top right corner (Create Directory
or Create File
).
Then enter filename, and click Create button
.
– add screenshot –
Voximal accounts
When your VoiceXML services are ready, you have to define it in the IVR.
To do it, add Voximal applications. Click on Applications/Voximal
menu item.
To create a Voximal Application, you have to define in minimum 2 required informations :
- An application name, in field
Name
- The VoiceXML url of the service, in field
URL
. You can select a local one, in the list or writing a local or HTTP one.
There are several options :
- Max sessions : you can define a specific limit, if you want lower maximum session than the license.
- Dial format : you can define a specific dialout format for outgoing calls.
- Mark : you can define a specific mark, that will appear in traces.
- Speech : you can specify the use of the ASR. In case of using ASR server, the better way is to set
Automatic
choice. - Max time : you can set a maximum duration of call. If not setted or equals to 0, the duration is unlimited.
- Vxml parameter : you can set a string to pass it to vxml script.
- Star delay : you can set a time delay to start the service.
– add screenshot –
Routes configuration
Firstly, you have to define which application you want to use by default for all incoming calls.
It's done by defining the any DID/any CID
or All DIDs
settings in Connectivity/Routes
page.
- Select
All DIDs
item (on top right corner) - Leave empty Field
DID Number
- Select the application to use :
Voximal Application
- You can select an existing application
- Or create a new one by clicking “Add new
Voximal application
”
- Click on submit button
– add screenshot –
Configuration files
- /etc/voximald.conf
- /etc/asterisk/voximal.conf