There are a number of supported workflows as part of transferring a call using third party control. The method used is dependent on external factors such as the phone system used. Below, the three different processes are defined. The method chosen would depend on the unique project requirements and functions of the phone system being used and its supported functions.
The 'transfer' function can be used for the default type of transfer when it has been defined in the Tesira software. The other two methods, the 'featureKey Blind' or 'featureKey Consultative' methods can be used as an 'on-the-fly' method of initiating a transfer.
This function is a dedicated function for initiating the default type of call transfer. The transfer behavior is defined in the VoIP Line Properties block properties configured as part of the Tesira design file configuration. For some proxies, the default behavior is a 'blind transfer' for others it is a 'consultative transfer'. The control developers will need to know what kind of call transfer method is used then this should be configured in the Line properties > General Tab > Consultative Transfer setting.
| Example - To transfer to extension 9175 |
VoIPControlStatus1 transfer 1 1 VoIPControlStatus1 dial 1 2 9175 |
The function: featureKey 1 1 FEATURE_KEY_BLIND_TRANSFER, opens a new call appearance and allows the number to be transferred to be entered. The process operates the same as off-hook dialing.
Once the transfer target answers the call, a manual confirmation of the transfer can be specified, alternatively, the transfer will complete itself after a timeout period (default 10 seconds)
To confirm the transfer, the feature key function with the new line instance is specified: featureKey 1 2 FEATURE_KEY_BLIND_TRANSFER.
If the transfer does not complete, the original call instance will remain on hold. This will need to be restored manually.
| Example - To transfer to extension 9175 |
| VoIPControlStatus1 featureKey 1 1 FEATURE_KEY_BLIND_TRANSFER
+OK VoIPControlStatus1 dial 1 2 9175 VoIPControlStatus1 featureKey 1 2 FEATURE_KEY_BLIND_TRANSFER |
The function: featureKey 1 1 FEATURE_KEY_CONSULTATIVE_TRANSFER opens a new call appearance and allows the number to be transferred to be entered. The process operates the same as off-hook dialing.
Once the transfer target answers the call, a manual confirmation of the transfer must be specified. To confirm the transfer, the feature key function with the new line instance is specified by featureKey 1 2 FEATURE_KEY_CONSULTATIVE_TRANSFER.
| Example - To transfer to extension 9175 |
VoIPControlStatus1 featureKey 1 1
FEATURE_KEY_CONSULTATIVE_TRANSFER VoIPControlStatus1 dial 1 2 9175 VoIPControlStatus1 featureKey 1 2 FEATURE_KEY_CONSULTATIVE_TRANSFER |
For a consultative transfer, the function featureKey(1, 1, FEATURE_KEY_CONSULTATIVE_TRANSFER) can be used to initiate a new call appearance. The number will be required to be inputted. This process looks like off-hook dialing. The original call is on hold and a new call is placed. Once the transfer target answers the call and would like to accept the transferred call, this function must be called again to complete the call transfer. In case of the failure, the original call is on hold and the call will be required to be restored manually.