<disconnect>

Disconnects a telephone session.

Syntax

 <disconnect>
     namelist="string"
 <disconnect/>

Description

Forces the execution environment to disconnect the user's inbound telephone call. If an outbound call is active or on hold, that call is also disconnected.

This element throws a hang up event (connection.disconnect.hangup in VoiceXML 2.0; telephone.disconnect.hangup in VoiceXML 1.0). If an event handler catches the event, it can perform one last <submit> to notify the server that the call has ended. Because the call is no longer connected, any VoiceXML document returned from the server is ignored. The interpreter exits following execution of any event handler (or immediately if no handler catches the hang up event).

Attribute Description
namelist

Allows the application to return data to the execution context

This attribute is currently ignored.

Usage

Parents Children
<bevocal:foreach>
<block>
<catch>
<error>
<filled>
<foreach>
<help>
<if>
<noinput>
<nomatch>

None.

See Also

 •  VoiceXML 2.0 Specification: <disconnect>
 •  Related tags: <bevocal:disconnect>, <transfer>

Examples

 <?xml version="1.0" ?>
 <!DOCTYPE vxml PUBLIC "-//BeVocal Inc//VoiceXML 2.0//EN"
  "http://cafe.bevocal.com/libraries/dtd/vxml2-0-bevocal.dtd">
 
 <vxml version="2.0" xmlns="http://www.w3.org/2001/vxml">
   <form id="foo">
     <error>
       <prompt> That code is bad! <value expr="code"/></prompt>
       <disconnect/>
     </error>
     <field name="code" type="digits">
       <prompt> Say your passcode now. </prompt>
       <filled>
         <if cond="code &lt; 100"> 
           <throw event="error"/>
         <else/> 
           <prompt>Good passcode!</prompt>
         </if>
       </filled>
     </field>
     <block>
       <prompt>That was the last form item.</prompt>
       <disconnect/>
     </block>
   </form>
 </vxml>

[Show Frames]   [FIRST] [PREVIOUS] [NEXT]
BeVocal, Inc. Café Home | Developer Agreement | Privacy Policy | Site Map | Terms & Conditions
Part No. 520-0001-02 | © 1999-2007, BeVocal, Inc. All rights reserved | 1.877.33.VOCAL