Transfer

Function

This module facilitates call transfers. Both the prompt field and the destination number field can consist of a static or a variable value.

Destination number field can accept either a phone number (ex: 800-000-1234) or a SIP address (ex: sip:1234@10.0.1.2). Phone numbers must be formatted as follows:

Value type(s)

Example(s)

Notes

10-digit ANI.

(777) 555-1111

777-555-1111

7775551111

Recommended best practice for destination numbers.

10-digit number and ANI.

tel:+18887776666; ani=7775551111

Includes tel URI, US code (+1), and ani variable. Values are semicolon separated.

10-digit number and postd key.

tel:+18887776666; postd=2341

Includes tel URI, US code (+1), and postd key. Values are semicolon separated.

10-digit number.

tel:+18887776666

Includes tel URI and US code (+1).

10-digit number.

(888) 777-6666

888-777-6666

8887776666

May be formatted or unformatted as shown in the examples.

Variable

xfr_number

Assigned numbers should follow one of the formats listed here.

The following image gives an example of variables being used in the Transfer module.

As shown in the above image, variables can then be entered into the destination number field in the Transfer module. The module will accept these variables in the same way as a phone number. Any phone numbers entered as variables must fit one of the number formats in the table above.

You can determine the result of the transfer using a combination of the result_variable, and the duration shadow variable (result_variable$.duration).

Transfer Result

Result Variable and Duration

Caller hung up before transfer began

result_variable = NULL and result_variable$.duration = NULL

Caller hung up while transfer is ringing

result_variable = NULL and result_variable$.duration = 0

No one at the far end answered before the connect timeout

result_variable = noanswer and result_variable$.duration = 0

Far end was busy

result_variable = busy and result_variable$.duration = 0

Caller hung up during transfer

result_variable = NULL and result_variable$.duration > 0

Far end hung up on the original caller

result_variable = far_end_disconnect and result_variable$.duration > 0

Maximum timeout was reached

result_variable = maxtime_disconnect and result_variable$.duration = maximum timeout

Module Settings

Enable this setting to play audio while an end-user is on hold. To upload a file for hold music, go to Application Settings > Connection Settings > Webservices > Webservice fetch audio.

This setting controls the logging function of a module. Enabling the 'Private' setting instructs the module to not record, report, or retain the information input to that module for reporting or any other purposes. When enabled any information entered into a module during a call will be lost immediately when the call terminates. The 'Private' setting is critical for businesses that need to maintain PCI-DSS or HIPAA compliance. The module icon, in the upper left-hand corner, becomes grayed-out when this setting is enabled. See more details here.

This setting can be used to catch any error that occur during the transfer. This setting displays 'Error' and 'No Answer' options. If a transfer experiences a connection timeout with 'Show Custom Errors' enabled, the call automatically flows to 'No Answer'. If this setting is not enabled, the call disconnects.

Enabling this setting allows users to establish custom timeout error handling for that specific module. It will override the default global webservice timeouts in Application Settings > Connection Settings. Enabling this presents users with two new forms in the module: Connect Timeout and Maximum Timeout. The default durations are: Connect Timeout: 30 seconds Maximum Timeout: 0 (unlimited)

Advanced Settings

Advanced Fuse users may want to use shadow variables that are available for the Transfer module. For more information on this functionality, please visit the Shadow Variables page.

Last updated