@phone::startAttendedTransfer

Begins an attended transfer of a source call to a target destination, using the SIP protocol signaling. During the attended transfer process, xMatters can interact with the target prior to establishing the connection, or fail-back to the source if the connection cannot be established.

This method is available only for SIP implementations.

Syntax:

@phone::startAttendedTransfer(String phoneNumber[, String playType, String fileName, Boolean repeat])

Parameters:

Returns:

(script object) @transferTarget

Example:

The following code sample illustrates using the startAttendedTransfer method to establish a connection with a conference call:

@transferTarget = @phone::startAttendedTransfer("9255551234")

$transferConnected = @transferTarget::getConnectionStatus()

IF ($transferConnected == "SUCCESS")

  @transferTarget::playDtmf($event.conference_id)

  wait(10)

  @transferTarget::playDtmf($event.conference_password)

  $result = @phone::endAttendedTransfer()

  IF ($result == "SUCCESS")

    exit

  ELSE

    @phone::play("phrase", "Sorry, could not reach the other party")    

  ENDIF

ELSE

  @phone::play("phrase", "Sorry, could not reach the other party")

  # Go back and replay menu options other than transfer

ENDIF