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: unknownuser-busyno-answerunavailableunconditionaltime-of-daydo-not-disturbdeflectionfollow-meout-of-serviceaway 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>