REQTELEPHONYTRANSFER

REQTELEPHONYTRANSFER(nType AS INTEGER, sNumber AS STRING, bAutomatic AS BOOLEAN[, sCallerNum As String]) AS BOOLEAN

Initiates a call transfer to the number <sNumber>.

The transfer is done on the current port, in the current script. The transfer is processed by the telephony network. Depending on the <nType> value, the call transfer is done by PBX (value 0) or by telephony service (value 1): Explicit Call Transfer. This option is only valid for CAPI port transfer. Else it is ignored.

If the <bAutomatic> parameter is TRUE, the transfer is automatically accepted.

When the transfer is not automatic, the function GETTRANSFERSTATUS must be used to check the new call progress. Once connected, it is possible to play a message on the new call. Then COMPLETETRANSFER should be called to proceed with the transfer.

The caller number can be forced, if it is allowed by the PBX. To do that, set the <sCallerNum> parameter with a phone number or a SIP uri, depending on the connection type. When the parameter is set and empty, the outgoing call is an anonymous call.

The function returns TRUE if the call transfer has been initiated.