<bevocal:connect>

Extension. Reconnects the user with an outbound call that was placed on hold.

Syntax

 <bevocal:connect
   call="js_expression" 
 />

Description

To use this tag, the containing <vxml> tag must declare the XML namespace bevocal by including the following attribute:

 xmlns:bevocal="http://www.bevocal.com/"

A <bevocal:connect> tag reconnects an outbound call that was put on hold by a <bevocal:hold> tag or by the onhold attribute of the <bevocal:dial> tag that initiated the call. This tag does nothing if the specified call is not on hold.

After the call is reconnected, the user and called third party talk to each other. The application continues to listen to the user; if a user utterance matches an active grammar, the application responds to the recognized utterance as usual. The application ignores all speech and DTMF signals from the called third party.

Note: This and other call-control tags constitute a BeVocal VoiceXML extension. Committees are currently working to standardize call-control features for VoiceXML, and their current approach is different from the BeVocal VoiceXML implementation. Because the approval of any call-control standards will be quite some time in coming, however, BeVocal VoiceXML contains this extension to allow developers to start taking advantage of call-control features. BeVocal will continue to monitor the development within these committees. If the features in the BeVocal VoiceXML extension become a part of VoiceXML or a separate call-control standard, BeVocal VoiceXML will implement that standard. We will then deprecate the current extension and provide developers with information on how to convert their applications to the new standard.

Attribute Description

call
JavaScript expression whose value is a JavaScript object that was initialized by <bevocal:dial>; specifies the call to be reconnected.

Tip:

•	If a JavaScript expression contains any of the characters "`<`", "`>`", or "`&`", that character must be replaced with the corresponding escape sequence "`<`", "`>`", or "`&`". For more information, see JavaScript Quick Reference.

Usage

Parents Children

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

The following events may be thrown by the execution of a <bevocal:connect> tag:

Event Description

connection.far_end.disconnect
The specified outbound call has already been disconnected.

error.semantic
The call attribute is not a valid JavaScript expression or the expression does not evaluate to an object representing an outbound call.

See Also

•	Chapter 6, Controlling Outbound Calls
•	Related tags: `<bevocal:dial>`, `<bevocal:disconnect>`, `<bevocal:hold>`

[Show Frames] [FIRST] [PREVIOUS] [NEXT]

Attribute	Description
`call`	JavaScript expression whose value is a JavaScript object that was initialized by `<bevocal:dial>`; specifies the call to be reconnected.

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

Event	Description
`connection.far_end.disconnect`	The specified outbound call has already been disconnected.
`error.semantic`	The `call` attribute is not a valid JavaScript expression or the expression does not evaluate to an object representing an outbound call.