Making an outbound telephone call

To make an outbound telephone call, your CCXML document must use a <createcall> element within a <transition> element.

For example, within a ccxml.loaded transition:

<transition event="ccxml.loaded">
  <!--Place an outbound call -->
  <createcall dest="'tel:+441234567890'"/> 
</transition>

Refer to the Blueworx Voice Response for AIX: Deploying and Managing VoiceXML and Java Applications information for information on using telephone URLs.

To make an outbound telephone call to a specific Channel Group, use a <var> element within a <transition> element to hold the PermittedChannelGroup information. The format of the PermittedChannelGroup must match the format of SV178 (Permitted Channel Groups) as described in the Blueworx Voice Response for AIX: Application Development using State Tables information. The example below shows Channel Group 2 being selected for the new call:

<transition event="ccxml.loaded">
  <!-- Place an outbound call -->
  <var name="myHints" expr="new Object()"/>
  <assign name="myHints.PermittedChannelGroup" expr="2"/>
  <createcall dest="'tel:+449876543210'" hints="myHints"/>
</transition>

To alter the SIP FROM header, in order to supply information to the switch attached to Blueworx Voice Response for example, you can use the callerid attribute of <createcall> This must be a valid SIP address that corresponds to the machine on which CCXML is running. Assuming Blueworx Voice Response is running on myMachine.company.com, you could use callerid as follows:

<transition event="ccxml.loaded">
<!-- Place an outbound call -->
<createcall 
   dest="'sip:endPoint@example.com:5060'" 
   callerid="'sip:CompanyDotComConsultants@myMachine.company.com'"/>
</transition>

If you do not specify callerid on an outgoing SIP message, the id defaults to sip:WVRUser@thisMachineIP

Caller ID is not currently supported on any protocol other than SIP and consequently it is ignored on other protocols.