XML: <Forward>

Forwards an unanswered incoming call to another number.

Attributes

ATTRIBUTE Description
to Number to forward the call to. Must be in E.164 format (e.g. +15555555555)
from (optional) Number to use for caller ID on the outgoing leg. Must be in E.164 format (e.g. +15555555555). If omitted, assumes the "to" number of the original leg.
callTimeout (optional) Number of seconds to wait for an answer before abandoning the call. Range: decimal values between 1 - 300. Default: 30
diversionTreatment (optional) Can be any of the following:
none: No diversion headers are sent on the outbound leg of the transferred call.
propagate: Copy the Diversion header from the inbound leg to the outbound leg. Ignored if there is no Diversion header present on the inbound leg.
stack: After propagating any Diversion header from the inbound leg to the outbound leg, stack on top another Diversion header based on the Request-URI of the inbound call.

Defaults to none. If diversionTreatment is not specified, no diversion header will be included for the transfer even if one came with the inbound call.
diversionReason (optional) Can be any of the following values:
unknown
user-busy
no-answer
unavailable
unconditional
time-of-day
do-not-disturb
deflection
follow-me
out-of-service
away

This parameter is considered only when diversionTreatment is set to stack. Defaults to unknown.

Callbacks Received

None

Example: Forward Verb

This shows how to use Bandwidth XML to forward a call from +11234567890 to +10987654321.

<?xml version="1.0" encoding="UTF-8"?>
<Response>
   <Forward from="+11234567890" to="+10987654321"/>
</Response>

results matching ""

    No results matching ""