Retrieve a channel that was transferred using the retrievable_transfer function. The audio path to the channel will be restored.
The channel should be in the TRANSFERRED state. If it is IDLE, this function will raise a Hangup exception.
This function will block until confirmation has been received that the transfer has been broken, or a timeout has expired.
If the call is successfully retrieved, its state will have returned to ANSWERED. If the state does not return to ANSWERED a cause can be retrieved by calling the transfer_cause() function.
This function will return the channel state.
Usage example:
if channel.retrieve_transferred_call() != channel.State.ANSWERED:
cause = channel.transfer_cause()
print("could not retrieve the channel, reason is {0}".format(cause))