|
Newsletters
|
|
|
|
|
Voice XML Reference
Voice XML Reference
Bookmark this page
The transfer Element - <transfer>
Description:
Occasionally, it is appropriate to suspend the session between the user and the interpreter and
initiate a session with another entity. The most common use for this capability in current
practice is to connect a user in a telephone conversation with a interpreter to a third party
through the telephone network. The <transfer> element directs the interpreter to make such a
third party connection.
Example:
<form name="transfer">
<var name="mydur" expr="0"/>
<block>
<audio src="chopin12.wav">
</block>
<transfer name="mycall" dest="phone://18005551234"
connecttimeout="30s" bridge="true">
<filled>
<assign name="mydur" expr="mycall$.duration"/>
<if cond="mycall == 'busy'">
<prompt>Sorry, our customer support team is busy serving
other customers. Please try again later.</prompt>
<elseif cond="mycall == 'noanswer'"/>
<prompt>Sorry, our customer support team's normal hours
are 9 am to 7 pm Monday through Saturday.</prompt>
</if>
</filled>
</transfer>
<block>
<submit namelist="mycall mydur" next="/cgi-bin/report"/>
</block>
</form>
| Attributes |
| Name |
Value |
Description |
| name |
PCDATA |
The outcome of the transfer attempt. |
| expr |
PCDATA |
The initial value of the form item variable; default is ECMAScript
undefined. If initialized to a value, then the form item will not be
visited unless the form item variable is cleared. |
| cond |
boolean |
A boolean condition that must also evaluate to true in order for the
form item to be visited. |
| dest |
URI |
The URI of the destination (phone, IP telephony address) |
| destexpr |
PCDATA |
An ECMAScript expression yielding the URI of the destination. |
| bridge |
boolean |
This attribute determines what to do once the call is connected. If
bridge is true, document interpretation suspends until the
transferred call terminates.
If it is false, as soon as the call connects, the platform throws a
telephone.disconnect.transfer. |
| connecttimeout |
integer |
The time to wait while trying to connect the call before returning the
noanswer condition. Default is platform specific. |
| maxtime |
integer |
The time that the call is allowed to last, or 0 if it can last arbitrarily
long. Only applies if bridge is true. Default is 0. |
Back to Tag Listing
|
|
