Differences

This shows you the differences between two versions of the page.

--- installation_guide:asterisk:start [2016/09/09 13:43] – [Configuration example] borja
+++ installation_guide:asterisk:start [2017/06/27 20:40] (current) – [Asterisk Global Variables] borja
@@ Line 1: / Line 1: @@
-====== Asterisk integration ======
+====== Voximal Asterisk integration ======
 ===== The Asterisk Module =====
@@ Line 138: / Line 138: @@
-==== Variables ====
+==== Voximal variables ====
 Variables to set before or filled after the Vxml() execution :
@@ Line 183: / Line 183: @@
   * VOXIMAL_ERROR=INTERPRETER ; Session refused, critical error with the VoiceXML browser connection.
-===== Examples =====
+==== Asterisk global variables ====
+You can set and get variable at any moment from the VoiceXML syntax using the <transfer> tag :
+** GET **
-Example use with an URL parameter:
 <code>
-[incoming]
+     <transfer name="getvar" bridge="true" dest="execute:get(ID)" />
-exten => s,1,Answer
+     <block>
-exten => s,n,Wait(3)
+       <prompt>
-exten => s,n,Voximal(http://localhost/vxml/index.vxml)
+         End of Transfer test <value expr="getvar$.value" />.
-exten => s,n,Hangup
+       </prompt>
+     </block>
 </code>
-Example to catch the Vxml() errors :
+** SET **
 <code>
-exten => _X.,1,Voximal()
+     <transfer name="toto" bridge="true" dest="execute:set(MOMO)=10">
-exten => _X.,n,NoOp(${VOXIMAL_ERROR})
+     </transfer>
-exten => _X.,n,GotoIf($["${VOXIMAL_ERROR}" == ""]?hangup)
-exten => _X.,n,Busy()
-exten => _X.,n(hangup),Hangup()
 </code>
 ===== Asterisk Online Help ======
 Online help can be accessed by typing the following command at the CLI prompt:
+<code>
 *CLI> help voximal
+</code>
 ===== CLI Management Commands ======
@@ Line 298: / Line 304: @@
 The following entries are the Asterisk CLI commands for the VoiceXML browser.
-===== Example ======
+===== Examples =====
 Add extensions to the Asterisk dial plan /etc/asterisk/extensions.conf:
+Example use with an URL parameter:
 <code>
-exten => 888,1,Answer
+[incoming]
-exten => 888,n,Wait(3)
+exten => 888,1,Answer
-exten => 888,n,Voximal(file:///root/example.vxml)
+exten => 888,n,Wait(3)
+exten => 888,n,Voximal(http://localhost/vxml/index.vxml)
 exten => 888,n,Hangup
+</code>
+Example to catch the Vxml() errors :
+<code>
+exten => _X.,1,Voximal()
+exten => _X.,n,NoOp(${VOXIMAL_ERROR})
+exten => _X.,n,GotoIf($["${VOXIMAL_ERROR}" == ""]?hangup)
+exten => _X.,n,Busy()
+exten => _X.,n(hangup),Hangup()
 </code>
@@ Line 339: / Line 357: @@
 </code>
+===== Load Balancer =====
+Example using the Dialplan and 4 different accounts (with differents ASR and TTS ressources).
+<code>
+exten => s,1,NoOp(Balancing)
+exten => s,n,Set(ACCOUNTMAX=4)
+exten => s,n,Set(TRIES=0)
+exten => s,n,Set(ACCOUNT=${RAND(1,${ACCOUNTMAX})})
+exten => s,n(retry),Set(TRIES=$[${TRIES} + 1])
+exten => s,n,Voximal(account${ACCOUNT})
+exten => s,n,ExecIf($["${VOXIMAL_ERROR}" = ""]?Goto(app-blackhole,hangup,1))
+exten => s,n,ExecIf($["${TRIES}" = "${ACCOUNTMAX}"]?Goto(app-blackhole,hangup,1))
+exten => s,n,Set(ACCOUNT=$[${ACCOUNT} + 1])
+exten => s,n,ExecIf($[${ACCOUNT} = ${ACCOUNTMAX}]?Set(ACCOUNT=1))
+exten => s,n,goto(s,retry)
+</code>
 ===== Troubleshooting (for Support) =====